API — Coming Soon

Happyhorse-1.0 API Access

Pay-as-you-go · No subscription · Use in your own app

The Happyhorse-1.0 REST API is coming. While direct happyhorse api access is in private preview, you can generate videos right now via the web — same model, same quality, pay only for what you use.

Use Happyhorse-1.0 Online — No API Key Needed

The happyhorse api key system is in development, but the model is live today. Buy credits, generate 4K video on the site, and download — full commercial license included. When the REST API launches, your credits carry over automatically.

01

Buy Credits

One-time payment, no subscription. Credits are shared across the web app, future happyhorse api calls, and the ComfyUI node.

02

Generate Video

Enter your prompt in the Happyhorse-1.0 Lab. Same model that will power the REST API — daVinci-MagiHuman architecture, native 4K.

03

Download & Ship

MP4 output with 100% commercial IP ownership. When the happy horse api endpoint goes live, plug in your key and automate the same workflow.

How the API Works

The Happyhorse-1.0 REST API follows a simple async request-poll model. Authenticate with your happyhorse api key, submit a job, and retrieve the output when ready. Below is a preview of the happyhorse-1.0 api integration.

01

Authenticate

Include your happyhorse api key in the Authorization header. Keys are scoped per workspace and rate-limited per plan.

02

Submit a Job

POST your prompt and parameters to the /v1/generate endpoint. The happy horse api endpoint returns a job_id immediately.

03

Poll for Status

GET /v1/jobs/{job_id} to check progress. When status is completed, the response includes a signed video URL valid for 24 hours.

04

Download & Use

Download the MP4 output or stream it directly. Credits are deducted only on successful generation — failed jobs are never charged.

curl — Submit a video generation job

bash
curl -X POST https://api.happyhorselab.net/v1/generate \
  -H "Authorization: Bearer hh_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lone astronaut walks across a red desert at golden hour, cinematic 4K",
    "resolution": "4K",
    "duration": 8,
    "motion_strength": 0.7,
    "fps": 24
  }'

Python — Full integration example

python
import requests
import time

API_KEY = "hh_xxxxxxxxxxxxxxxxxxxx"
BASE_URL = "https://api.happyhorselab.net/v1"

# Submit generation job
response = requests.post(
    f"{BASE_URL}/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "prompt": "A lone astronaut walks across a red desert at golden hour",
        "resolution": "4K",
        "duration": 8,
        "motion_strength": 0.7,
        "fps": 24,
    },
)
job_id = response.json()["job_id"]

# Poll until complete
while True:
    status = requests.get(
        f"{BASE_URL}/jobs/{job_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    ).json()
    if status["status"] == "completed":
        print("Video URL:", status["output_url"])
        break
    elif status["status"] == "failed":
        print("Generation failed:", status["error"])
        break
    time.sleep(5)

Pricing & Credits

Happyhorse API access runs on the same credit system as the site — no separate subscription, no seat fees. Credits purchased today work on the web app and will carry over to the happyhorse api pay as you go model at launch.

Standard

Starting from ~$0.10 / video

1080p, up to 8 s, standard queue. Ideal for prototyping and evaluating the happy horse ai video api.

Most Popular

Pro

Starting from ~$0.25 / video

Native 4K, up to 16 s, priority queue. Designed for production workloads — the happyhorse api pay as you go model at scale.

Enterprise

Custom pricing

Volume discounts, SLA guarantees, dedicated endpoints, and happyhorse api key management across teams.

Credits purchased on the site are fully interchangeable with future API credits. There is no separate happyhorse api pricing tier — you pay only for what you generate.

Credits never expire as long as your account remains active.

API Endpoints (Preview)

The Happyhorse-1.0 REST API exposes a focused set of endpoints for video generation and job management. Full happyhorse-1.0 api documentation will be published at launch.

POST/v1/generate

Submit a text-to-video or image-to-video generation job. Returns a job_id for polling.

ParameterTypeRequiredDescription
promptstringrequiredText description of the video.
resolutionstringoptional"1080p" (default) or "4K". 4K requires Pro credits.
durationintegeroptionalVideo length in seconds. Range: 2–16. Default: 8.
motion_strengthfloatoptionalMotion intensity 0.0–1.0. Default: 0.6.
fpsintegeroptionalFrames per second: 24 or 30. Default: 24.
seedintegeroptionalReproducibility seed. Omit for random.
GET/v1/jobs/{job_id}

Poll the status of a generation job. Returns status, progress, and output_url when complete.

GET/v1/credits

Check remaining happyhorse api credits balance and usage history.

GET/v1/models

List available models and their parameter ranges. Currently exposes happyhorse-1.0.

Example Response — Completed Job

json
{
  "job_id": "job_01HZ9X3K7VQWPN8S4TYJB6MDE",
  "status": "completed",
  "model": "happyhorse-1.0",
  "created_at": "2025-06-01T14:22:10Z",
  "completed_at": "2025-06-01T14:23:48Z",
  "credits_used": 25,
  "output_url": "https://cdn.happyhorselab.net/out/job_01HZ9X3K7VQWPN8S4TYJB6MDE.mp4",
  "output_url_expires_at": "2025-06-02T14:23:48Z",
  "metadata": {
    "resolution": "4K",
    "duration": 8,
    "fps": 24,
    "motion_strength": 0.7
  }
}

FAQ

Common questions about Happyhorse API access, credits, and integration.

1

How do I get a Happyhorse API key?

The happyhorse api key system is in private preview. In the meantime, use the web app on happyhorselab.net — same model, same quality. Buy credits on the pricing page and start generating immediately. API keys will be available in the dashboard when direct access launches.

2

Is Happyhorse-1.0 API compatible with ComfyUI?

Yes. The official Happyhorse ComfyUI custom node uses the same REST API under the hood. Credits purchased for the web app are interchangeable with the ComfyUI integration. See our /comfyui guide for setup details.

3

What are the rate limits?

Rate limits will depend on your credit plan. Standard access will start at 10 concurrent jobs and 500 requests per minute. Enterprise plans offer custom limits, dedicated endpoints, and SLA guarantees — contact us for happyhorse api enterprise pricing.

4

Is enterprise or white-label API access available?

Yes. Enterprise customers can request dedicated inference endpoints, volume credit packages, custom SLAs, and private model fine-tuning. Reach out via the pricing page and we'll follow up with a tailored plan.

5

Do Happyhorse API credits expire?

Credits purchased on happyhorselab.net do not expire as long as your account remains active (at least one login per 365 days). The same happyhorse api credits policy applies whether you use them via the web app, API, or ComfyUI node.

6

Which programming languages does the Happyhorse API support?

The Happyhorse-1.0 REST API is a standard HTTP API — any language works: Python, Node.js, Go, Ruby, PHP, Java, Rust, and more. Official SDKs for Python and TypeScript are planned for the launch. Until then, use any HTTP client with your happyhorse api key in the Authorization header.

Build with the #1 Video Model — Starting Today

Don't wait for the API. Use Happyhorse-1.0 online now, pay per credit, and your balance carries over automatically when the REST API launches.