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 cursor
HappyHorse 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.
- عدة إصدارات لمستويات مختلفة من السرعة / الجودة
- يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
- يعمل مع workflows موجهة لتطوير التطبيقات
- لا يتم احتساب رسوم على عمليات التوليد الفاشلة
قارن جميع إصدارات API
| Variant | Billing | From | |
|---|---|---|---|
| happyhorse-1.0-i2v | second | $0.540 | عرض → |
| happyhorse-1.0-r2v | second | $0.540 | عرض → |
| happyhorse-1.0-t2v | second | $0.540 | عرض → |
| happyhorse-character | second | $0.480 | عرض → |
| happyhorse-edit-video | second | $0.480 | عرض → |
| happyhorse-image-to-video | second | $0.480 | عرض → |
| happyhorse-text-to-video | second | $0.480 | عرض → |
ثبّت skill HappyHorse لتطوير التطبيقات
حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.
# Install the model skill for app development workflows
npx skills add runapi-ai/happyhorse -g
Install 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 إلى أول نتيجة في أربع خطوات
اختر النموذج
اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.
الإعداد
اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.
التنفيذ
استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.
الاستلام
استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.
ما هي 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.
لماذا تستخدم HappyHorse API عبر RunAPI
مصادقة واحدة لكل مزود
مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.
تسعير وفوترة موحّدان
تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.
Skill مع schemas
تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.
أسئلة شائعة
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.
أي نسخة ينبغي أن أبدأ بها؟
اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.
هل توجد خطة مجانية؟
تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.
هل تدعمون البث المباشر للنتائج؟
حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.
كيف يتم احتساب الرسوم عند الفشل؟
لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.
هل يتم تخزين المخرجات مؤقتًا؟
يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.
هل يمكنني الاستخدام تجاريًا؟
نعم — يشمل كل إصدار الاستخدام التجاري ما لم يقيّده ترخيص النموذج صراحةً، ويُشار إلى ذلك في صفحة الإصدار.
ماذا عن حدود المعدل؟
تتدرج حدود المعدل لكل مفتاح وفق فئة الاستخدام. راجع صفحة الأسعار للاطلاع على الحدود الحالية.
أين يمكنني الإبلاغ عن المشاكل؟
افتح issue في مستودع GitHub العام أو راسل الدعم عبر البريد الإلكتروني.