Kling 3.0

ولّد مقاطع Kling 3.0 مدتها 3–15 ثانية من نص أو من إطار أول وأخير، مع صوت أصلي اختياري، وموجّهات متعددة اللقطات، وعناصر قابلة لإعادة الاستخدام، وتُسلَّم عبر مهمة.

Kling 3.0 هو نموذج توليد الفيديو من Kuaishou. يصنع الطلب الواحد مقطعًا مدته 3–15 ثانية من موجّه، أو من إطار أول وإطار أخير اختياري، بثلاثة أوضاع للجودة (std وpro و4K)، مع صوت أصلي عندما تطلبه. ويمكن أن يكون المقطع أيضًا سلسلة من خمس لقطات كحد أقصى، لكل منها موجّهها وطولها. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، ثم اقرأ الفيديو المكتمل من المهمة. وتُرسل الصور على شكل روابط URL.

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

معرّف النموذج	المدخلات	الأوضاع	الطول
`kling-3-0`	نص، وإطار أول وأخير، وعناصر	`std`، `pro`، `4K`	3–15 ثانية

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

مثال سريع

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

نقطة النهاية

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

الترويسة	القيمة
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

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

المعاملات

الحقل	النوع	القيمة الافتراضية	ملاحظات
`model`	string	مطلوب	`kling-3-0`
`prompt`	string	مطلوب للقطة الواحدة	حتى 2,500 حرف. اختياري في وضع اللقطات المتعددة.
`image_urls`	مصفوفة روابط URL	لا يوجد	حتى صورتين: الأولى هي الإطار الأول، والثانية الإطار الأخير. ومن دون صور يكون المقطع من نص إلى فيديو.
`mode`	enum	`pro`	`std` أو `pro` أو `4K` (بحرف K كبير).
`duration`	integer	`5`	3–15 ثانية.
`aspect_ratio`	enum	`16:9`	`16:9` أو `9:16` أو `1:1`.
`sound`	boolean	`false`	يولّد صوتًا أصليًا مع الفيديو.
`multi_shots`	boolean	`false`	يبني المقطع من اللقطات الواردة في `multi_prompt`.
`multi_prompt`	array	لا يوجد	حتى 5 لقطات، كل منها `{"prompt", "duration"}`: موجّه لا يتجاوز 500 حرف وعدد صحيح من الثواني من 1 إلى 12. مطلوب عندما تكون `multi_shots` بقيمة `true`.
`kling_elements`	array	لا يوجد	حتى 3 عناصر، كل منها `{"name", "description", "element_input_urls"}` مع 2–4 روابط URL لصور.

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

المقاطع متعددة اللقطات

اضبط multi_shots على true وصِف كل لقطة في multi_prompt. يجب أن يكون مجموع مدد اللقطات 3–15 ثانية؛ وهذا المجموع هو طول المقطع، ولا يُستخدم duration. ويمكن حذف prompt أو استخدامه لما تشترك فيه كل اللقطات.

{
  "model": "kling-3-0",
  "mode": "pro",
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "A red paper boat on a calm pond at sunrise, wide shot", "duration": 3},
    {"prompt": "The boat drifts under a small wooden bridge, low angle", "duration": 3}
  ]
}

العناصر

العنصر موضوع يحافظ النموذج على ثباته عبر المقطع: شخص أو منتج أو شخصية. أعطه name وdescription قصيرًا و2–4 صور له، ثم اذكره باسمه في الموجّه (مثل @hero).

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

مدخلات الوسائط

كل صورة هي رابط ⁦HTTP(S)⁩ عام. ولا تُقبل روابط data URI بصيغة base64: ارفع الملف إلى تخزينك الخاص ومرّر رابطه. استخدم صور JPG أو PNG لا يتجاوز حجمها 10 MB.

عوامل التكلفة

راجع قسم أسعار النموذج للاطلاع على الأسعار الحالية. يُحتسب Kling 3.0 لكل ثانية من الفيديو، بسعر يحدّده الوضع وتفعيل sound من عدمه:

billed seconds = duration                      (single shot)
billed seconds = Σ multi_prompt[].duration     (multi_shots: true)
cost = billed seconds × rate per second

تُعرف الثواني المحتسبة عند قبول الطلب، لذا فالمبلغ المحجوز هو المبلغ المحتسب. اطّلع على الرسوم النهائية في سجل استخدام حسابك. والمهام الفاشلة لا تُحتسب.

بنية المخرجات

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

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

جلب المهمة

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

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

المهمة المكتملة

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

في اختباراتنا، عاد مقطع std مدته 3 ثوانٍ بصيغة ⁦MP4 (H.264)⁩ بأبعاد ⁦1280 × 720⁩، وعاد مقطع pro مدته 5 ثوانٍ مع sound بأبعاد ⁦1920 × 1080⁩ مع مسار صوتي، كلٌّ منهما في نحو دقيقتين إلى ثلاث دقائق.

الأخطاء

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

راجع فهرس الأخطاء المشترك للاطلاع على الرموز وحالات HTTP وإرشادات إعادة المحاولة.

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

إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.

نصائح

صِف الموضوع والمكان وحركة الكاميرا والإضاءة بجملة واحدة لكل منها؛ يتبع Kling لغة الكاميرا مثل "slow push-in" (اقتراب بطيء) و"low angle" (زاوية منخفضة).
أعدّ مسودة بوضع std، ثم ولّد اللقطة النهائية بوضع pro أو 4K بالطلب نفسه.
استخدم إطارًا أول وإطارًا أخيرًا للتحكم في بداية اللقطة ونهايتها.
قسّم المشهد إلى لقطات باستخدام multi_prompt بدلًا من وصف عدة قطعات في موجّه واحد.
أضف no text, no logos لإبعاد العلامات المختلقة عن الإطار.