先获取AccessKey和SecretKey：登录火山引擎控制台→访问控制→访问密钥→创建AccessKey，立即复制保存SK；再配置域名与Region，如视觉类用visual.volcengineapi.com、Region填cn-north-1；最后构造HTTP请求，含签名Header、合规Body及完整URL，并用curl/Postman/LUMI错误码403排查验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在业务系统中调用火山引擎提供的AI能力、视频处理或数据服务，但不知道从哪一步开始配置密钥、域名和请求参数。
获取AccessKey和SecretKey
登录火山引擎控制台 → 进入「访问控制」→ 点击「访问密钥」→ 点击「创建AccessKey」。
创建成功后，页面会一次性显示AccessKey ID（AK）和SecretAccessKey（SK），【务必立即复制保存，SK仅显示一次，关闭页面后无法再次查看】。
不要使用主账号AK/SK直接调用生产接口，建议为不同业务创建独立子用户并授予最小权限策略。
确认服务域名与区域
不同服务的请求域名不同，例如：
视觉类API（如LUMI算法服务）固定使用 visual.volcengineapi.com；
DataSail数据上报服务华北2（北京）地域使用 datasail01-cn-beijing.volceapplog.com；
VeCDP OpenAPI私有化部署地址形如 xxx.datarangers-onpremise.volces.com，SaaS版则为 console.volcengine.com/cdp/open_platform/openapi。
Region参数绝大多数场景下必须填 cn-north-1，除非文档明确标注其他可用值。
构造标准HTTP请求
第一步：设置Header必填字段
Content-Type: application/json
Authorization: 按火山签名方案生成的鉴权字符串（需用AK/SK对请求时间、路径、参数等联合签名）
ServiceName: 如cv（视觉）、dataleap（DataSail）等，具体值查对应服务文档
Region: cn-north-1
第二步：组织Body内容
以LUMI异步任务提交为例，Body中必须包含 req_key（你部署能力时定义的唯一标识）、res_quota_name（资源池名称），binary_data（Base64图片列表）与data_source（公网URL）二者至少传其一。
第三步：拼接完整URL
格式为 https://{服务域名}/{接口路径}，例如DataSail上报地址为 https://datasail01-cn-beijing.volceapplog.com/v1/production/general/collect/{采集任务ID}/list。
验证API是否可用
方法一：用curl命令快速测试
将你的AK、SK、域名、任务ID代入官方示例curl命令，执行后返回200且含task_id即表示基础链路通。
方法二：在Postman中导入火山引擎提供的OpenAPI规范JSON文件，自动填充Header和Body模板，点击Send即可发起调试请求。
方法三：调用LUMI服务时，若返回错误码403且提示“Invalid signature”，说明Authorization签名计算有误——【检查时间戳是否与服务器时间偏差超过15分钟，这是最常见的签名失败原因】。
