千帆AI应用开发者中心为开发者提供了便捷的模型调用服务,基于API Key的鉴权方式是调用模型相关接口的核心前提,整个流程包含授权确认、密钥获取、接口调用三个核心环节,无需复杂的申请步骤即可快速上手。
API调用整体流程说明
基于API Key的鉴权模式,调用千帆模型相关API的整体步骤十分清晰,主要分为三个部分:首先是确认API授权状态,平台已经默认开通了调用权限,不需要开发者额外提交申请;其次是在控制台完成API Key的创建与资源绑定,获取永久有效的鉴权密钥;最后是携带密钥信息调用对应的模型接口,完成业务需求。
详细操作步骤
步骤一:确认API授权状态
千帆平台已经为所有开发者默认开通了API调用权限,不需要单独提交申请或者等待审核,开发者可以直接进入后续的密钥获取环节,节省了大量的前期准备时间。
步骤二:获取并配置API Key
API Key是调用接口的核心凭证,属于永久有效类型,获取和配置的具体操作如下:
- 登录千帆控制台,依次进入安全认证、API Key板块。
- 如果已经有可用的API Key可以直接跳过创建步骤,若需要新密钥,点击创建按钮,选择千帆ModelBuilder作为关联服务。

- 完成密钥创建后需要配置对应资源,也就是绑定V2版本应用对应的appid,绑定后该appid就可以使用当前API Key调用模型接口。资源绑定分为两种模式:选择所有资源时,该API Key可以用于所有appid对应的应用;选择特定资源时,仅指定appid对应的应用可以使用该密钥。

- 确认配置信息无误后点击确定,就可以在API Key列表中查看并复制对应的密钥值。

步骤三:调用模型相关API
获取到API Key后,就可以发起模型接口调用请求,核心是在HTTP请求的Header部分完成鉴权信息配置:将固定字符串Bearer和获取到的API Key值拼接,作为Authorization字段的内容添加到请求头中。
以下是调用对话模型接口的具体示例:
curl -X POST 'https://qianfan.baidubce.com/v2/chat/completions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer bce-v3/ALTAK-*****************/2d7*****************' \
-d '{
"model": "ernie-3.5-8k",
"messages": [
{
"role": "user",
"content": "你好"
}
]
}'
按照上述示例替换对应的API Key和请求参数,就可以正常调用千帆的模型服务,获取对应的返回结果。