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.
- Farklı hız / kalite seviyeleri için birden çok varyant
- Model skill dokümanları, şemaları ve kurulum notlarını içerir
- Uygulama odaklı kodlama workflow’larıyla çalışır
- Başarısız üretimler ücretlendirilmez
Tüm API varyantlarını karşılaştırın
| Variant | Billing | From | |
|---|---|---|---|
| happyhorse-1.0-i2v | second | $0.540 | Gör → |
| happyhorse-1.0-r2v | second | $0.540 | Gör → |
| happyhorse-1.0-t2v | second | $0.540 | Gör → |
| happyhorse-character | second | $0.480 | Gör → |
| happyhorse-edit-video | second | $0.480 | Gör → |
| happyhorse-image-to-video | second | $0.480 | Gör → |
| happyhorse-text-to-video | second | $0.480 | Gör → |
Uygulama geliştirme için HappyHorse skill’ini kurun
Model dokümanlarını, şemaları, fiyat notlarını ve kurulum adımlarını kod workspace’inize yükleyin.
# 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.
Model skill’den ilk sonuca dört adımda
Modeli seçin
Çıktı tipi, kalite eşiği ve gecikme hedefinize uygun model ve varyantı seçin.
Yapılandır
RunAPI anahtarınızı ayarlayın ve model skill’i kod workspace’inize kurun.
Geliştirin
Skill talimatlarını kullanarak model özelliğini uygulamanızın içine ekleyin.
Al
Task ID ile sorgulayın, destekleniyorsa stream edin veya webhook callback’i işleyin.
HappyHorse API nedir?
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.
HappyHorse API neden RunAPI üzerinden kullanılmalı
Tek kimlik doğrulama, tüm sağlayıcılar
Tek bir RunAPI anahtarı tüm kataloğu açar. Ayrı hesap yok, her entegrasyon için anahtar döndürme yok.
Birleşik fiyatlandırma ve faturalandırma
USD bazında çağrı başı fiyatlandırma, aylık faturalandırılır. Başarısız üretimler ücretlendirilmez.
Şemalı skill
Tipli şemalar ve kurulum notları model skill içinde paketlenir; uygulama doğru kontrattan başlar.
Sık sorulan sorular
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.
Hangi varyantla başlamalıyım?
Kalite beklentinizi karşılayan en uygun fiyatlı varyantı seçin. Çoğu ekip hızlı varyantla başlar ve üretimde pro sürüme geçer.
Ücretsiz bir katman var mı?
Yeni hesaplar her modelde ilk çağrıları ücretsiz alır. Sonrasında çağrı başına ödeme yaparsınız.
Sonuçları streaming olarak sunuyor musunuz?
Streaming desteklendiğinde RunAPI uçtan uca streaming sağlar.
Başarısız işlemler nasıl ücretlendirilir?
Başarısız üretimler ücretlendirilmez.
Çıktılar önbelleğe alınıyor mu?
Üretilen çıktılar saklanır ve görev ID’siyle geri alınabilir. Girdiler önbelleğe alınmaz.
Ticari kullanım yapabilir miyim?
Evet — bir model lisansı bunu açıkça kısıtlamadıkça ticari kullanım tüm varyantlarda dahildir; kısıtlamalar varyant sayfasında belirtilir.
Oran limitleri ne durumda?
Anahtar bazlı oran limitleri kullanım kademesine göre ölçeklenir. Güncel limitler için fiyatlandırma sayfasına bakın.
Sorunları nereye bildirebilirim?
Herkese açık GitHub reposunda bir issue açın veya destek ekibine e-posta gönderin.