文档总结工具需通过火山方舟平台绑定的推理接入点ID调用模型,仅配置API Key无效;必须在控制台核对接入点ID与模型绑定关系,并在请求中显式传入该ID作为model参数,否则触发404或降级。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让文档总结工具能调用火山引擎上已绑定API Key的模型,而不是单纯配置密钥——因为模型和密钥在火山方舟平台是解耦管理的,只配Key不指定模型ID会导致请求失败或默认回退到低配模型。
确认模型与API Key已正确关联
进入火山方舟控制台 → 左侧菜单点击「在线推理」→ 找到你创建的推理接入点(例如名称为“DocSummarize-Model”)→ 点击右侧「详情」→ 查看「模型名称」和「接入点ID」是否与你在API Key管理页中绑定的模型一致。
【必须核对接入点ID】 文档总结工具后续调用时,需显式传入该ID作为model参数,否则即使API Key有效,也会因未指定模型而触发404或降级响应。
若未绑定,返回「在线推理」页面 → 点击该接入点右侧「编辑」→ 在「模型配置」中重新选择目标模型(如doubao-seed-1.6)→ 保存。
获取可用的模型调用地址与认证方式
在同一个推理接入点详情页中,向下滚动至「调用信息」区域 → 复制「HTTP Endpoint」URL(形如https://ark.cn-beijing.volces.com/api/v1/chat/completions)。
打开「访问密钥」管理页(右上角头像 → 访问密钥)→ 找到你用于文档总结的API Key → 点击「查看」→ 复制Secret Key和Access Key。
注意:Secret Key仅显示一次,关闭后不可恢复。若已丢失,必须删除旧密钥并新建一个。
在文档总结工具中完成接入配置
方法一:直接填入HTTP请求参数(适用于支持自定义API的工具,如Dify、Cherry Studio)
① 在工具的「LLM设置」或「模型配置」中选择「OpenAI兼容接口」模式
② 填写Endpoint URL(粘贴上一步复制的HTTP Endpoint)
③ 填写API Key(使用Access Key,不是Secret Key)
④ 在Headers中手动添加:Authorization: Bearer <你的Access Key> 和 x-volc-sdk-version: 2023-08-01
⑤ 在请求Body中确保包含 "model": "<你的接入点ID>" 字段,例如 "model": "dp-xxxxx"
方法二:使用火山引擎官方Python SDK(推荐用于自研脚本或本地部署工具)
安装SDK:pip install volcengine
初始化客户端时,必须传入接入点ID而非模型名:
from volcengine.visual import VisualService<br>client = VisualService.from_api_key('<strong>Access Key</strong>', '<strong>Secret Key</strong>')<br># 注意:此处不传model参数,模型由接入点ID隐式决定
方法三:通过Dify工作流节点直连(无需手写代码)
在Dify画布中添加「大模型」节点 → 选择「火山引擎」作为供应商 → 输入Endpoint、Access Key → 关键一步:在「模型」下拉框中选择你创建的推理接入点名称(不是模型原始名称),Dify会自动提取对应ID注入请求。

















