调用火山引擎混剪API需先获取AccessKey并构造合规签名请求,否则返回401或SignatureNotMatch;必填字段包括template_id、input_materials(含HTTPS视频URL及精准duration)、output_config;成功返回task_id后需轮询获取结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

调用火山引擎智能创作混剪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"。


















