必须通过火山引擎Ark平台获取凭证并使用Endpoint ID调用豆包大模型:先完成企业实名认证,再开通ARK服务、创建API密钥、配置接入点,最后用SDK或curl携带Authorization头发起请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在自有系统或应用中调用豆包大模型的文本生成能力,必须通过火山引擎Ark平台获取合法凭证并指向正确接入点,直接访问豆包网页版接口会返回401或403错误。
开通火山引擎账号与实名认证
访问火山引擎官网(https://www.volcengine.com),使用手机号注册新账号;注册完成后,进入「账户中心→企业实名认证」页面,按提示提交营业执照、法人身份证等材料;【未完成企业实名认证将无法开通ARK服务】。
创建API密钥并开通豆包模型服务
登录控制台后,进入「模型服务→ARK」页面,点击「开通服务」;在模型列表中找到目标豆包模型(如doubao-pro-32k-260701),确认其描述中带有「Chat API」标签;点击该模型右侧「开通」按钮,等待状态变为「已开通」;进入「API密钥管理」,点击「创建密钥」,完整复制生成的ARK_API_KEY并保存至安全环境变量(如.env文件);【该密钥不可再次查看,丢失需重新创建】。
创建推理接入点并获取Endpoint ID
第一步:在ARK控制台左侧菜单选择「模型推理→接入点管理」;
第二步:点击「创建接入点」,在「模型」下拉框中选择你已开通的豆包模型(注意不是模型版本名,而是列表中显示的正式名称);
第三步:填写接入点名称(如doubao-pro-for-webhook),地域选「cn-beijing」,其余参数保持默认;
第四步:点击「确定」,等待状态变为「运行中」;
第五步:在接入点列表中找到刚创建的条目,复制其Endpoint ID(格式为ep-m-xxxxxxxxxx-xxxxxx)——这才是调用时必须填入model字段的真实ID。
立即进入“豆包AI人工智官网入口”;
立即学习“豆包AI人工智能在线问答入口”;
安装SDK并发起标准请求
方法一(Node.js):执行npm install @volcengine/ark-runtime,然后用以下代码发起请求:
const { Ark } = require('@volcengine/ark-runtime');
const client = new Ark({ base_url: 'https://ark.cn-beijing.volces.com/api/v3' });
const res = await client.chat.completions.create({
model: 'ep-m-xxxxxxxxxx-xxxxxx',
messages: [{ role: 'user', content: '你好' }],
});
console.log(res.choices[0].message.content);
方法二(Python):pip install volcengine-python-sdk[ark],随后导入并调用:
from volcengine.sdkarkruntime import Ark
client = Ark(base_url="https://ark.cn-beijing.volces.com/api/v3")
completion = client.chat.completions.create(
model="ep-m-xxxxxxxxxx-xxxxxx",
messages=[{"role": "user", "content": "你好"}]
)
print(completion.choices[0].message.content)
注意:所有请求必须携带Authorization头,格式为Bearer 【你的ARK_API_KEY】;若使用curl测试,命令形如:
curl -X POST https://ark.cn-beijing.volces.com/api/v3/chat/completions \
-H "Authorization: Bearer your_ark_api_key_here" \
-H "Content-Type: application/json" \
-d '{"model":"ep-m-xxxxxxxxxx-xxxxxx","messages":[{"role":"user","content":"你好"}]}'


















