电商视频裂变

顶层参数位于请求 Body，序列化方式为 JSON。

Input

Output

说明：Output.Quality 入参为小写（720p），返回的 UsageMap.Resolution 为大写（720P）。

请求参数

返回参数

任务状态（Data.Status）：

Data.Result 字段（Status=COMPLETED）：

Data.Result 字段（Status=FAILED）：

返回示例

执行中：

{
  "RequestId": "CE7F2B64-4E5C-4C69-A437-75A4C9E5C079",
  "Code": "success",
  "Success": true,
  "Message": "Success",
  "Data": {
    "TaskId": "task_778fa8bd21804828a5d147050e30edac",
    "Status": "IN_PROGRESS",
    "Result": ""
  }
}

成功完成：

{
  "RequestId": "CE7F2B64-4E5C-4C69-A437-75A4C9E5C079",
  "Code": "success",
  "Success": true,
  "Message": "Success",
  "Data": {
    "TaskId": "task_778fa8bd21804828a5d147050e30edac",
    "Status": "COMPLETED",
    "Result": "{\"VideoUrl\":\"https://example.com/artifacts/final.mp4?Expires=...\",\"Duration\":29}",
    "UsageMap": {
      "Resolution": "720P",
      "Duration": 29
    }
  }
}

失败：

{
  "RequestId": "CE7F2B64-4E5C-4C69-A437-75A4C9E5C079",
  "Code": "success",
  "Success": true,
  "Message": "Success",
  "Data": {
    "TaskId": "task_778fa8bd21804828a5d147050e30edac",
    "Status": "FAILED",
    "Result": "{\"ErrorCode\":\"GENERATION_FAILED\",\"ErrorMessage\":\"视频生成失败，请检查输入图片是否清晰、是否与商品信息一致\"}",
    "UsageMap": {
      "Resolution": "",
      "Duration": ""
    }
  }
}

错误码

SDK 示例（Python）

安装依赖：

pip install "alibabacloud-tea-openapi>=0.4.5,<1.0.0" "darabonba-core>=1.0.0,<2.0.0"

import json, os, time
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_tea_openapi.client import Client as OpenApiClient
from darabonba.runtime import RuntimeOptions

API_VERSION = "2026-04-28"
ENDPOINT    = os.environ["AIDGE_POP_ENDPOINT"]
REGION_ID   = os.environ.get("AIDGE_POP_REGION_ID", "cn-shanghai")
AK          = os.environ["AIDGE_ACCESS_KEY_ID"]
SK          = os.environ["AIDGE_ACCESS_KEY_SECRET"]

def client():
    cfg = open_api_models.Config(
        access_key_id=AK, access_key_secret=SK,
        endpoint=ENDPOINT, region_id=REGION_ID,
    )
    return OpenApiClient(cfg)

def call(c, action, *, body=None, query=None):
    params = open_api_models.Params(
        action=action, version=API_VERSION,
        protocol="HTTPS", pathname="/", method="POST",
        auth_type="AK", style="RPC",
        req_body_type="json", body_type="json",
    )
    resp = c.call_api(
        params,
        open_api_models.OpenApiRequest(query=query or {}, body=body),
        RuntimeOptions(connect_timeout=60_000, read_timeout=60_000),
    )
    raw = resp.get("body", resp) if isinstance(resp, dict) else resp
    if isinstance(raw, (bytes, bytearray)): raw = raw.decode()
    if isinstance(raw, str): raw = json.loads(raw)
    return raw

def main():
    c = client()

    # 1. 提交任务
    submit = call(c, "EcomVideoRecreation", body={
        "Input": {
            "Mode": "product_replacement",
            "SourceVideoUrl": "https://example.com/source.mp4",
            "ProductImageUrls": ["https://example.com/product.png"],
            "ProductInfo": {"Title": "示例商品", "Category": "示例类目"},
        },
        "Output": {"Quality": "720p", "Ratio": "9:16"},
    })
    task_id = submit["Data"]["TaskId"]
    print("TaskId:", task_id)

    # 2. 轮询结果（建议每 20 秒一次）
    deadline = time.monotonic() + 7200
    while time.monotonic() < deadline:
        result = call(c, "QueryAsyncTaskResult", query={"TaskId": task_id})
        status = (result.get("Data") or {}).get("Status", "")
        print("Status:", status)
        if status in {"COMPLETED", "FAILED", "CANCELED", "TIMEOUT"}:
            data = result.get("Data") or {}
            raw_result = data.get("Result") or "{}"
            parsed = json.loads(raw_result) if isinstance(raw_result, str) else raw_result
            print(json.dumps({"Status": status, "Result": parsed,
                              "UsageMap": data.get("UsageMap")}, ensure_ascii=False, indent=2))
            return
        time.sleep(20)

if __name__ == "__main__":
    main()

注意事项

• 所有素材 URL 须在任务执行期间保持可访问，建议有效期不少于 24 小时。

• VideoUrl 可能为带有效期的签名地址，请及时下载或转存。

• 商品图建议主体清晰、无遮挡、纯色或简单背景。

• 人物参考图多张时须为同一人物，建议提供面部特写 + 正面照。

• 成片固定带声音：商品替换保留原主播声音，人物替换回填原视频声音。

• 质检告警随结果返回，不会阻断成片导出，也不会触发自动重试。

• 顶层 Success/Code 反映本次查询请求是否成功；任务本身是否成功需通过 Data.Status 判断。