火山引擎API_Key绑定模型后接口地址如何填？

填错API Endpoint Host会导致请求超时或连接被拒绝，而非401/404；需先确认是预置模型（用标准地址如https://ark.cn-beijing.volces.com/api/v3/chat/completions）还是自定义推理接入点（URL不变，model字段填ep-开头的Endpoint ID），二者混用将导致失败。

在Dify或OneAPI等平台配置火山引擎模型时，填错API Endpoint Host会导致请求直接失败，根本收不到401或404错误，而是超时或连接被拒绝。

确认模型部署类型再选地址

火山引擎的API地址不是统一的，它取决于你绑定的是预置模型还是自定义推理接入点。预置模型用模型广场直连地址，自定义接入点必须用专属Endpoint ID生成的地址——填反了，请求会直接被网关拦截。

打开火山引擎控制台 → 进入【大模型 → 火山方舟】→ 左侧菜单点【推理接入点】→ 查看列表顶部是“预置推理接入点”还是“自定义推理接入点”。【这是决定接口地址格式的关键前提】

如果列表里显示的是 ep-20250512195705-c8kq4 这类以 ep- 开头的ID，说明你创建的是自定义接入点；如果是 doubao-pro-32k-241215 这种纯模型名，则属于预置模型。

预置模型：用模型广场标准地址

进入模型广场 → 找到你选用的模型（如 doubao-1.5-pro-32k-250115）→ 点击【查看详情】→ 滚动到底部查看「API调用示例」→ 复制其中的 https://ark.cn-beijing.volces.com/api/v3/chat/completions 地址。

这个地址固定为 https://ark.{地域}.volces.com/api/v3/chat/completions，目前仅支持 cn-beijing 地域，不可替换成 volcengine.com 或其他域名后缀。

注意：不要复制示例中带 ?model=xxx 查询参数的完整URL，只取基础路径部分。

自定义推理接入点：必须拼接Endpoint ID

第一步：在【推理接入点】列表找到你的 ep-* 接入点 → 点击右侧【API调用】按钮 → 页面顶部会显示类似 https://ark.cn-beijing.volces.com/api/v3/chat/completions 的基础地址。

第二步：复制该页面下方明确标注的 Endpoint ID（例如 ep-20250512195705-c8kq4）→ 把它填进基础地址的 model 字段里，而不是拼在URL末尾。

第三步：最终请求体中 "model": "ep-20250512195705-c8kq4"，而URL仍保持为 https://ark.cn-beijing.volces.com/api/v3/chat/completions。若把Endpoint ID硬塞进URL变成 .../completions?model=ep-xxx，服务端将无法识别该模型。

这一步极易出错——有人误以为Endpoint ID要替换掉URL里的 chat/completions 路径，结果得到 404；也有人把ID当子域名加在前面，导致DNS解析失败。

验证地址是否生效的最快方式

方法一：用curl直接测试（替换为你的真实API Key和模型ID）：

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions

-H "Content-Type: application/json"

-H "Authorization: Bearer sk-xxxxx"

-d '{ "model": "doubao-1.5-pro-32k-250115", "messages": [{"role":"user","content":"test"}] }'

方法二：在Postman中新建POST请求，URL填地址，Headers加 Authorization 和 Content-Type，Body选raw→JSON，粘贴上述JSON内容 → 点击Send。返回200且含 "choices" 字段即表示地址可用。

如果返回 {"error":{"code":"invalid_request_error","message":"Invalid model id"}}，说明你用了预置模型名但填了自定义Endpoint URL，或反过来。