必须先创建自定义推理接入点才能调用DeepSeek-R1等模型,否则API请求返回404;需完成实名认证、开通模型权限、创建API Key、绑定凭证并获取Endpoint与专属模型ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在火山引擎上让自己的应用调用特定大模型(比如 DeepSeek-R1 或 Doubao-pro-32k),必须先创建一个专属的自定义推理接入点,否则 API 请求会因模型 ID 不存在而直接报错 404。
开通模型权限并实名认证
登录火山引擎控制台 → 点击右上角头像 → 进入【账号管理】→ 【实名认证】,选择个人或企业类型完成认证。未实名的账号无法创建 API Key,也无法开通任何大模型服务。
实名后,访问 方舟大模型平台 → 左侧导航栏点击【模型广场】→ 搜索目标模型(如 UI-TARS、Doubao-pro-32k-241215 或 DeepSeek-R1)→ 找到对应卡片 → 点击【开通】。个人账号默认获得每日 1000 次免费调用额度,企业账号可扩容。
创建 API Key
返回方舟首页 → 左侧导航栏点击【API 调用】→ 【凭证管理】→ 【创建凭证】。
填写凭证名称(例如 Midscene-Doubao),权限范围选【方舟大模型】→ 点击【确定】。
【务必立即复制保存 Secret Key】 —— 页面仅显示一次,关闭后不可找回,丢失需重新创建并更新所有已配置服务。
创建自定义推理接入点
第一步:进入左侧导航栏【在线推理】→ 【自定义推理接入点】→ 点击【创建推理接入点】。
第二步:填写基本信息 → “接入点名称”可自定义(如 ds-r1-fullchain)→ 点击【添加模型】。
第三步:在弹出窗口中,从已开通的模型列表里勾选目标模型 → 必须点选【主线模型】(非灰度/测试分支)→ 点击【确认接入】。
第四步:返回接入点列表页 → 找到刚创建的接入点(名称以 ep- 开头)→ 点击进入详情页 → 在右侧【API Key 绑定】区域,下拉选择刚创建的凭证 → 点击【绑定】。
第五步:绑定成功后,页面自动显示该接入点的完整 Endpoint 地址,格式为 https://ark.cn-beijing.volces.com/api/v3,同时给出专属模型 ID(如 ep-20250512195705-c8kq4)。这两个值将用于后续所有 API 请求的 host 和 model 字段。
验证接入点是否可用
方法一:在接入点详情页点击【调用测试】→ 填写用户问题 → 点击【发送】,查看返回 JSON 中是否有 "choices":[...] 及有效响应内容。
方法二:使用 curl 命令本地验证(替换为你的真实 API Key 和模型 ID):
curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \-H "Content-Type: application/json" \-H "Authorization: Bearer <your_api_key_here>" \</your_api_key_here>-d '{ "model": "ep-20250512195705-c8kq4", "messages": [{"role":"user","content":"你好"}] }'
若返回 "error" 字段为空且含 "content",说明接入点已就绪。


















