必须使用正确的api地址才能成功调用火山引擎torchlight静态配置接口:api key方式为https://open.volcengine.com/api/torchlight/v1/config,access key方式为https://torchlight-api-{region}.volcengineapi.com,且需匹配智能体实际部署地域。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在火山引擎控制台中配置API调用时,必须准确获取接口地址才能发起请求,否则会因URL错误直接返回404或400状态码。
查看静态配置API的正式接入地址
静态配置API用于获取智能体开场白等前端渲染所需数据,其地址取决于你选择的鉴权方式——API Key或Access Key,两者域名不同,不可混用。
方法一:API Key接入方式
访问地址为:【https://open.volcengine.com/api/torchlight/v1/config】。该地址仅支持HTTPS协议,且必须在请求头中携带 Authorization: Bearer <api_key></api_key>,否则返回invalid_api_key错误。
方法二:Access Key接入方式
地址为:【https://torchlight-api.volcengineapi.com】。注意此域名不带/api路径前缀,且需按火山引擎统一签名规范构造X-Amz-Date、Authorization等签名头,否则报错100013:AccessDenied。
确认当前地域对应的Endpoint
部分服务(如Torchlight API)在不同地域部署独立接入点,若未指定正确地域,请求可能被路由失败。
第一步:登录火山引擎控制台 → 进入「产品与服务」→ 找到「智能体平台 Torchlight」→ 点击进入控制台。
第二步:在左侧导航栏点击「智能体管理」→ 选择目标智能体 → 点击「配置」标签页。
第三步:向下滚动至「API接入信息」区块,此处明确列出当前智能体所在地域(如cn-beijing)对应的完整Endpoint,格式为https://torchlight-api-{region}.volcengineapi.com。若该区块为空,请先保存一次基础配置再刷新页面。
注意:若你在CLI中使用ve login配置了profile,可通过ve config list --profile your-profile-name命令查看已设置的endpoint-url值,但该值仅适用于CLI工具,不等同于API调用的实际HTTP Endpoint。
从开发者文档反向验证地址
官方文档是最终权威来源,当控制台界面未显示完整URL时,应以文档为准。
打开火山引擎官方文档页面「Torchlight API 接口文档」→ 查找「获取静态配置」接口 → 在「请求URL」字段中复制完整地址。该地址已包含地域路径(如/v1/config)和协议,直接粘贴即可使用。
若文档中同时列出多个地域的示例URL,请核对你的智能体实际部署地域,选择对应URL。例如:上海地域用https://torchlight-api-cn-shanghai.volcengineapi.com/v1/config,广州地域则用cn-guangzhou替换其中的地域标识。











