HappyHorse 1.1 비디오 생성
Generate, reference, or edit videos with HappyHorse 1.1
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
- Public model name:
happyhorse-1.1 - Use
actionto choose text-to-video, first-frame image-to-video, reference-to-video, or video editing - If
actionis omitted, requests with a first-frame image are treated as image-to-video; otherwise they are text-to-video - Async task management through the standard video task status endpoint
Authorizations
Authorizationstring헤더필수All requests require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEYBody
modelstring본문필수기본값: happyhorse-1.1Video generation model name. Fixed value: happyhorse-1.1.
actionstring본문기본값: text-to-videoGeneration mode.
Options:
text-to-videoimage-to-videoreference-to-videovideo-edit
If omitted, the server detects the mode from whether a first-frame image is present.
promptstring본문Text prompt for the video.
필수 for text-to-video, reference-to-video, and video editing. 선택 for image-to-video, but recommended for motion and style control.
image_urlsstring[]본문First-frame image URL for image-to-video. Only the first image is used.
Compatible fields are also accepted: input_reference, images, image, or image_with_roles[{ role: "first_frame" }].
Image requirements:
- Format:
JPEG,JPG,PNG,BMP,WEBP - File size: up to
10MB - Dimensions: at least
300px - Aspect ratio:
1:2.5to2.5:1
reference_imagesstring[]본문Reference image URLs.
필수 for reference-to-video, with 1 to 9 images. 선택 for video-edit, with up to 5 images.
urlstring본문Input video URL for video editing. 필수 when action=video-edit.
audio_settingstring본문기본값: autoAudio control for video editing. Only applies when action=video-edit.
Options:
autoorigin
durationinteger본문기본값: 5Video duration in seconds. Valid range: 3 to 15.
resolutionstring본문기본값: 1080PVideo resolution.
Options:
720P1080P
aspect_ratiostring본문기본값: 16:9Aspect ratio for text-to-video. Image-to-video uses the first-frame image dimensions.
Options:
16:99:161:14:33:4
The compatible size field is also accepted.
seedinteger본문Random seed for reproducible generation.
watermarkboolean본문기본값: trueWhether to add a watermark.
Text-to-Video Example
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "happyhorse-1.1",
"action": "text-to-video",
"prompt": "At night under an urban railway bridge, a graffiti teenager comes alive from a concrete wall and performs a high-energy English rap.",
"duration": 10,
"resolution": "1080P",
"aspect_ratio": "16:9",
"seed": 42,
"watermark": true
}'Image-to-Video Example
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "happyhorse-1.1",
"action": "image-to-video",
"prompt": "Animate the character naturally while preserving the original visual style.",
"image_urls": ["https://example.com/first-frame.png"],
"duration": 5,
"resolution": "1080P"
}'Reference-to-Video Example
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "happyhorse-1.1",
"action": "reference-to-video",
"prompt": "The character from image 1 runs through the scene in image 2, then picks up the prop from image 3. Keep a 3D cartoon style.",
"reference_images": [
"https://example.com/image-01.jpg",
"https://example.com/image-02.png",
"https://example.com/image-03.jpeg"
],
"duration": 5,
"resolution": "1080P",
"aspect_ratio": "16:9",
"watermark": false
}'Video Edit Example
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "happyhorse-1.1",
"action": "video-edit",
"prompt": "Make the video more cinematic while preserving the subject motion.",
"url": "https://example.com/input.mp4",
"reference_images": ["https://example.com/reference.png"],
"resolution": "1080P",
"audio_setting": "origin",
"seed": 42
}'Query Task
The submit endpoint returns a task ID. Use the standard video task status endpoint to retrieve the result:
curl --request GET \
--url https://toapis.com/v1/videos/generations/{task_id} \
--header "Authorization: Bearer YOUR_API_KEY"