必须完成api密钥获取、服务接入点配置和客户端工具对接三步闭环操作,否则请求返回401或connection refused;需在cn-beijing区域开通ark在线推理接入点、复制openai兼容api地址、保管好access key id与secret access key,并通过cherry studio配置验证后添加模型id方可调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在本地安全调用火山引擎提供的豆包等大模型服务,必须先完成API密钥获取、服务接入点配置和客户端工具对接三步闭环操作,漏掉任一环节都会导致请求返回401或Connection refused错误。
开通火山方舟并创建在线推理接入点
打开火山引擎控制台 → 切换区域为 【cn-beijing】 → 左侧导航栏点击「ARK」→ 进入「在线推理」页面。
点击「创建接入点」→ 填写名称(如“豆包1.6-pro”)→ 点击「添加模型」→ 在弹出列表中选择目标模型(例如 doubao-1.5-thinking-pro)。
鼠标悬停在模型卡片上可查看详细参数说明,避免误选仅支持视觉输入的 multimodal 版本;若不确定能力边界,优先选带 “thinking” 后缀的通用型模型。
创建完成后,进入该接入点详情页 → 点击左侧「API调用」→ 下拉找到「OpenAI SDK调用示例」→ 复制其中的 API 地址(格式为 https://ark.cn-beijing.volces.com/api/v3/)。
获取并保管好API Key
在控制台右上角头像处点击「API密钥管理」→ 点击「创建API Key」→ 记录下生成的 Access Key ID 和 Secret Access Key。
【这是调用模型的唯一凭证,泄露将导致账户被盗用、产生不可控费用】
新注册用户默认赠送50万Token额度,额度用尽后需手动充值或绑定支付方式,否则所有请求将被拒绝。
用Cherry Studio完成本地对接
下载并安装 Cherry Studio 客户端(官网 cherry.studio)→ 启动后点击右下角「设置」→ 选择「模型服务」→ 点击「火山引擎」。
在「API Key」栏粘贴刚复制的 Access Key ID,在「API地址」栏粘贴前面复制的 OpenAI 兼容地址 → 【务必确认地址末尾有斜杠 /,否则检测必失败】。
点击「检测」按钮 → 若提示 success,说明基础连接已通;若报错,请检查区域是否为 cn-beijing、地址是否含尾部斜杠、Key 是否复制完整。
检测通过后,下拉页面找到「添加模型」按钮 → 回到火山方舟「在线推理」页,打开刚创建的接入点 → 复制顶部显示的模型ID(如 doubao-1.5-thinking-pro)→ 粘贴到 Cherry 的「模型ID」输入框 → 点击「更多设置」→ 按需勾选「流式响应」「函数调用」等功能开关。
保存后,回到主聊天窗口 → 在模型选择下拉菜单中找到刚添加的名称 → 输入问题发送,即可获得来自火山引擎的真实大模型响应。











