先把概念理顺:拿到 API Key 只是第一步,真正能调接口,还得把对应服务开通。很多人卡在这里,以为密钥创建成功就能直接请求,结果一直拿到权限错误。
1. 访问火山引擎官网并完成注册
先去火山引擎官网注册账号。注册流程本身不复杂,关键是后面要能进控制台做产品开通和密钥管理。
2. 在产品列表里找到豆包大模型
注册完成后,进入产品列表,找到豆包大模型。入口名称比较直白,找不到的话通常是还没切到对应控制台页面。
3. 创建 API Key
进入控制台后,打开 API Key 管理,创建新的 API Key。
这里要注意:这一步只是生成密钥,不代表接口权限已经打开。只拿着 Key 去调接口,通常是不会通的。
4. 开通接口服务
继续到开通管理页面,选择 Doubao-Seed-1.8 接口服务并点击开通。
如果你想避免免费额度用完后自动扣费,可以选安心模式。接着开启实名认证,支持微信或抖音扫码。扫脸完成后刷新页面,开通状态一般就会更新出来。
5. 先用 Postman 验证一次调用
权限开好后,建议先用 Postman 之类的工具打一次请求,别一上来就塞进业务代码里排错。
把下面这段 cURL 导入后测试即可。注意 Bearer 后面要有空格,apikey 也要换成你自己申请到的值。
curl --location --request POST 'https://ark.cn-beijing.volces.com/api/v3/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 这里写你的apikey' \
--data-raw '{ "model": "doubao-seed-1-8-251228", "messages": [ { "role": "user", "content": "你好" } ] }'
请求发出去后等响应就行。如果能正常返回内容,说明链路已经通了。豆包这类模型有时思考会慢一点,不用急着判断失败。
接口文档可以看:对话 (Chat) API--火山方舟大模型服务平台。
6. 提示词尽量短一点
如果希望回答更自然,同时少花 Token,提问最好别写太长。比如'随机生成一个适合直播间互动的问题,表现的像一个正常人首次进入直播间,20 字以内,不要说其他的。' 这种就比大段说明更划算。
豆包 API 是按 Token 计费的,输入越啰嗦,成本越高。这一点在调试阶段不明显,真正跑起来后就很容易感受到。


