Kling 3.0 Turbo

Kling 3.0 Turbo هو نموذج فيديو من عائلة Kling 3.0 لدى Kuaishou. يصنع الطلب الواحد مقطعًا مدته 3–15 ثانية بالصوت من موجّه، أو من موجّه مع إطار أول، بدقة 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-3-0-turbo",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. 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 في شفرة تعمل على الخادم.

المعاملات

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

من صورة إلى فيديو

مرّر إطارًا أول في first_frame_image وصِف ما يحدث بعده في prompt. يبدأ المقطع بالإطار ويأخذ شكله، لذا لا يُستخدم aspect_ratio.

{
  "model": "kling-3-0-turbo",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze.",
  "first_frame_image": "https://example.com/frame.png",
  "resolution": "1080p",
  "duration": 5
}

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

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

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

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

cost = duration × rate per second for the resolution

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

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

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

{"id": "task_...", "model": "kling-3-0-turbo", "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-turbo",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689710,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

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

الأخطاء

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

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

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

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

نصائح

• صِف الموضوع والمكان وحركة الكاميرا والإضاءة بجملة واحدة لكل منها؛ والنموذج يتبع لغة الكاميرا مثل "slow push-in" (اقتراب بطيء) و"low angle" (زاوية منخفضة).
• أعدّ مسودة بدقة 720p، ثم ولّد اللقطة النهائية بدقة 1080p بالطلب نفسه.
• مع الإطار الأول، صِف ما يتحرك فقط: فالإطار يحدّد المشهد مسبقًا.
• أضف no text, no logos لإبعاد العلامات المختلقة عن الإطار.

مواضيع ذات صلة

• Playground وأسعار Kling 3.0 Turbo
• مرجع Kling 3.0 API
• تنزيل OpenAPI
• Markdown قابل للنسخ