作者:互联网 时间: 2026-08-28 20:56:54
必须先在火山引擎创建推理接入点才能调用豆包大模型,否则返回404或model_not_found;需进入火山方舟管理控制台→在线推理→自定义推理接入点,地域限cn-beijing;开通Doubao-1.5-pro-256k等有效型号,命名不含空格,复制ep-开头的16位ID作为model参数;curl或API文档测试返回含choices且content非空即成功。
要在项目中调用豆包大模型,必须先在火山引擎创建推理接入点,否则 API 请求会直接返回 404 或 model_not_found 错误。
登录火山引擎控制台后,在顶部导航栏点击「大模型」→「火山方舟管理控制台」;左侧菜单栏找到「在线推理」→「自定义推理接入点」,确保当前地域为 【cn-beijing】(其他地域暂不支持豆包模型)。
首次使用需先开通模型服务。在「自定义推理接入点」页面点击「创建推理接入点」→「开通模型并接入」;在模型广场搜索框输入“Doubao”,从结果中选择一个可用型号,推荐优先选用:
• Doubao-1.5-pro-256k(长上下文、强逻辑)
• Doubao-lite-128k(响应快、成本低)
• Doubao-seed-1.6-flash(最新轻量版,适合边缘设备)
注意:Doubao-pro-4k 等旧型号已下线,选中即报错。
第一步:填写接入点名称(如“客服问答-豆包”),不可含空格或特殊符号;
第二步:选择已开通的豆包模型(必须与上一步完全一致);
第三步:地域固定为 cn-beijing,不可更改;
第四步:点击「确认接入」,状态变为「运行中」即生效(通常 30 秒内);
第五步:在列表中找到刚创建的条目,点击右侧「复制 ID」,得到一串以 【ep-】开头的 16 位字符串】(例如 ep-20260819abcd1234),这是后续调用必需的 model 参数值。
方法一:直接 curl 测试(需替换 YOUR_API_KEY 和 EP_ID):
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions"-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"model":"EP_ID","messages":[{"role":"user","content":"你好"}]}'
方法二:进入「API 调用文档」页,点击对应模型的「Try it out」按钮,填入接入点 ID 后执行测试请求;
若返回 JSON 中含 "choices" 字段且 content 不为空,则接入点已就绪。