如何开通火山方舟服务接入豆包大模型API

必须先开通火山方舟服务并配置豆包模型权限，否则API请求将返回404或401错误；需用手机号注册火山引擎账号、完成实名认证、开通方舟服务、创建带chat权限的API Key、开通豆包模型并创建推理接入点获取Endpoint ID。

你需要在火山引擎平台开通火山方舟服务，并完成豆包大模型的调用权限配置，否则后续所有API请求都会返回404或401错误。

注册并实名认证火山引擎账号

进入火山引擎官网（volcengine.com），单击页面右上角的“立即注册”，根据提示填写用户名、密码、手机号并获取信息验证码，勾选“阅读并同意火山引擎《用户协议》和《隐私权政策》”，完成注册——

。注册完成后，立即进入右上角「账号管理」→「实名认证」，选择“个人”类型提交身份证信息，审核秒过。未实名将无法创建API密钥，也无法开通豆包模型服务。

开通火山方舟服务

登录后，在顶部搜索框输入“火山方舟”并进入产品页；点击“立即开通”，勾选服务协议后提交。系统自动激活服务，无需预付费用，按量计费。开通成功后，左侧菜单会出现“火山方舟”入口，若未出现，请刷新页面或等待1–2分钟后台同步。

创建API Key并开启chat权限

登录火山引擎方舟控制台，进入「API密钥管理」模块，点击「创建API Key」；填写名称，如“doubao-pro-dev”，创建后立即复制保存API Key值（格式为ark-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx），该密钥仅显示一次，丢失需重新生成。

关键一步：点击刚创建的密钥右侧「编辑权限」→ 勾选「chat」权限（默认不开启）→ 保存。若跳过此步，调用时会持续报错invalid api key，即使Key本身正确。

开通豆包模型并创建推理接入点

第一步：进入「模型管理中心」→ 在“豆包系列”中找到Doubao-1.5-pro-256k或Doubao-1.5-lite-128k → 点击「开通」。

第二步：进入左侧菜单「推理接入点」→ 点击「创建接入点」；填写名称（如my-doubao-pro）、选择已开通的模型、保持上下文长度默认值、设置合理速率限制（新手建议设为60次/分钟防误触）→ 点击确定。

第三步：接入点创建成功后，页面会显示唯一Endpoint ID（格式为ep-202xxxxxxxxxxxxxx），这是你后续代码中必须传入的model地址标识，不是API Key，也不能混用。