调用火山引擎模型服务需按API类型配置Base URL:数据面API(如/chat/completions)用https://ark.cn-beijing.volces.com/api/coding/v3(OpenAI兼容)或https://ark.cn-beijing.volces.com/api/coding(Anthropic兼容),管控面API用https://ark.cn-beijing.volcengineapi.com/。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在各类AI开发工具中正确调用火山引擎的模型服务,必须配置准确的Base URL,否则会触发额外计费或直接报错返回401/403。
先确认你要调用的是哪类API
火山引擎的API分两类,用途、鉴权方式、URL都不同,选错就无法通信:
① 数据面 API:真正调模型用的,比如/chat/completions、/v1/chat/completions;
② 管控面 API:管理API Key、模型接入点等后台操作,比如创建Key、查询额度。
绝大多数开发者(用Cline、Codex、Hermes、Claude Code、OpenCode等)调用的是数据面 API,请直接跳到下一节。只有你在写脚本批量创建API Key、查配额余额、或集成管控后台时,才需要管控面地址。
数据面 API 的 Base URL 配置
根据你使用的工具协议兼容性,选择对应URL:
方法一:OpenAI 兼容协议工具(最常用)
适用工具:Hermes Agent、Cline、Codex CLI、Cursor、Kilo Code、Roo Code、OpenClaw、TRAE、OpenCode
Base URL:https://ark.cn-beijing.volces.com/api/coding/v3
方法二:Anthropic 兼容协议工具
适用工具:Claude Code(注意:不是Claude Pro直连,而是走火山Coding Plan代理)
Base URL:https://ark.cn-beijing.volces.com/api/coding
⚠️ 重要提醒:千万不要填 https://ark.cn-beijing.volces.com/api/v3 ——这个地址虽能通,但不走Coding Plan额度,所有调用都会从你的主账号余额扣费,且无用量监控。
管控面 API 的 Base URL 配置
仅用于调用平台管理接口,例如:
• 创建/删除API Key
• 查询模型接入点状态
• 获取配额使用明细
• 批量绑定子账号权限
管控面统一使用:https://ark.cn-beijing.volcengineapi.com/
该地址必须配合Access Key(AK/SK)签名鉴权,不支持API Key直接Bearer认证。请求超时时间为30秒,整体请求体不能超过8MB。


















