Skip to navigation
Video Series

HappyHorse Video Models

View as Markdown

Use POST /videos to create a HappyHorse video generation task. The example includes optional route and route_mode fields; remove them to use the default available route.

curl -s https://api.getopenmodels.com/v1/videos \
  -H "Authorization: Bearer $OM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-i2v",
    "route": { "provider": "<provider-for-this-model>" },
    "route_mode": "balanced",
    "input": {
      "prompt": "Generate a video of a carp leaping over the Dragon Gate.",
      "media": [
        {
          "type": "first_frame",
          "url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
        }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false,
      "seed": 11
    }
  }'

Use the returned ID to retrieve the task status and generated video result.

curl "https://api.getopenmodels.com/v1/videos/{id}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OM_API_KEY"

For HappyHorse models, set video output options inside parameters.

FieldTypeNotes
resolutionstringOutput video resolution. Valid values: 720P, 1080P. Default: 1080P.
ratiostringOutput video aspect ratio. Valid values: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9. Default: 16:9.
durationintegerOutput video duration in seconds. For happyhorse-1.0-t2v, valid range is 3-15. Default: 5.
watermarkbooleanWhether to add a HappyHorse watermark in the lower-right corner. Default: true.
seedintegerOptional random seed in the range [0, 2147483647]. If omitted, a random seed is generated. A fixed seed improves reproducibility but does not guarantee identical results.