模型简介

HappyHorse参考图生视频模型，支持传入1‑9 张参考图像，结合文本提示词，把参考图里的主体、角色、物体特征融合，生成运动流畅、主体特征保留的短视频。

支持的模型

调用流程

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

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": "happyhorse-1.1-r2v",
    "input": {
        "prompt": "[Image 1]人物行走，画面流畅自然",
        "media": [
            {
                "type": "reference_image",
                "url": "https://aaaa.ctyun.cn/pic/001.jpg"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}'

正常响应

{
    "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": "[Image 1]人物行走，画面流畅自然",
        "video_url": "https://aaaa.ctyun.cn/xxx.mp4"
    },
    "usage": {
        "duration": 10,
        "input_video_duration": 0,
        "output_video_duration": 10,
        "video_count": 1,
        "SR": 720,
        "ratio": "16:9"
    }
}