Happy Horse 1.1

happy-horse-1.1 的重点是多图参考，最多可用 9 张图片约束人物、产品、服装、场景或品牌视觉；也可以只提供 1 张首帧生成视频。

快速了解

项目	支持范围
任务流程	`POST /v1/task/submit` 提交，`GET /v1/task/{task_id}` 查询
视频时长	3–15 秒
清晰度	720p、1080p
画面比例	`1:1`、`3:4`、`4:3`、`16:9`、`9:16`
素材输入	最多 9 张参考图，或 1 张首帧
提示词增强	`AUTO` 自动增强，`OFF` 保持原提示词
音频生成	支持，默认开启

请求使用 Bearer 认证，生成参数统一放在 input 对象中：

Authorization: Bearer $API_KEY

input 参数

字段	类型	必填	说明
`prompt`	string	是	提示词，最多 5000 个字符
`duration`	integer	是	3–15 秒
`aspect_ratio`	string	是	`1:1`、`3:4`、`4:3`、`16:9`、`9:16`
`resolution`	string	是	`720p` 或 `1080p`
`image_references`	array	否	参考图，最多 9 张
`start_frames`	array	否	首帧，只能传 1 张
`images`	array	否	`start_frames` 的兼容别名，只读取第 1 张
`prompt_enhance`	string	否	`AUTO` 或 `OFF`
`audio`	boolean	否	是否生成带音频视频，默认 `true`

image_references 用于多图约束，start_frames 用于固定开头画面，两种用途不要混淆。模型不支持 end_frames、video_references、audio_references。

输出尺寸

aspect_ratio	720p	1080p
`1:1`	`960x960`	`1440x1440`
`3:4`	`832x1108`	`1248x1662`
`4:3`	`1108x832`	`1662x1248`
`16:9`	`1280x720`	`1920x1080`
`9:16`	`720x1280`	`1080x1920`

请求示例

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happy-horse-1.1",
    "input": {
      "prompt": "让参考图中的角色在同一个场景里自然互动，镜头跟随移动，画面稳定",
      "image_references": [
        {"url": "https://example.com/ref1.jpg"},
        {"url": "https://example.com/ref2.jpg"},
        {"url": "https://example.com/ref3.jpg"}
      ],
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 5,
      "prompt_enhance": "AUTO",
      "audio": true
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happy-horse-1.1",
    "input": {
      "prompt": "以这张画面作为首帧，人物向前走近镜头，背景保持真实自然",
      "start_frames": [
        "https://example.com/start.jpg"
      ],
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "duration": 6,
      "prompt_enhance": "OFF",
      "audio": false
    }
  }'

获取结果

提交成功后保存返回的 id，再用它查询任务：

curl https://cdn.12ai.org/v1/task/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer $API_KEY"

当 status 为 completed 时，从 outputs 读取视频 URL：

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "completed",
  "phase": "completed",
  "outputs": [
    "https://img.12ai.org/videos/task_xxxxxxxxxxxxxxxx_0.mp4"
  ],
  "error": null
}

轮询状态、失败处理和回调格式见异步视频任务。

使用建议

场景	建议
多主体或多产品	使用 `image_references`，并在提示词中说明每张图的用途或关系
固定开头画面	使用 1 张 `start_frames`；新接入不必使用兼容字段 `images`
提示词增强	想让模型自动补充画面细节用 `AUTO`；需要严格跟随原提示词用 `OFF`
首尾帧过渡	改用 Seedance，本模型不支持 `end_frames`