Video models

HappyHorse-1.0

On this page

Operations
Text To Video — happyhorse-text-to-video
Image To Video — happyhorse-image-to-video
Reference To Video — happyhorse-reference-to-video
Video Edit — happyhorse-video-edit

HappyHorse-1.0 — high-quality AI video generation.

modelId	happyhorse-text-to-video, happyhorse-image-to-video, happyhorse-reference-to-video, happyhorse-video-edit
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
Text To Video	happyhorse-text-to-video	POST /api/v1/generate	prompt
Image To Video	happyhorse-image-to-video	POST /api/v1/generate	image_urls
Reference To Video	happyhorse-reference-to-video	POST /api/v1/generate	prompt, reference_image
Video Edit	happyhorse-video-edit	POST /api/v1/generate	prompt, video_url
Poll task	—	GET /api/v1/task/{id}?model=happyhorse-text-to-video	—

Text To Video — happyhorse-text-to-video

Field	Type	Required	Values / example
prompt	string	Yes	Text prompt describing the video to generate. Max 5000 characters. (default: A lone lighthouse keeper climbs a narrow spiral staircase at dawn, warm lamplight flickering over weathered stone walls as pale sea mist drifts through an open arched window.)
resolution	string	No	Output video resolution. Valid values: 720P, 1080P (default). (options: 720p \| 1080p) (default: 1080p)
aspect_ratio	string	No	Output aspect ratio. Valid values: 16:9 (default), 9:16, 1:1, 4:3, 3:4. (options: 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4) (default: 16:9)
duration	number	No	Output duration in seconds (integer). Must be between 3 and 15. Defaults to 5. (range 3-15) (default: 5)
seed	number	No	Random seed. Range: [0, 2147483647]. If not specified, the system generates a seed automatically. Fixing the seed can improve reproducibility, but results may still vary due to the model’s stochasticity.

bash

curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"happyhorse-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,"seed":1}}'

Image To Video — happyhorse-image-to-video

Field	Type	Required	Values / example
prompt	string	No	Text prompt describing the video to generate. Max 5000 characters. (default: Animate this still: charcoal embers pulse as the street vendor fans the grill and turns a row of skewers, thin smoke curling upward, the camera drifting in with a gentle handheld sway.)
image_urls	string[]	Yes	First-frame image URL list. Exactly one image is required. Minimum resolution: width and height ≥ 300px. Aspect ratio: 1:2.5 to 2.5:1. (image URL)
resolution	string	No	Output video resolution. Valid values: 720P, 1080P (default). (options: 720p \| 1080p) (default: 1080p)
duration	number	No	Output duration in seconds (integer). Must be between 3 and 15. Defaults to 5. (range 3-15) (default: 5)
seed	number	No	Random seed. Range: [0, 2147483647]. If not specified, the system generates a seed automatically. Fixing the seed can improve reproducibility, but results may still vary due to the model’s stochasticity.

bash

curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"happyhorse-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,"seed":1}}'

Reference To Video — happyhorse-reference-to-video

Field	Type	Required	Values / example
prompt	string	Yes	Required text prompt describing the desired video. Use “character1”, “character2”, ... in the prompt to refer to the corresponding images in the media array (order matches the array). Max 5,000 non‑Chinese characters or 2,500 Chinese characters; extra content is truncated. Max 5000 characters. (default: Animate the reference still: a slow push-in as warm chocolate oozes from the split lava cake, steam curling upward and a fine dusting of cocoa settling, gentle candlelight flicker across the plate.)
reference_image	string[]	Yes	Reference image URL list. Provide 1–9 images. The order defines which image is character1, character2, etc. Minimum resolution: short side ≥ 400px; 720p+ clear images are recommended. Avoid small, blurry, or heavily compressed images, as they may degrade results. (image URL)
resolution	string	No	Output video resolution. Valid values: 720P, 1080P (default). (options: 720p \| 1080p) (default: 1080p)
aspect_ratio	string	No	Output aspect ratio. Valid values: 16:9 (default), 9:16, 1:1, 4:3, 3:4. (options: 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4) (default: 16:9)
duration	number	No	Output duration in seconds (integer). Must be between 3 and 15. Defaults to 5. (range 3-15) (default: 5)
seed	number	No	Random seed. Range: [0, 2147483647]. If not specified, the system generates a seed automatically. Fixing the seed can improve reproducibility, but results may still vary due to the model’s stochasticity.

bash

curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"happyhorse-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,"seed":1}}'

Video Edit — happyhorse-video-edit

Field	Type	Required	Values / example
prompt	string	Yes	Required edit instruction describing the intended change (e.g., style transfer / local replacement). Max 5,000 non‑Chinese characters or 2,500 Chinese characters; extra content is truncated. Max 5000 characters. (default: Restyle the clip into a hand-painted watercolor dreamscape where every surface ripples like wet paint, drifting soap bubbles catch the light and a soft golden glow washes over everything, keeping the original motion intact.)
video_url	string	Yes	Input video URL list. Exactly one video is required. Duration: 3–60s. Resolution: long side ≤ 2160px, short side ≥ 320px. Aspect ratio: 1:2.5 to 2.5:1. Frame rate: > 8 fps. (image URL)
reference_image	string[]	No	Optional reference image URL list (0–5). JPEG/JPG/PNG/WEBP, up to 10MB each. Minimum resolution: width and height ≥ 300px. Aspect ratio: 1:2.5 to 2.5:1. (image URL)
resolution	string	No	Output video resolution. Valid values: 720P, 1080P (default). (options: 720p \| 1080p) (default: 1080p)
audio_setting	string	No	Audio handling strategy for the output video. (options: auto \| origin) (default: auto)
seed	number	No	Random seed. Range: [0, 2147483647]. If not specified, the system generates a seed automatically. Fixing the seed can improve reproducibility, but results may still vary due to the model’s stochasticity.

bash

curl -X POST https://you.bot/api/v1/generate \
  -H "Authorization: Bearer $YOUBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modelId":"happyhorse-video-edit","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.","video_url":"https://example.com/input.mp4","reference_image":["https://example.com/input.jpg"],"resolution":"720p","audio_setting":"auto","seed":1}}'

Grok Imagine Wan 2.7 Video