HappyHorse 1.0

POST /v1/tasks

All models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	happyhorse-1-0
Type	Video generation (text-to-video)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

HappyHorse 1.0 is a fast text-to-video model for 3-15 second drafts, social clips, and low-cost video validation.

Production guidance

For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
Use callback.when=final. Both success and fail are terminal states, so your service should deduplicate by taskId.

Best suited for

Short video output

Create social, ad, storyboard, or product-showcase clips.

promptduration

Ratio and resolution control

Pick landscape, portrait, or square placements and control the resolution tier.

aspect_ratioresolution

Low-cost debugging

Validate the prompt with shorter duration and lower resolution before increasing quality.

durationresolution

Production callbacks

Video jobs take longer, so callback.url is the better production completion signal.

callback.url

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "happyhorse-1-0",
  "input": {
    "prompt": "A toy robot walks slowly on a clean white desk",
    "aspect_ratio": "16:9",
    "duration": 3,
    "resolution": "720p"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "happyhorse-1-0",
  "input": {
    "prompt": "A toy robot walks slowly on a clean white desk",
    "aspect_ratio": "16:9",
    "duration": 3,
    "resolution": "720p"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "happyhorse-1-0",
  "input": {
    "prompt": "A toy robot walks slowly on a clean white desk",
    "aspect_ratio": "16:9",
    "duration": 3,
    "resolution": "720p"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value happyhorse-1-0.

example happyhorse-1-0

input object required

Business parameters for HappyHorse text-to-video.

prompt string required

Prompt describing video content, scene, and style.

aspect_ratio enum optional

Output video aspect ratio.

default 16:9 enum: 1:116:93:44:39:16

duration integer optional

Output duration in seconds, range 3-15.

default 5

resolution enum optional

Output video resolution.

default 1080p enum: 720p1080p

seed integer optional

Random seed for reproducible generation. Omit for a random seed.

callback object optional

Optional callback configuration. In production, pass callback.url so HiAPI can notify your service when the task reaches a terminal state.

url string required

HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final for terminal-state notifications.

default final enum: final

Example requests

Low-cost text-to-video

Validate the prompt with short duration and 720p.

Request body

{
  "model": "happyhorse-1-0",
  "input": {
    "prompt": "A toy robot walks slowly on a clean white desk",
    "aspect_ratio": "16:9",
    "duration": 3,
    "resolution": "720p"
  }
}

Vertical short clip

For social portrait placements.