happyhorse-1.1-t2v API

Use the exact model ID happyhorse-1.1-t2v. The model field must match this page exactly.

Sample outputhappyhorse-1.1-t2vPOST /v1/videos5.2s

Parameters: duration=5resolution=1080pratio=16:9

Prompt: One continuous take, no cuts. An arcade after closing, cabinets still on, carpet glowing under blacklight. A figure in a holographic windbreaker slaps the side of one cabinet and its picture comes off the screen: the pixels lift as solid coloured tiles, swarm out across the aisle and pull the pictures off every other machine with them, until the whole room is a moving cloud of cyan and hot pink squares. The camera tracks sideways down the aisle and turns into the swarm as it builds. One hard cyan key from the nearest screen, deep violet ambient. Real weight and inertia, each tile catching light separately, no text.

Request that produced this sample

{
  "model": "happyhorse-1.1-t2v",
  "prompt": "One continuous take, no cuts. An arcade after closing, cabinets still on, carpet glowing under blacklight. A figure in a holographic windbreaker slaps the side of one cabinet and its picture comes off the screen: the pixels lift as solid coloured tiles, swarm out across the aisle and pull the pictures off every other machine with them, until the whole room is a moving cloud of cyan and hot pink squares. The camera tracks sideways down the aisle and turns into the swarm as it builds. One hard cyan key from the nearest screen, deep violet ambient. Real weight and inertia, each tile catching light separately, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentication and endpoint

Use a Modelflare API key with https://modelflare.dev/v1. The gateway entry point is POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Create a task

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "watermark": false}
  }'

Poll and download

Save the task ID. Poll GET /v1/videos/{task_id} and download with GET /v1/videos/{task_id}/content. Result URLs may expire, so transfer the file promptly.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Request notes

HappyHorse uses input.prompt; choose the input.media shape that matches the t2v, i2v, or r2v model ID.

Request parameters

HappyHorse T2V uses input.prompt to generate a video.

Field	Required	Notes
model	Yes	happyhorse-1.1-t2v
input.prompt	Yes	Text description or reference instructions, up to 5,000 non-Chinese or 2,500 Chinese characters
input.media[]	No	—
parameters.resolution	No	720P / 1080P, default 1080P
parameters.ratio	No	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 4:5 / 5:4 / 9:21 / 21:9, default 16:9
parameters.duration	No	3–15 seconds, default 5
parameters.watermark	No	Whether to add the HappyHorse watermark
parameters.seed	No	Optional seed from 0 to 2,147,483,647

Input and output limits

T2V needs only input.prompt; prompts are limited to 5,000 non-Chinese or 2,500 Chinese characters, output is 720P or 1080P with nine ratio values, and duration is 3–15 seconds.

Errors and failed tasks

Invalid model parameters return a 4xx with a request ID. An asynchronous task can also enter failed after creation succeeds; use error_code and error_message from the poll response as the final task reason. Do not retry the same request with a different JSON shape.

Supported scope

This page covers Modelflare model generation and editing calls. Search or map enrichment, voice management, and element-library management are resource APIs outside this public model-call surface and are not required request fields.

Pricing and billing

This model uses per-second video billing. See the model pricing page for the current customer price, reference list price, and complete specification.

Note

This page documents Modelflare’s public interface; the fields and limits shown here are the current contract.