必须通过火山引擎方舟平台获取合法凭证与模型地址：先实名认证，再创建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- 开头的字符串才是你网站前端或后端真正要调用的模型地址，不是模型名，也不是版本号。
配置网站调用接口
第一步：确认调用方式
豆包模型支持 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 是否过期或权限不足。
