HappyHorse 1.0 Video Generation

Generate, reference, or edit videos with HappyHorse 1.0

POST /v1/videos/generations

HappyHorse 1.0 Video Generation

cURL

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "image_urls": [
    "<string>"
  ],
  "reference_images": [
    "<string>"
  ],
  "url": "<string>",
  "audio_setting": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "seed": 123,
  "watermark": true
}
'

• Public model name: happyhorse-1.0
• Use action to choose text-to-video, first-frame image-to-video, reference-to-video, or video editing
• If action is 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

Authorization · string · required

All requests require Bearer Token authentication.

Authorization: Bearer YOUR_API_KEY

Body

model · string · default: "happyhorse-1.0" · required

Video generation model name. Fixed value: happyhorse-1.0.

action · string · default: "text-to-video"

Generation mode.

Options:

• text-to-video
• image-to-video
• reference-to-video
• video-edit

If omitted, the server detects the mode from whether a first-frame image is present.

prompt · string

Text prompt for the video.

Required for text-to-video, reference-to-video, and video editing. Optional for image-to-video, but recommended for motion and style control.

image_urls · string[]

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.5 to 2.5:1

reference_images · string[]

Reference image URLs.

Required for reference-to-video, with 1 to 9 images. Optional for video-edit, with up to 5 images.

url · string

Input video URL for video editing. Required when action=video-edit.

audio_setting · string · default: "auto"

Audio control for video editing. Only applies when action=video-edit.

Options:

• auto
• origin

duration · integer · default: 5

Video duration in seconds. Valid range: 3 to 15.

resolution · string · default: "1080P"

Video resolution.

Options:

• 720P
• 1080P

aspect_ratio · string · default: "16:9"

Aspect ratio for text-to-video. Image-to-video uses the first-frame image dimensions.

Options:

• 16:9
• 9:16
• 1:1
• 4:3
• 3:4

The compatible size field is also accepted.

seed · integer

Random seed for reproducible generation.

watermark · boolean · default: true

Whether 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.0",
    "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.0",
    "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.0",
    "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.0",
    "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"

Channel Configuration

HappyHorse uses a DashScope API key. The default upstream base URL is https://dashscope.aliyuncs.com.

For the international endpoint, override the channel Base URL in the admin dashboard:

https://dashscope-intl.aliyuncs.com