必须通过火山方舟平台完成实名认证、创建api key、开通doubao-lite-128k模型、创建接入点获取endpoint id,并调用唯一有效地址https://ark.cn-beijing.volces.com/api/v3/chat/completions。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在自己的程序里调用豆包大模型完成文本生成、问答或Agent任务,必须通过火山方舟平台获取合法凭证并构造标准HTTP请求,漏掉任一环节都会返回401或404错误。
注册与实名认证
打开火山引擎官网,用手机号注册并登录账号。进入右上角「账号管理」→点击「实名认证」→选择「个人认证」→按提示上传身份证正反面照片。这一步不能跳过,【未完成实名认证的账号无法创建API Key,所有后续操作都会卡在第一步】。
认证通常秒级通过,系统会自动跳转回控制台首页。
创建API Key并开通模型
在控制台顶部搜索框输入“火山方舟”并进入ARK平台。左侧菜单栏点击「API密钥管理」→点击「创建API Key」→填写名称(如:my-app-prod)→点击确认。页面立即显示一串以ek-开头的密钥字符串。
【密钥仅显示一次,关闭页面即不可找回,务必立即复制保存到安全位置】。
接着进入「模型管理中心」→在搜索框输入doubao-lite-128k→点击右侧「开通」按钮。该模型响应快、免费额度充足,适合大多数轻量级业务场景。
获取Endpoint ID并确认接口地址
回到ARK控制台,进入「推理接入点」页面→点击「创建接入点」→服务类型选「在线推理」→模型选择刚开通的doubao-lite-128k→填写名称(如:lite-chat-endpoint)→点击创建。几秒后页面列出新接入点,复制其Endpoint ID(格式为ep-xxxxxxxx)。
当前唯一有效生产接口地址为:https://ark.cn-beijing.volces.com/api/v3/chat/completions。其他域名(如us-east、sg等)已停用,调用必失败。
构造并发送请求
方法一:使用curl命令快速验证
在终端执行以下命令(将YOUR_API_KEY和YOUR_ENDPOINT_ID替换成真实值):
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-lite-128k",
"endpoint_id": "YOUR_ENDPOINT_ID",
"messages": [{"role": "user", "content": "你好"}]
}'
方法二:Python代码调用(需安装requests库)
新建call_doubao.py,填入如下内容:
import requests
url = "https://ark.cn-beijing.volces.com/api/v3/chat/completions"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"model": "doubao-lite-128k",
"endpoint_id": "YOUR_ENDPOINT_ID",
"messages": [{"role": "user", "content": "解释牛顿第一定律"}]
}
r = requests.post(url, headers=headers, json=data)
print(r.json())
运行python call_doubao.py,若返回含choices字段的JSON,说明调用成功。











