必须完成密钥获取、模型开通与接口调用三重配置，否则返回401或404错误；需实名认证后创建API Key并安全保存；开通模型后获取Endpoint ID；请求地址为https://ark.cn-beijing.volces.com/api/v3/chat/completions，Header含Authorization和Content-Type，Body含model与messages。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在项目中调用火山引擎豆包大模型API，必须先完成密钥获取、模型开通与接口调用三重配置，缺一不可，否则请求会直接返回401或404错误。
获取并保存API Key
登录火山引擎控制台 → 进入「火山方舟」→ 点击左侧菜单「API Key 管理」→ 点击「创建 API Key」→ 输入名称（如doubao-pro-dev）→ 点击确认。
【密钥仅显示一次，关闭页面即永久不可见】立即复制整段字符串，粘贴到本地安全记事本或密码管理器中，不要截图存手机相册。
这一步不能跳过实名认证——个人账号需完成身份证上传，企业账号需提交营业执照，未实名的账号无法创建有效API Key。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
开通目标模型并确认Endpoint
方法一：一键开通全部模型（适合测试）
进入「模型服务」→「ARK」→ 点击右上角「一键开通所有模型」，系统自动为当前项目启用全部支持Chat API的豆包模型。
方法二：按需开通指定模型（推荐用于生产）
在模型列表页搜索如 doubao-pro-256k 或 doubao-lite-32k → 点击右侧「开通」→ 勾选「启用在线推理」→ 提交。
开通完成后，务必点击该模型右侧「接入点详情」，记下 Endpoint ID（格式为 ep-xxxxxxxx）。此ID将用于构造请求URL，不是API Key，也不能混用。
调用API发送请求
第一步：确认请求地址
当前唯一有效生产接口为：https://ark.cn-beijing.volces.com/api/v3/chat/completions。其他域名（如volcengine.com、ark.volces.com）均已停用，硬编码会导致Connection refused。
第二步：构造HTTP请求头
必须包含两项：
Content-Type: application/json
Authorization: Bearer 【你的完整API Key字符串】
第三步：准备JSON请求体
最小可用结构如下（注意role字段只能是system/user/assistant）：
{"model":"doubao-pro-256k","messages":[{"role":"user","content":"你好"}]}
第四步：发送POST请求
可用curl快速验证：
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your_api_key_here" \
-d '{"model":"doubao-pro-256k","messages":[{"role":"user","content":"测试"}]}'
