必须通过标准API接口调用火山引擎方舟模型,获取API Key和Secret Key后,按OpenAI或Anthropic协议选择对应Base URL,构造含Authorization头和JSON请求体的POST请求至/chat/completions路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地开发环境或第三方工具中调用火山引擎方舟平台的模型,必须通过标准API接口发起请求,不能直接访问控制台页面或使用未授权的内部地址。
获取合法API凭证
登录火山引擎控制台 → 进入「方舟大模型」服务 → 左侧导航栏点击「API 调用」→「凭证管理」→ 点击「创建凭证」。
填写凭证名称(如“TRAE-Prod”),权限范围选「方舟大模型」,点击确定后生成 【API Key 和 Secret Key】。这两组密钥仅显示一次,关闭页面即不可再查,务必立即复制保存。
若后续丢失,只能删除旧凭证并新建,旧凭证将立即失效,已配置的工具会断连。
确认模型支持的API路径与协议
方舟平台区分两类兼容协议:OpenAI 兼容接口和 Anthropic 兼容接口,不同工具需匹配对应 Base URL。
OpenAI 协议工具(如 Cursor、VSCode 的 OpenAI 扩展)必须使用:
https://ark.cn-beijing.volces.com/api/coding/v3
Anthropic 协议工具(如 Claude Code)必须使用:
https://ark.cn-beijing.volces.com/api/coding
【切勿混用路径,否则返回 404 或 401 错误】。/api/v3 路径已被弃用,当前仅 /api/coding/v3 生效。
构造标准Chat API请求
第一步:设置请求头(Headers)
Content-Type: application/json
Authorization: Bearer <你的API Key>
第二步:准备请求体(Body),以调用 ark-code-latest 为例:
{
"model": "ark-code-latest",
"messages": [
{"role": "user", "content": "写一个Python函数,输入列表返回去重后的升序结果"}
],
"stream": false
}
第三步:发送 POST 请求至 Base URL + /chat/completions 路径。
例如完整请求地址为:
https://ark.cn-beijing.volces.com/api/coding/v3/chat/completions
第四步:解析响应体中的 choices[0].message.content 字段获取模型输出文本。
注意:stream 设为 true 时需按 SSE 流式解析,普通调试建议先设为 false。

















