Video models
HappyHorse-1.1
On this page
HappyHorse-1.1 — high-quality AI video generation.
| modelId | happyhorse-1-1-reference-to-video, happyhorse-1-1-text-to-video, happyhorse-1-1-image-to-video |
| Modality | video |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Reference To Video | happyhorse-1-1-reference-to-video | POST /api/v1/generate | prompt, reference_image |
| Text To Video | happyhorse-1-1-text-to-video | POST /api/v1/generate | prompt |
| Image To Video | happyhorse-1-1-image-to-video | POST /api/v1/generate | image_urls |
| Poll task | — | GET /api/v1/task/{id}?model=happyhorse-1-1-reference-to-video | — |
Reference To Video — happyhorse-1-1-reference-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | A description of the desired elements and visual style for the generated video. Input in any language is supported. The length is limited to 5,000 non-Chinese characters or 2,500 Chinese characters. Content exceeding this limit is automatically truncated. Image referencing: In the prompt, use "[Image 1]" and "[Image 2]" to refer to the corresponding reference image in the media array. The order must be consistent with the order in the media array. When using a reference, specify the object in the image, such as "the woman in a red qipao in [Image 1]". Max 5000 characters. (default: Slow cinematic push-in with gentle ambient motion, soft light gradually shifting, and subtle parallax that brings the scene quietly to life.) |
| reference_image | string[] | Yes | The URL of a reference image. Image requirements: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: The shortest side must be at least 400 pixels. A clear image with a resolution of 720P or higher is recommended. Avoid using images that are too small, blurry, or overly compressed, as this can degrade the output quality. 3. Maximum file size: 20 MB. (image URL) |
| resolution | string | No | The resolution tier of the generated video. (options: 720p | 1080p) (default: 1080p) |
| aspect_ratio | string | No | The aspect ratio of the generated video. (options: 16:9 | 9:16 | 3:4 | 4:3 | 4:5 | 5:4 | 1:1 | 9:21 | 21:9) (default: 16:9) |
| duration | number | No | The duration of the generated video, in seconds. Value range: An integer from 3 to 15. (range 3-15) (default: 5) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"happyhorse-1-1-reference-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","reference_image":["https://example.com/input.jpg"],"resolution":"720p","aspect_ratio":"16:9","duration":5}}'Text To Video — happyhorse-1-1-text-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | Text description of the video to generate. Supports any language. Maximum 5,000 non-Chinese characters or 2,500 Chinese Max 5000 characters. (default: A skateboarder carves through an empty parking garage at sunrise, long shadows, fast tracking shot.) |
| resolution | string | No | Output video resolution. (options: 720p | 1080p) (default: 1080p) |
| aspect_ratio | string | No | Output video aspect ratio. (options: 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 4:5 | 5:4 | 9:21 | 21:9) (default: 16:9) |
| duration | number | No | Output video duration in seconds. (range 3-15) (default: 5) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"happyhorse-1-1-text-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","resolution":"720p","aspect_ratio":"16:9","duration":5}}'Image To Video — happyhorse-1-1-image-to-video
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | No | Describes the video content to generate. Supports any language. Maximum: 5,000 non-Chinese characters or 2,500 Chinese Max 5000 characters. (default: Animate the still: the red panda's bushy tail sways as it shifts its weight and tilts its head, autumn leaves drifting down around it in a slow, cozy dolly-in.) |
| image_urls | string[] | Yes | The URL of the first frame image. Image constraints: 1. Formats: JPEG, JPG, PNG, WEBP. 2. Resolution: Width and height must both be at least 300 pixels. 3. Aspect ratio: Between 1:2.5 and 2.5:1. 4. File size: Up to 20 MB. (image URL) |
| resolution | string | No | The resolution of the generated video. (options: 720p | 1080p) (default: 1080p) |
| duration | number | No | The duration of the generated video, in seconds. The value must be an integer in the range [3, 15]. Default: 5 (range 3-15) (default: 5) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"happyhorse-1-1-image-to-video","input":{"prompt":"A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.","image_urls":["https://example.com/input.jpg"],"resolution":"720p","duration":5}}'