HappyHorse API
Text, image, and edit-video generation with 720p and 1080p output, duration control, first-frame image support, ordered reference images for character-guided clips, and source-video editing.
curl -X POST https://runapi.ai/api/v1/happyhorse/image_to_video \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-text-to-video",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night."
}'import { HappyhorseClient } from "@runapi.ai/happyhorse";
const client = new HappyhorseClient();
const result = await client.imageToVideo.run({
model: "happyhorse-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Happyhorse\HappyhorseClient;
$client = new HappyhorseClient();
$result = $client->imageToVideo->run([
'model' => 'happyhorse-text-to-video',
'image_url' => 'https://cdn.runapi.ai/public/samples/image.jpg',
'prompt' => 'Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night.',
]);require "runapi/happyhorse"
client = RunApi::Happyhorse::Client.new
result = client.image_to_video.run(
model: "happyhorse-text-to-video",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Generate a 5-second 1080p cinematic clip of a paper horse galloping through a miniature cardboard city at night."
)npx skills add runapi-ai/happyhorse -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorHappyHorse creates text, image, and edit-video clips with selectable 720p or 1080p output, deterministic seed control, first-frame image guidance, ordered reference-image guidance for the character model, and source-video edit instructions.
- Meerdere varianten voor verschillende snelheid-/kwaliteitsniveaus
- Modelskill bevat docs, schema's en setupnotities
- Werkt met appgerichte codeerworkflows
- Mislukte generaties worden niet in rekening gebracht
Vergelijk alle API-varianten
| Variant | Billing | From | |
|---|---|---|---|
| happyhorse-1.0-i2v | second | $0.540 | Bekijken → |
| happyhorse-1.0-r2v | second | $0.540 | Bekijken → |
| happyhorse-1.0-t2v | second | $0.540 | Bekijken → |
| happyhorse-character | second | $0.480 | Bekijken → |
| happyhorse-edit-video | second | $0.480 | Bekijken → |
| happyhorse-image-to-video | second | $0.480 | Bekijken → |
| happyhorse-text-to-video | second | $0.480 | Bekijken → |
Installeer de HappyHorse skill voor appontwikkeling
Laad modeldocs, schema's, prijsnotities en setupstappen in je codeworkspace.
# Install the model skill for app development workflows
npx skills add runapi-ai/happyhorse -gInstall the HappyHorse skill for this app: 1. Add runapi-ai/happyhorse with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Van modelskill naar eerste resultaat in vier stappen
Kies het model
Kies het model en de variant die passen bij je outputtype, kwaliteitslat en latencydoel.
Configureren
Stel je RunAPI-key in en installeer de modelskill in je codeworkspace.
Bouwen
Gebruik de skill-instructies om de modelfeature in je applicatie toe te voegen.
Ontvangen
Poll op task-ID, stream wanneer ondersteund of verwerk de webhook-callback.
Wat is de HappyHorse API?
HappyHorse belongs to the Alibaba catalog on RunAPI and exposes canonical text-to-video, image-to-video, and edit-video capabilities across API, SDK, CLI, Bruno, and docs surfaces.
Waarom de HappyHorse API via RunAPI gebruiken
Eén auth, elke provider
Met één RunAPI-sleutel ontgrendel je de hele catalogus. Geen aparte accounts, geen sleutelrotatie per integratie.
Uniforme prijzen & billing
Prijs per call in USD, maandelijks gefactureerd. Mislukte generaties worden niet in rekening gebracht.
Skill met schema's
Getypeerde schema's en setupnotities zitten in de modelskill, zodat implementatie start vanuit het juiste contract.
Veelgestelde vragen
What can HappyHorse create?
HappyHorse offers text-to-video from a prompt, character-guided text-to-video from a prompt plus ordered reference images, image-to-video from one first-frame image, and edit-video from one source clip.
What resolutions does HappyHorse support?
All HappyHorse video endpoints support 720p and 1080p output. 1080p is the default, while 720p is useful for drafts and social clips.
How long can HappyHorse videos be?
HappyHorse video generation endpoints support integer durations from 3 to 15 seconds, while edit-video accepts a 3-60 second source video.
How does image-to-video use the input image?
Image-to-video accepts exactly one public image URL and treats it as the first frame before generating motion from the prompt and settings.
How does the character model use reference images?
The character model accepts 1-9 public image URLs on the text-to-video endpoint; their order maps to character1, character2, and later references in the prompt.
How does edit-video use the source video?
Edit-video accepts one public MP4 or MOV source video, an edit instruction, and up to 5 optional reference images.
Can I reproduce a HappyHorse result?
You can pass a seed to make generation more deterministic for the same prompt, media, and resolution.
Met welke variant moet ik beginnen?
Kies de goedkoopste variant die aan je kwaliteitsnorm voldoet. De meeste teams beginnen met de snelle variant en stappen over op pro voor productie.
Is er een gratis tier?
Nieuwe accounts krijgen de eerste calls gratis op elk model. Daarna betaal je per call.
Streamen jullie resultaten?
Waar streaming beschikbaar is, streamt RunAPI end-to-end.
Hoe worden mislukkingen gefactureerd?
Mislukte generations worden niet in rekening gebracht.
Worden outputs gecachet?
Gegenereerde outputs worden opgeslagen en zijn op te vragen via task-ID. Inputs worden niet gecachet.
Mag ik het commercieel gebruiken?
Ja — commercieel gebruik is inbegrepen voor elke variant, tenzij een modellicentie het expliciet beperkt. Dat staat aangegeven op de variantpagina.
Hoe zit het met rate limits?
Rate limits per key schalen mee met je usage tier. Zie de prijzenpagina voor de actuele limieten.
Waar kan ik problemen melden?
Open een issue in de publieke GitHub-repo of mail support.