火山引擎智能创作混剪API调用混剪任务实现

调用火山引擎混剪API需先获取AccessKey并构造合规签名请求，否则返回401或SignatureNotMatch；必填字段包括template_id、input_materials（含HTTPS视频URL及精准duration）、output_config；成功返回task_id后需轮询获取结果。

调用火山引擎智能创作混剪API创建混剪任务，需要先获取AccessKey并构造符合签名规范的HTTP请求，否则会返回401错误或SignatureNotMatch异常。

准备认证凭证与请求头

登录火山引擎控制台→进入「访问密钥」页面→点击「创建AccessKey」→复制AccessKeyId和AccessKeySecret。

构造Authorization请求头：得用HMAC-SHA256算法给规范请求字符串签名，签名原文得包含HTTP方法、URI、查询参数、Header列表（x-tos-date、host）、Header签名值（x-tos-date、host）以及payload hash。这一步可不能省，要是漏了x-tos-date或者把host拼错了，就会出现403 Forbidden的情况。

设置x-tos-date为RFC3339格式的UTC时间（如2024-05-21T10:30:45Z），误差超过15分钟将被拒绝。

构造混剪任务请求体

POST请求地址为：https://smartcreation.volcengineapi.com/api/v1/mixcut/task

请求体必须为JSON格式，包含以下必填字段：

• template_id：混剪模板ID，从智能创作控制台「模板市场」中复制，

  【为空或格式错误将导致400 Bad Request】
• input_materials：数组，每个元素含url（视频直链，需HTTPS且可公网访问）、duration（秒级精度，必须与实际视频时长误差≤0.5秒）
• output_config：含bucket（目标OSS Bucket名）、region（如cn-north-1）、prefix（输出路径前缀，以/结尾）

示例片段：{
  "template_id": "tpl-abc123",
  "input_materials": [
    {
      "url": "https://example.com/a.mp4",
      "duration": 12.3
    }
  ],
  "output_config": {
    "bucket": "my-bucket",
    "region": "cn-north-1",
    "prefix": "mixcut/output/"
  }
}

发起调用并解析响应

使用curl或SDK发送POST请求，确保Content-Type为application/json；签名头和body必须严格匹配，否则返回SignatureDoesNotMatch。

成功响应返回HTTP 200，body含task_id（如task-xyz789）和status（"queued"）。

立即用该task_id调用GET /api/v1/mixcut/task/{task_id}轮询状态，直到status变为"success"或"failed"。