HappyHorse 调用说明

本文着重介绍视频生成调用方式和官方的区别，具体细节可参考HappyHorse 官方 API 文档

本平台调用示例

HappyHorse 按生视频类型区分 model，不同类型对应不同模型与媒体元素：

生视频类型model媒体元素（input.media）
文生视频happyhorse-1.1-t2v无
图生视频-基于首帧happyhorse-1.1-i2vfirst_frame 首帧图
参考生视频（多图像）happyhorse-1.1-r2v多个 reference_image 参考图
视频编辑（指令+参考图）happyhorse-1.0-video-editvideo 待编辑视频 + reference_image 参考图

创建任务

请求体由三部分组成：model（生视频类型）、input（提示词 prompt 与媒体数组 media）、parameters（分辨率、比例、时长等参数）。下面按生视频类型分别给出示例。

文生视频

curl -X POST 'https://api.token-hubs.com/video/happy-horse' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {
        "prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。"
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}'

图生视频-基于首帧

curl -X POST 'https://api.token-hubs.com/video/happy-horse' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "input": {
        "prompt": "一只猫在草地上奔跑",
        "media": [
            {
                "type": "first_frame",
                "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "duration": 5
    }
}'

参考生视频（多图像）

curl -X POST 'https://api.token-hubs.com/video/happy-horse' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "happyhorse-1.1-r2v",
    "input": {
        "prompt": "[Image 1]中身着红色旗袍的女性，镜头先以侧面中景勾勒旗袍修身剪裁与S型曲线，随即切换至低角度仰拍，捕捉她轻抬玉手展开[Image 2]中的折扇的同时，[Image 3]中的流苏耳坠随头部转动轻盈摆动的细节，最后推近至面部特写，定格在她指尖轻点扇骨、眼波流转间的含蓄风情，多视角全方位展现东方韵味。",
        "media": [
            {
                "type": "reference_image",
                "url": "https://example.com/girl.jpg"
            },
            {
                "type": "reference_image",
                "url": "https://example.com/folding-fan.jpg"
            },
            {
                "type": "reference_image",
                "url": "https://example.com/earrings.jpg"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 5
    }
}'

提示词中以 [Image 1]、[Image 2]… 引用 media 数组中对应顺序的参考图。

视频编辑（指令+参考图）

curl -X POST 'https://api.token-hubs.com/video/happy-horse' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "happyhorse-1.0-video-edit",
    "input": {
        "prompt": "让视频中的马头人身角色穿上图片中的条纹毛衣",
        "media": [
            {
                "type": "video",
                "url": "https://example.com/source-video.mp4"
            },
            {
                "type": "reference_image",
                "url": "https://example.com/clothes.webp"
            }
        ]
    },
    "parameters": {
        "resolution": "720P"
    }
}'

返回体（创建成功后返回任务 task_id，用于后续查询任务状态）：

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

查询任务

curl -X GET 'https://api.token-hubs.com/video/happy-horse/{task_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

返回体随任务状态变化，任务成功（output.task_status 为 SUCCEEDED）时，output.video_url 即为生成视频的下载地址：

{
    "request_id": "99243b47-ec5f-9413-9993-xxxxxx",
    "output": {
        "task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-04-20 17:55:17.075",
        "scheduled_time": "2026-04-20 17:55:17.129",
        "end_time": "2026-04-20 17:56:36.658",
        "orig_prompt": "一座由硬纸板和瓶盖搭建的微型城市，在夜晚焕发出生机。一列硬纸板火车缓缓驶过，小灯点缀其间，照亮前路。",
        "video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx"
    },
    "usage": {
        "duration": 5,
        "input_video_duration": 0,
        "output_video_duration": 5,
        "video_count": 1,
        "SR": 720,
        "ratio": "16:9"
    }
}

视频生成为异步任务，需轮询本接口直到 output.task_status 变为 SUCCEEDED，再从 output.video_url 获取视频。video_url 含签名且有有效期（示例 Expires 参数为过期时间），请及时下载转存。

注意事项

请求参数说明

  • 按类型区分 model：文生视频 / 图生视频 / 参考生视频 / 视频编辑分别使用 happyhorse-1.1-t2v、happyhorse-1.1-i2v、happyhorse-1.1-r2v、happyhorse-1.0-video-edit。
  • media 字段：媒体元素放入 input.media 数组，通过 type 区分用途（first_frame 首帧 / reference_image 参考图 / video 待编辑视频）；文生视频无需 media。
  • parameters 字段：resolution（如 720P）、ratio（如 16:9）、duration（秒）等参数置于 parameters 中；图生视频与视频编辑可省略 ratio（由输入媒体决定画面比例）。
  • 接口地址：仅需将官方地址替换为本平台地址 https://api.token-hubs.com/video/happy-horse，其余字段用法与官方文档相同。