火山引擎豆包大模型API完整接入步骤(代码示例)

若要正确获取结果，必须执行以下操作：获取API密钥、构造合规请求并正确解析响应，否则将返回401或400错误。具体步骤如下：

• 在火山引擎控制台创建AccessKey并复制服务地址。
• 推荐使用volcengine SDK初始化客户端。
• 设置请求头与JSON body后调用invoke_model。
• 从response'choices''message'提取结果。

要在自己的程序中调用火山引擎豆包大模型API完成文本生成、问答或摘要等任务，必须先获取有效凭证、构造合规请求、正确解析响应，漏掉任一环节都会返回401或400错误。

获取API密钥与访问地址

登录火山引擎控制台→进入「AccessKey管理」页面→点击「创建AccessKey」→填写描述后提交→立即复制并安全保存

，页面关闭后无法再次查看明文。

在「Model Studio」中找到已部署的豆包模型（如doubao-pro-32k），点击服务详情→复制「服务调用地址」，格式类似 https://ark.cn-beijing.volces.com/api/v3/chat/completions。

安装SDK并初始化客户端

方法一：使用最新推荐的 volcengine Python SDK

执行 pip install volcengine，然后按如下方式初始化：

from volcengine.maas import MaasService
maas = MaasService('cn-beijing')
maas.set_ak('你的AccessKeyId')
maas.set_sk('你的SecretAccessKey')

方法二：不依赖SDK，直接用 requests 构造签名请求——需自行实现 VolcEngine 签名算法 v4，涉及时间戳、哈希、base64 编码和 header 拼接，极易出错，新手不建议。

构造并发送标准请求

第一步：设置请求头，必须包含 Content-Type: application/json 和 X-App-Key（值为 AccessKeyId）

第二步：构建 JSON body，至少包含 model（模型名）、messages（消息列表，role 为 user/system/assistant）、max_tokens（建议设为1024）

第三步：调用 maas.invoke_model() 方法传入参数，或用 requests.post 发送带签名的请求。若收到 403 错误，说明

示例 body：
{
"model": "doubao-pro-32k",
"messages": [{"role": "user", "content": "请用三句话介绍量子计算"}],
"max_tokens": 512
}

解析返回结果并提取文本

响应体是标准 JSON，根字段为 choices → 0 → message → content。

直接取 response['choices'][0]['message']['content'] 即可获得模型输出文本。

注意：当模型流式响应时（stream=true），返回结构完全不同，会是多个 chunk 对象，每个含 delta.content 字段；非流式调用务必确认请求中未设置 stream=true，否则会因解析失败抛 KeyError。