调用流程

接口采用异步任务模式，分两步执行：

step1：调用创建任务接口，成功返回task_id

step2：调用查询任务接口查询对应task_id，直到task_status值为SUCCEEDED，获取生成视频url

创建任务接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis

请求头

请求参数

响应参数

查询任务接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/tasks/{task_id}

Path 路径参数

请求头

响应参数

请求/响应示例

参考生视频创建任务

请求

curl --location 'https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis' \
-H 'X-DashScope-Async: enable' \
-H "Authorization: Bearer ${YOUR_APP_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model": "wan2.7-r2v",
    "input": {
        "prompt": "视频1抱着图3，在图4的椅子上弹奏一支舒缓的乡村民谣，并说道：“今天的阳光真好。”图1手中拿着图2，路过视频1，把手中的图2放到视频1旁边的桌子上，并说道：“真好听，能不能再唱一遍”。",
        "media": [
            {
                "type": "reference_image",
                "url": "https://aaaa.ctyun.cn/pic/001.jpg",
                "reference_voice": "https://aaaa.ctyun.cn/wan-r2v-girl-voice.mp3"
            },
            {
                "type": "reference_video",
                "url": "https://aaaa.ctyun.cn/wan-r2v-role2.mp4",
                "reference_voice": "https://aaaa.ctyun.cn/wan-r2v-boy-voice.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://aaaa.ctyun.cn/wan-r2v-object3.png"
            },
            {
                "type": "reference_image",
                "url": "https://aaaa.ctyun.cn/wan-r2v-object4.png"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

正常响应

{
    "output": {
        "task_status": "PENDING",
        "task_id": "xxxx‑xxxx‑xxxx‑xxxx"
    },
    "request_id": "00d06a841873c0a83bfaf1fae0184625"
}

异常响应示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

查询任务请求示例

请求

curl -X GET https://ai.ctaigw.cn/v1/tasks/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"

正常响应示例

{
    "request_id": "00d06a841873c0a83bfaf1fae0184625",
    "output": {
        "task_id": "xxxx‑xxxx‑xxxx‑xxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-26 12:10:05.001",
        "scheduled_time": "2026-08-26 12:10:05.201",
        "end_time": "2026-08-26 12:10:25.001",
        "orig_prompt": "视频1抱着图3在椅子上弹奏民谣……",
        "video_url": "https://xxx/xxx.mp4"
    },
    "usage": {
        "duration": 15,
        "input_video_duration": 5,
        "output_video_duration": 10,
        "SR": 720,
        "ratio": "16:9",
        "video_count": 1
    }
}