HappyHorse 1.0 - Reference to Video

happyhorse_1.0_r2v

HappyHorse 1.0 Reference to Video 可根据一张或多张参考图像，按文本提示词生成视频。

调用地址

POST /v1/queue/happyhorse_1.0_r2v # 创建任务

GET /v1/queue/happyhorse_1.0_r2v/requests/{request_id}/status # 查询状态

GET /v1/queue/happyhorse_1.0_r2v/requests/{request_id}/response # 获取结果

PUT /v1/queue/happyhorse_1.0_r2v/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_r2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "media": [
      {
        "type": "reference_image",
        "url": "https://image.cdn2.seaart.me/2026-06-01/d8ejq1de878c739e2lrg/995ff4fe1eeec10a06c3c7a172862733.webp"
      }
    ],
    "duration": 5,
    "resolution": "720P",
    "ratio": "4:3"
  }'

prompt string 必填

文本提示词，用于描述生成视频的内容，支持中文和英文。使用 [Image 1]、[Image 2] 等占位符引用参考图，顺序与 media 数组一致，例如 [Image 1] gallops through a forest while [Image 2] follows behind。中文最大长度为 2500 个字符，非中文为 5000 个字符，超出限制的内容会被自动截断

media array 必填

参考图像数组

范围：1 到 9 张参考图像

type string 必填

媒体类型，固定为 reference_image

url string 必填

参考图像 URL 或 Base64 编码图像数据

图像要求：

支持格式：JPEG、JPG、PNG、WEBP

短边：不小于 400 像素

建议分辨率：720P 或更高

文件大小：最大 20MB

输入格式：

可公网访问的 HTTP 或 HTTPS URL

Base64 格式：data:<MIME_type>;base64,<base64_data>

MIME 类型：JPEG/JPG 为 image/jpeg，PNG 为 image/png，WEBP 为 image/webp

duration int

视频时长，单位为秒；计费按成功生成的输出视频秒数计算，因此该参数会影响成本

范围：3 - 15

默认值：5

resolution string

视频分辨率，不同分辨率档位单价不同，因此该参数会影响计费成本

可选值：720P、1080P

默认值：1080P

ratio string

指定生成视频的宽高比

可选值：16:9、9:16、1:1、4:3、3:4、4:5、5:4、9:21、21:9

默认值：16:9

seed int

随机种子；如果不指定，系统会自动生成随机种子；如需提升复现性，可在重复调用时使用相同 seed 值

范围：0 - 2147483647

watermark bool

是否在生成视频右下角添加水印，固定水印文字为 Happy Horse

可选值：true、false

默认值：true

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_r2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_r2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_r2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理