Kling 4.0

⁦Kling 4.0⁩ هو نموذج الفيديو من ⁦Kuaishou⁩ المُعلن عنه في سبتمبر ⁦2026⁩. معرّف نموذج واحد يغطي خمسة أوضاع: فيديو من نص، فيديو من صورة مع حتى ⁦10⁩ إطارات، توليد قائم على المرجع من صور وفيديوهات وصوت، تعديل الفيديو، وتمديد الفيديو. كل مقطع هو ⁦3⁩–⁦30⁩ ثانية بدقة ⁦720p⁩ أو ⁦1080p⁩ مع صوت ستيريو. أرسل الطلب، احتفظ بمعرّف المهمة المُرجع، واقرأ الفيديو المنتهي من المهمة. تذهب الملفات الإعلامية كـ روابط ⁦URL⁩.

معرّفات النموذج

انظر صفحة النموذج للحصول على الأسعار الحالية.

مثال سريع

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

نقطة النهاية

POST https://api.seedrouter.ai/v1/videos/generations

الاستجابة هي مهمة ({"id": "task_...", "status": "processing"}), وليس الفيديو المنتهي. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. احتفظ بمفاتيح ⁦API⁩ في كود من جانب الخادم.

المعاملات

كل مقطع يأتي مع صوت ستيريو؛ لا يوجد مفتاح صوت. لا يوجد حقل mode أو negative_prompt أو watermark أو متعدد اللقطات. المخطط صارم: الحقول غير المعروفة مرفوضة بدلًا من تجاهلها. callback_url غير متاح؛ استعلم المهمة بدلًا من ذلك.

الأوضاع

الوضع يتابع الملفات الإعلامية التي تُرسلها وomni_reference_task_type:

الإطارات والملفات الإعلامية المرجعية لا يمكن دمجهما في طلب واحد. بجانب فيديوهات المرجع أو الصوت، image_urls تُقرأ كصور مرجعية فقط مع omni_reference_task_type: "reference"؛ استخدم أدوار reference_image بخلاف ذلك. video_url بدون edit أو extend مرفوض.

إطارات مفتاحية

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

مرجع

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the beach with the camera movement of @Video1",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/camera.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

تعديل

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

يجب أن يكون فيديو الإدخال على الأقل ⁦3⁩ ثوانٍ؛ فقط أول ⁦30⁩ ثانية منها تُستخدم. بدون duration، الإخراج يتابع فيديو الإدخال.

تمديد

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

التمديد يستمر من الإطار الأخير لفيديو الإدخال ويرجع الأصلي زائد الجزء الجديد. أضف last_frame_image لاختيار حيث ينتهي.

مدخلات الملفات الإعلامية

الصور والفيديوهات والصوت هي روابط ⁦HTTP(S)⁩ عامة. لا تُقبل بيانات ⁦base64⁩: احرفع الملفات إلى تخزينك الخاص وأرسل روابطها. الصور والفيديوهات والصوت مجموعًا أقصى ⁦15⁩ ملف مرجعي.

أبعاد الأسعار

تحقق من قسم أسعار النموذج للحصول على الأسعار الحالية. يُحتسب ⁦Kling 4.0⁩ لكل ثانية من الفيديو، بسعر تحدده الدقة:

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

input هو الطول المُجمّع لفيديوهات الإدخال، مُقرّب لثوانٍ كاملة وحدّ أقصى ⁦30⁩. يُقاس عند قبول الطلب، لذا المبلغ المحتفظ به هو المبلغ المحتسب. فيديو لا يمكن قراءة طوله مرفوض قبل احتساب أي شيء. مثال: تعديل فيديو ⁦5.2⁩ ثانية إلى نتيجة ⁦3⁩ ثوانٍ يحتسب ⁦3⁩ + ⁦6⁩ = ⁦9⁩ ثواني. المهام الفاشلة لا تُحتسب.

مخطط الإخراج

الإرسال يرجع المهمة:

{"id": "task_...", "model": "kling-4-0", "status": "processing", "created_at": 1789689600}

احصل على المهمة

GET https://api.seedrouter.ai/v1/tasks/{task_id}

استعلم كل ⁦10⁩–⁦20⁩ ثانية حتى تكون status هي completed أو failed. مهلة شبكة أثناء الاستعلام لا تعني فشل التوليد: احتفظ بمعرّف المهمة واستأنف فحصها. لا تنشئ مهمة أخرى لفحص التقدم.

مهمة مكتملة

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689800,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

في اختباراتنا مقاطع ⁦720p⁩ ⁦3⁩ ثوانٍ عادت كـ ⁦MP4⁩ (⁦H.264⁩) بـ ⁦1280⁩ × ⁦720⁩ مع مسار ⁦AAC⁩ ستيريو، ⁦2⁩ دقيقة ⁦41⁩ ثانية إلى ⁦4⁩ دقائق ⁦22⁩ ثانية بعد الإرسال. فيديو ممدد ⁦5.2⁩ ثانية عاد ⁦8.1⁩ ثواني طويل.

الأخطاء

الطلبات المرفوضة قبل إنشاء مهمة ترجع خطأ ⁦HTTP⁩ برقم كائن error وليس لها احتسابات. مهمة تفشل بعد القبول ترجع ⁦HTTP 200⁩ عند الاستعلام، مع status: "failed" وكائن error.

انظر كتالوج الأخطاء المشترك للأكواد والحالات والإرشادات.

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

إذا انتهت المهلة بالإرسال نفسه، تحقق من مهامك قبل الإرسال مرة أخرى: قد يكون الطلب الأول قد تم قبوله.

نصائح

• صِف الموضوع والمكان وحركة الكاميرا والضوء والصوت؛ صوت المقطع يتابع الموجّه.
• اعمل مسودة بـ 720p، ثم اجعل اللقطة النهائية بـ 1080p مع نفس الطلب.
• أعطِ مقاطع أطول إطارات مفتاحية لذا يتحرك المشهد حيث تريده.
• أضف no text, no logos لإبعاد العلامات المخترعة.

ذات صلة

• صفحة Kling 4.0 والأسعار
• مرجع API Kling 3.0
• تنزيل OpenAPI
• Markdown قابلة للنسخ