HappyHorse 1.0 - Text to Video

happyhorse_1.0_t2v

HappyHorse 1.0 Text to Video generates smooth, physically plausible video from a text prompt.

Endpoints

POST /v1/queue/happyhorse_1.0_t2v # Create task

GET /v1/queue/happyhorse_1.0_t2v/requests/{request_id}/status # Check status

GET /v1/queue/happyhorse_1.0_t2v/requests/{request_id}/response # Get result

PUT /v1/queue/happyhorse_1.0_t2v/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_t2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "duration": 5,
    "resolution": "720P",
    "ratio": "4:3"
  }'

prompt string required

Text prompt describing the generated video content. Chinese and English are supported, for example A cinematic shot of a white horse running across a misty grassland at sunrise. The maximum length is 2500 Chinese characters or 5000 non-Chinese characters, and content beyond the limit is truncated automatically.

duration int

Video duration in seconds. Billing is based on successfully generated output video seconds, so this parameter affects cost.

Range: 3 - 15

Default: 5

resolution string

Video resolution. Different resolution tiers use different unit prices, so this parameter affects billing cost.

Options: 720P, 1080P

Default: 1080P

ratio string

Aspect ratio for the generated video.

Options: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9

Default: 16:9

seed int

Random seed. If omitted, the system generates a random seed automatically. Use the same seed across repeated calls to improve reproducibility.

Range: 0 - 2147483647

watermark bool

Whether to add a watermark to the lower-right corner of the generated video. The fixed watermark text is Happy Horse.

Options: true, false

Default: true

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_t2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_t2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_t2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling