استخدم HappyHorse 1.1 عبر Rivya Public API v1 مع معرف النموذج happyhorse-1-1، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والأرصدة، وأمثلة الاستجابة.

متاح عبر APIالنص أو URL جاهز؛ تستخدم أوضاع المراجع Files APIفيديو

معرف نموذج API

happyhorse-1-1

المدخلات

text, file

Files API

مطلوب لأوضاع المراجع

الأرصدة الأساسية

per_output_second · 720p=22.5 · 1080p=29 · ⌈total⌉

القدرة

فيديو

الفوترة

METERED

حد prompt

5000 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	happyhorse-1-1	استخدم معرف نموذج API وهو happyhorse-1-1.
prompt	string	لا	-	الحد الأقصى لهذا النموذج هو 5000 حرفًا.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
resolution	select	لا	1080p	-	720p, 1080p	تحدد الدقة المختارة معدل الأرصدة لكل ثانية.
aspect_ratio	select	لا	16:9	-	16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9	تستخدم للعمليات المعتمدة على الموجّه وحده أو على مراجع متعددة؛ وتتبع العملية ذات الصورة الواحدة إطارها الأول.
duration	number	لا	5	min 3 / max 15 / step 1	-	اختر مدة إخراج بعدد صحيح من 3 إلى 15 ثانية.

سياسة الرفع

ارفع ملفات المراجع أولا، ثم ضع URL وduration token اللذين تم إرجاعهما داخل params.referenceMediaItems.

قاعدة المرجع

الإطار الأول أو الصور المرجعية: ارفع صورة واحدة بتنسيق JPEG أو PNG أو WebP لتحريك الإطار الأول، أو من 2 إلى 9 صور لفيديو موجّه بالمراجع. يمكن أن يصل حجم كل ملف إلى 20 MB.

الحد الأقصى للملفات

أنواع الملفات المقبولة

image

Duration token

ينبغي أن تحمل مراجع الفيديو والصوت durationToken من /api/v1/files عندما يكون التحقق من المدة مطلوبا.

kind	الحد الأقصى للحجم	أنواع MIME
image	20 MB	image/jpeg, image/png, image/webp

الطلب الأدنى

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5
  }
}

طلب بملف مرجعي

{
  "model": "happyhorse-1-1",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

استجابة الإنشاء

تعيد نقطة نهاية الإنشاء معرف مهمة عامًا. استعلم عن نقطة نهاية الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_happyhorse_1_1_example",
  "status": "queued",
  "model": "happyhorse-1-1",
  "reserved_credits": 145,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

تتطلب بعض الأوضاع رفع مراجع عبر Files API.

دمج API لنموذج HappyHorse 1.1