Skip to content
Docs menu

Video models

HappyHorse-1.1

On this page

HappyHorse-1.1 — high-quality AI video generation.

modelIdhappyhorse-1-1-reference-to-video, happyhorse-1-1-text-to-video, happyhorse-1-1-image-to-video
Modalityvideo
PricingSee this model on the Pricing page for the current per-call price (with your markup).

Operations

OperationmodelIdEndpointRequired input
Reference To Videohappyhorse-1-1-reference-to-videoPOST /api/v1/generateprompt, reference_image
Text To Videohappyhorse-1-1-text-to-videoPOST /api/v1/generateprompt
Image To Videohappyhorse-1-1-image-to-videoPOST /api/v1/generateimage_urls
Poll taskGET /api/v1/task/{id}?model=happyhorse-1-1-reference-to-video

Reference To Video — happyhorse-1-1-reference-to-video

FieldTypeRequiredValues / example
promptstringYesA 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_imagestring[]YesThe 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)
resolutionstringNoThe resolution tier of the generated video. (options: 720p | 1080p) (default: 1080p)
aspect_ratiostringNoThe 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)
durationnumberNoThe 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

FieldTypeRequiredValues / example
promptstringYesText 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.)
resolutionstringNoOutput video resolution. (options: 720p | 1080p) (default: 1080p)
aspect_ratiostringNoOutput 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)
durationnumberNoOutput 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

FieldTypeRequiredValues / example
promptstringNoDescribes 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_urlsstring[]YesThe 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)
resolutionstringNoThe resolution of the generated video. (options: 720p | 1080p) (default: 1080p)
durationnumberNoThe 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}}'