模型简介

HappyHorse 文生视频（Text‑to‑Video）生成模型，通过输入文本提示词，生成物理真实、运动流畅的 MP4 视频内容。API 采用异步任务模式：创建生成任务获取 task_id，轮询 task_id 获取视频结果

支持的模型

调用流程

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

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-t2v",
    "input": {
        "prompt": "复古70年代地铁站，街头音乐家弹奏吉他，路人匆匆走过，镜头缓慢右移"
    },
    "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": "复古70年代地铁站，街头音乐家弹奏吉他，路人匆匆走过，镜头缓慢右移",
        "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"
    }
}