مستندات UlazAI

الصورة والفيديو APIs

استوديو الفيديو API

التسعير لوحة القيادة استوديو الصور

بريد /api/v1/video-studio/generate/

نقطة النهاية لتوليد الفيديو الكنسي

استخدم Video Studio لجميع نماذج الفيديو الحالية. تدعم نقطة النهاية هذه تحويل النص إلى فيديو، ومن صورة إلى فيديو، وسير العمل الخاص بالنموذج مثل ريمكس فيديو.

بالنسبة للتكاملات الديناميكية، قم بإحضار إمكانات النموذج من /api/v1/models/video/ قبل إرسال حمولات الجيل.

تتضمن مسارات Video Studio الحديثة seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2v، و happyhorse_videoedit.

التوثيق: إرسال Authorization: Bearer YOUR_API_KEY على كل طلب.

استطلاع مع /api/v1/video-studio/status/{job_id}/ وتحميل الأخيرة وظائف من /api/v1/video-studio/history/.

طلب العقد

الميدان	يكتب	مطلوب	ملاحظات
`model_slug`	سلسلة	نعم	يجب أن يتطابق مع سبيكة طراز Video Studio المسجلة
`prompt`	سلسلة	عادة	مطلوب لمعظم النماذج. يمكن أن يبدأ وضع القصة المصورة بالصور فقط.
`aspect_ratio`	سلسلة	لا	يجب أن تكون إحدى نسب العرض إلى الارتفاع للنموذج المحدد
`duration_seconds`	عدد صحيح	لا	يجب أن يتطابق مع المدة المسموح بها للنموذج. يستخدم التحكم في الحركة طول مقطع الحركة للتسعير.
`quality_mode`	سلسلة	لا	مطلوبة عندما يحدد النموذج أوضاع الجودة
`input_image_urls`	صفيف [سلسلة]	نموذج محدد	تستخدم لنماذج الصورة إلى الفيديو. تتطلب بعض النماذج عنوان URL واحدًا على الأقل.
`input_video_urls`	صفيف [سلسلة]	نموذج محدد	يتم استخدامه بواسطة ريمكس الفيديو ومسارات الفيديو المصدر مثل `wan_2_6_v2v`, `kling_3_0_motion_control`, `video_lip_sync`، و `happyhorse_videoedit`.
`seedance_mode`	سلسلة	سيدان 2 فقط	استخدم `text_to_video`, `first_frame`, `first_last_frame`أو `multimodal`.
`first_frame_url`, `last_frame_url`	سلسلة	سيدان 2 فقط	يُستخدم في وضعي Seedance 2 للإطار الأول والإطار الأول + الأخير. عناوين URL العامة و `asset://` يتم قبول معرفات.
`reference_image_urls`, `reference_video_urls`, `reference_audio_urls`	صفيف [سلسلة]	نموذج محدد	يستخدم Seedance 2 صفائف مرجعية متعددة الوسائط. الطرق التي تعتمد على الصوت مثل `video_lip_sync` و `omnihuman_1_5` استخدام `reference_audio_urls` للخطاب الهدف أو التعليق الصوتي. عناوين URL العامة و `asset://` يتم قبول المعرفات حيث يدعمها النموذج المحدد.
`character_orientation`	سلسلة	نموذج محدد	التحكم بالحركة فقط. استخدم `video` لمتابعة اتجاه مقطع الحركة أو `image` للحفاظ على تأطير الشخصية التي تم تحميلها، بمدة تتراوح من 3 إلى 15 ثانية.
`sound`	منطقية	لا	يُستخدم فقط في الطرز التي تدعم الصوت
`return_last_frame`, `web_search`	منطقية	سيدان 2 فقط	علامات Seedance 2 الاختيارية لإرجاع الإطار الأخير وتمكين البحث على الويب من جانب النموذج.
`prompt_directory_optin`	منطقية	لا	ينطبق خصم الدليل فقط على عائلات نموذجية مختارة

للحصول على لقطات من شخص حقيقي في Seedance 2، استخدم دليل أصول UlazAI Seedance 2 وتمرير عاد asset:// معرف. قد تفشل الملفات الأولية المباشرة.

محدد النموذج

اختر نموذجًا لفحص الإمكانات وإنشاء مقتطفات الطلب تلقائيًا.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

المحرك: Seedance 2.5

نسب الارتفاع: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

الفترات: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 ثواني

أوضاع الجودة: 480p, 720p, 1080p

المدخلات: نص , صورة فيديو

الاعتمادات: 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 more

مقتطفات الطلب المباشر

تتبع المقتطفات أدناه الإعداد المسبق للنموذج المحدد.

الضفيرة (مفتاح API)

جافا سكريبت (جلب)

بايثون (الطلبات)

مقتطفات استطلاع الحالة

حالة الاستطلاع بواسطة job_id حتى completed أو failed.

الضفيرة

جافا سكريبت (جلب)

بايثون (الطلبات)

أمثلة على الاستجابة

النجاح

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

خطأ في التحقق

{
  "success": false,
  "error": "Invalid duration for this model"
}

الاعتمادات غير كافية

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

نقطة نهاية الفيديو ذات المفتاح API (قديمة)

إذا كنت بحاجة إلى مكالمات فيديو تعتمد على مفتاح API، فاستخدم /api/v1/generate/video/. يدعم هذا المسار أ مجموعة نماذج محدودة وتم توثيقها ضمن تعيينات الفيديو القديمة.

افتح تعيين الفيديو القديم فتح سير عمل الحالة فتح مصفوفة نموذج الفيديو