الانتقال إلى المحتوى الرئيسي
POST
/
video
/
generations
إرسال مهمة فيديو
curl --request POST \
  --url https://api.orcarouter.ai/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling/kling-v3-omni",
  "prompt": "<string>",
  "image": "<string>",
  "metadata": {}
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "model": "<string>",
  "progress": 50,
  "created_at": 123
}

التفويضات

​
Authorization
string
header
مطلوب

تبدو مفاتيح OrcaRouter API على شكل sk-orca-.... مرّرها في ترويسة Authorization: Bearer sk-orca-....

الجسم

application/json

اختر المتغيّر المطابق لبادئة model الخاصة بك:

  • kling/... ← Kling video request
  • byteplus/... ← Seedance video request
​
model
enum<string>
مطلوب

نموذج فيديو Kling (الاسم المعروض للعميل مع بادئة المساحة الاسمية kling/). يتم تحديد نقطة النهاية التي تخدمها Kling فعلًا (text2video / image2video / omni-video) وفقًا لحقول metadata التي تمرّرها، وليس وفقًا لاسم النموذج الذي تختاره — لكن فقط kling/kling-video-o1 و kling/kling-v3-omni يقبلان حقول المراجع متعددة المصادر (image_list / video_list).

الخيارات المتاحة:
kling/kling-v2-master,
kling/kling-v2-1-master,
kling/kling-v2-5-turbo,
kling/kling-v2-6,
kling/kling-v3,
kling/kling-video-o1,
kling/kling-v3-omni
مثال:

"kling/kling-v3-omni"

​
prompt
string
مطلوب

مطلوب. ترفض Kling المطالبات الفارغة أو التي تحتوي على مسافات بيضاء فقط.

​
image
string

صورة اللقطة الأولى الاختيارية لتحويل الصورة إلى فيديو (URL أو data URI بصيغة base64). تكامل المعلومات مع metadata.image_tail.

​
metadata
object

حقيبة معاملات بأي شكل تحترمها Kling.

عامة (لجميع النقاط):

  • mode (string): std (720P) / pro (1080P) / 4k. خاصية 4k متاحة فقط على kling/kling-v3 و kling/kling-v3-omni. الافتراضي std لتحويل النص/الصورة إلى فيديو، و pro لـ Omni-Video.
  • aspect_ratio (string): 16:9 / 9:16 / 1:1.
  • duration (string): الطول بالثواني، الافتراضي "5". يقبل kling/kling-v3-omni و kling/kling-v3 القيم "3"-"15"؛ تقبل عائلة v2 و kling/kling-video-o1 القيم "5" أو "10".

تحويل النص إلى فيديو والصورة إلى فيديو فقط (ليس Omni-Video):

  • negative_prompt (string): أشياء يجب تجنّبها. حد أقصى 2500 حرفًا.
  • cfg_scale (number): النطاق [0, 1]، الافتراضي 0.5. الأعلى = التزام أصرم بالمطالبة. غير مدعوم على نماذج v2.x.
  • image_tail (string): صورة اللقطة الأخيرة لتحويل الصورة إلى فيديو بصورة أولى/أخيرة.

مرجع متعدد المصادر (نقطة Omni فقط، kling/kling-video-o1 / kling/kling-v3-omni):

  • image_list (array): [{image_url, type}] — مرجع متعدد الصور. أشر إلى الصور في المطالبة بـ <<<image_1>>> إلخ.
  • video_list (array): [{video_url, refer_type, keep_original_sound}]. على kling/kling-v3-omni محدودة بـ 3-10 ثوانٍ ووضع std/pro (وليس 4K).

ميزات متقدمة (تعتمد على النموذج — انظر Capability Map):

  • multi_shot (bool) + shot_type (customize / intelligence)
    • multi_prompt ([{index, prompt, duration}]): وضع تعدد اللقطات. متاح على kling/kling-v3 و kling/kling-v3-omni.
  • sound (string): "on" / "off" — صوت أصلي. متاح على kling/kling-v3 و kling/kling-v3-omni (أي وضع)، و kling/kling-v2-6 (وضع pro فقط).
  • watermark_info (object): {enabled: bool}. عام.

الاستجابة

200 - application/json

تم قبول المهمة (غير متزامن — استعلم عبر /v1/video/generations/{task_id})

استجابة إرسال على طريقة OpenAI. تُرجع بواسطة POST /v1/video/generations (والاسم البديل المتماثل لـ OpenAI POST /v1/videos).

​
id
string

معرّف المهمة. نفس قيمة task_id (محتفظ به للعملاء القدامى).

​
task_id
string
​
object
enum<string>
الخيارات المتاحة:
video
​
model
string

اسم النموذج كما أرسله العميل (الاسم المستعار / بادئة المساحة الاسمية محفوظة، وليس الاسم المُحلّل في المصدر).

​
status
enum<string>

تكون دائمًا queued عند الإرسال الناجح.

الخيارات المتاحة:
queued
​
progress
integer
النطاق المطلوب: 0 <= x <= 100
​
created_at
integer

طابع زمني Unix عند إرسال المهمة.