必须完成账号权限开通、密钥获取、接口地址确认和鉴权方式选择四环节，缺一不可；子账号需主账号授权torchlightapifullaccess策略，api key用于轻量调用（header带bearer），access key用于高频请求（需指定servicename=volc_torchlight_api），域名分mercury.volcengineapi.com（埋点/搜索类）和visual.volcengineapi.com（图像类）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎上接入各类API服务，必须先完成账号权限开通、密钥获取、接口地址确认和鉴权方式选择这四个关键环节，缺一不可。直接跳过任一环节都会导致请求被拒绝或返回 invalid_api_key、AccessDenied 等错误。
开通子账号接口访问权限
若使用子账号接入，必须由主账号在控制台手动授权，否则所有请求均会失败。
第一步：主账号登录火山引擎控制台 → 进入「访问控制」→「用户管理」→ 找到目标子账号 → 点击「添加权限」。
第二步：在策略搜索栏输入 【TorchlightApiFullAccess】 → 勾选该策略 → 提交授权。
注意：每个需调用API的子账号都必须单独配置，批量添加不生效；自定义策略中若含 Condition 字段，权限将自动失效。
获取并选择鉴权密钥
火山引擎支持两种主流鉴权方式，适用场景不同，不能混用。
方法一：API Key 接入（推荐用于轻量级、低频调用）
登录控制台 → 进入「访问控制」→「API 密钥」→ 创建 API Key → 复制保存 【Bearer 后的完整字符串】。
请求时在 Header 中添加：Authorization: Bearer <api_key></api_key>。
方法二：Access Key 接入（适用于高频、大体积请求）
进入「访问控制」→「API 访问密钥」→ 创建 AK/SK → 下载密钥文件并安全存储。
签名时必须指定 【ServiceName=volc_torchlight_api】，否则验签失败。
确认接口域名与协议
不同API对应不同域名，填错会导致 404 或连接超时。
埋点上报API 和 获取静态配置API 使用统一域名：【mercury.volcengineapi.com】。
联网搜索类API（如 webSearch）也使用该域名，但需确保请求协议为 HTTPS，且 Method 固定为 POST。
LUMI 图像算法类接口则使用独立域名：【visual.volcengineapi.com】，不可与 mercury 混用。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
