Quick Start

Before You Start

To use HappyHorse in production, you need:

• a registered account
• an approved workflow tier
• an API key or enabled dashboard workspace

Step 1: Create Your Account

Create an account from the public site and choose the pricing path that matches your workflow.

Step 2: Request Access

HappyHorse enables workflows by account tier. During onboarding, confirm:

• your main use case
• whether you need text-to-video, image-to-video, or both
• expected monthly generation volume
• whether you need multilingual lip sync support

Step 3: Get Credentials

Approved accounts receive an API key for enabled environments.

curl -X GET https://happyhorse.app/api/ping

Step 4: Send Your First Request

curl -X POST https://api.happyhorse.app/v1/videos/text-to-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1",
    "prompt": "A premium perfume commercial in a black studio, slow dolly in, floating mist, cinematic highlights",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Step 5: Track Job Status

All generation endpoints return a job id. Poll that id until the output becomes available or the request fails.

Next

• Read Authentication
• Review API Reference
• Compare Models