必须通过火山引擎方舟平台获取合法凭证与模型地址:先实名认证,再创建ek-开头API Key,最后开通豆包模型并获取ep-开头Endpoint ID,调用时需使用指定域名、Bearer认证及正确请求体。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在自己的网站上接入豆包大模型实现对话、文本生成等功能,必须通过火山引擎方舟平台获取合法凭证与可用模型地址,跳过任一环节都会导致请求被拒绝或404错误。
注册并完成实名认证
打开火山引擎官网 https://console.volcengine.com/ ,用手机号注册并登录。右上角进入「账号管理」→「实名认证」→选择「个人认证」→按提示上传身份证正反面照片。这一步不可跳过,【未实名认证的账号无法开通任何模型服务】。认证通常秒级通过,但若系统提示人工审核,需等待1-2个工作日。
创建方舟专属 API Key
登录后,在控制台顶部搜索框输入「火山方舟」并进入平台。左侧菜单依次点击:系统管理 → API 密钥管理 → 创建API Key。为该密钥命名,例如 web-doubao-prod,勾选「允许调用模型推理API」权限。点击创建后,页面立即显示一串以 ek- 开头的密钥(如 ek-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)。【务必立刻复制并离线保存,关闭页面后将永远无法再次查看】。注意:这里绝不能使用火山引擎 IAM 的全局 AccessKey/SecretKey,它不兼容豆包的 Bearer 认证方式,强行使用必报 401。
开通豆包模型并获取 Endpoint ID
方法一:开通预置轻量模型(推荐新手)
在火山方舟控制台进入「模型广场」→ 搜索 Doubao-lite-32k → 点击「开通服务」→ 状态变为「已启用」即可。
方法二:创建自定义推理接入点(需精确控制)
左侧菜单进入「在线推理」→「推理接入点管理」→「创建推理接入点」→ 模型选择 Doubao-pro-128k → 地域选 cn-beijing → 点击创建。成功后,记录下生成的 ID,格式为 ep-m-202608xxxxxx-xxxxxx。这个 ep- 开头的字符串才是你网站前端或后端真正要调用的模型地址,不是模型名,也不是版本号。
立即进入“豆包AI人工智官网入口”;
立即学习“豆包AI人工智能在线问答入口”;
配置网站调用接口
第一步:确认调用方式
豆包模型支持 OpenAI 兼容的 Chat Completions 接口,所有请求必须发往固定域名:https://ark.cn-beijing.volces.com/api/v3/chat/completions。
第二步:构造请求头
在 HTTP Header 中添加:Authorization: Bearer 【你刚复制的ek-开头API Key】,Content-Type 设为 application/json。
第三步:组织请求体
发送 POST 请求,Body 内容示例:{"model":"【你的ep-开头Endpoint ID】","messages":[{"role":"user","content":"你好"}],"stream":false}。
第四步:处理响应
成功返回是标准 JSON,提取 choices[0].message.content 即可获得模型回复。若返回 404,请检查 Endpoint ID 是否复制完整;若返回 401,请核对 Authorization 头是否拼写正确、API Key 是否过期或权限不足。


















