必须通过火山引擎账号在火山方舟平台创建API Key并开通豆包模型服务才能调用，需先注册实名认证，再创建以ek-开头的API Key并保存，最后开通模型并获取Endpoint ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要调用豆包大模型做智能对话、知识问答或本地知识库接入，必须先拿到合法有效的 API Key——它不是在 doubao.com 网页版里找，也不是在若手、Cursor 或 VS Code 插件设置页生成，而是必须通过火山引擎账号，在火山方舟平台中创建并绑定模型权限，漏掉任一环节都会导致“invalid api key”报错。
注册火山引擎账号并完成实名认证
打开浏览器访问 https://www.volcengine.com → 点击右上角“立即注册” → 输入手机号（【必须是能实时收验证码的手机号，邮箱注册无法开通豆包模型】）→ 设置密码 → 填写验证码 → 完成注册。
登录后立刻进入实名认证：路径为控制台 → 右上角头像 → 账户中心 → 实名认证 → 选择“个人认证” → 上传身份证正反面照片 + 人脸识别。这一步不可跳过，未认证账号无法创建 API Key，也无法开通豆包模型服务。
认证审核通常 2 分钟内自动通过，无需等待人工处理。
立即进入“豆包AI人工智官网入口”；
立即学习“豆包AI人工智能在线问答入口”；
进入火山方舟平台并创建 API Key
登录火山引擎控制台后，在顶部搜索框直接输入“火山方舟” → 点击搜索结果中的“火山方舟（ModelArk）”进入平台。
左侧菜单栏找到并点击“API 密钥管理” → 点击“创建 API 密钥” → 在弹窗中填写名称，例如：doubao-customer-service 或 my-local-rag（命名要有业务指向性，方便后续排查）→ 点击“确定”。
创建成功后，页面会显示一串以 ek- 开头的密钥，格式如 ek-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。这是你唯一一次看到完整密钥的机会——【务必立即复制保存到本地文本文件或密码管理器，关闭页面后无法再次查看】。
开通豆包模型服务并获取 Endpoint ID
这一步常被忽略，但它是调用成功的必要条件：API Key 是钥匙，Endpoint ID 才是门锁编号。
方法一：快捷开通
左侧菜单进入“模型管理中心” → 搜索“Doubao” → 点击“Doubao-lite-128k”或“Doubao-pro-256k”右侧的“开通”按钮 → 等待状态变为“已开通”。
方法二：按需配置
左侧菜单进入“在线推理” → 点击“创建推理接入点” → 名称填 doubao-chat → 模型选择刚才开通的豆包型号 → 地区选 cn-beijing → 点击“创建”。等待状态变成“运行中”后，点击该接入点名称 → 复制页面顶部显示的 Endpoint ID，格式为 ep-xxxxxxxxxxxxxxxxxxxxxxxx。
注意：若使用若手等第三方工具，base_url 必须填 https://ark.cn-beijing.volces.com/api/v3，而不是 doubao.com 或 volcengine.com 根域名下的其他地址。
