How do I access the Happy Horse 1.0 API?

Sign up, generate an API key, and use the model ID 'happy-horse-1.0' in your requests to the REST API.

Is there a free tier for the API?

Yes. A free tier is available for testing the API. Visit the pricing page for current limits and paid plan options.

Does the API support image-to-video?

Yes. Pass an image_url parameter alongside your prompt to use Happy Horse 1.0's image-to-video mode (I2V Elo 1,402).

How long does API generation take?

Happy Horse 1.0 generates a clip in approximately 38 seconds. Actual API response time may vary based on queue load.

Can I use webhooks to get notified when a job completes?

Yes. Pass a webhook_url parameter in your request and the API will POST the result to your endpoint when generation completes.

Can I switch between models using the same API?

Yes. The API supports multiple models. Change the model parameter to switch between Happy Horse 1.0, Seedance 2.0, Kling, and others.

Developer API

Happy Horse 1.0 API

Generate cinematic AI video programmatically. Access Happy Horse 1.0 through a simple REST API — endpoints, webhooks, and multi-model support included.

Try OnlineAPI Coming Soon

Free tier available · No GPU required

Quick Start

Start generating video with Happy Horse 1.0 in minutes.

curl -X POST https://api.topview.ai/v1/video/generate \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d {
    "model": "happy-horse-1.0",
    "prompt": "A horse galloping through a golden field at sunset",
    "resolution": "1080p",
    "audio": true
  }

API Capabilities

Everything you need to build AI video into your product.

Text-to-Video

Generate cinematic 1080p video from any text prompt using Happy Horse 1.0's 15B-parameter model.

Image-to-Video

Animate any image into a fluid video clip with Happy Horse 1.0's top-ranked I2V Elo 1,402 model.

Webhooks

Receive real-time job completion callbacks to your endpoint — no polling required.

Multi-Model

Switch between Happy Horse 1.0, Seedance 2.0, Kling, and other models with a single parameter change.

API Parameters

Key parameters for the /v1/video/generate endpoint.

Parameter	Type	Required	Description
model	string	Yes	Model ID. Use "happy-horse-1.0" for Happy Horse.
prompt	string	Yes	Text description of the video to generate.
image_url	string	No	URL of reference image for image-to-video generation.
resolution	string	No	Output resolution. Default: "1080p".
audio	boolean	No	Enable joint audio generation. Default: true.
webhook_url	string	No	URL to receive job completion callback.

API Pricing

The API offers a free tier for testing and flexible pay-as-you-go plans for production. Visit the pricing page for current rates.

View Pricing →

Start Building with Happy Horse 1.0

Get your API key and start generating cinematic AI video in minutes. Free tier included.

Try OnlineAPI Coming Soon

Free tier available · REST API · Webhook support

API FAQ

Quick Start

Start generating video with Happy Horse 1.0 in minutes.

curl -X POST https://api.topview.ai/v1/video/generate \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d {
    "model": "happy-horse-1.0",
    "prompt": "A horse galloping through a golden field at sunset",
    "resolution": "1080p",
    "audio": true
  }

Parameter

Type

Required

Description

model

string

Yes

Model ID. Use "happy-horse-1.0" for Happy Horse.

prompt

string

Yes

Text description of the video to generate.

image_url

string

URL of reference image for image-to-video generation.

resolution

string

Output resolution. Default: "1080p".

audio

boolean

Enable joint audio generation. Default: true.

webhook_url

string

URL to receive job completion callback.