Kling 4.0 Flash

⁦Kling 4.0 Flash⁩ هو النموذج الأصغر في عائلة ⁦Kling 4.0⁩ من ⁦Kuaishou⁩. على ⁦SeedRouter⁩، يدعم تحويل النص إلى فيديو والتوليد القائم على المراجع: حتى ⁦10⁩ صور مرجعية وحتى ⁦5⁩ فيديوهات مرجعية وحتى ⁦7⁩ عناصر (موضوعات مسمّاة تُنشأ من ⁦2–4⁩ صور أو فيديو قصير واحد)، يُذكر كل منها في الموجّه. كل مقطع مدته ⁦3–20⁩ ثانية بدقة ⁦720p⁩ مع صوت. أرسل الطلب، واحتفظ بمعرّف المهمة المُرجع، واقرأ الفيديو المنتهي من المهمة. تُرسل الملفات الإعلامية كروابط ⁦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-flash",
    "prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

نقطة النهاية

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

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

المعاملات

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

الإشارات

كل ملف أو عنصر مرجعي ترسله اختياري؛ ومن دونها يكون الطلب تحويلًا من نص إلى فيديو فقط. عندما ترسل ملفات أو عناصر مرجعية، أشِر إليها في الموجّه:

يجب أن تشير كل ⁦@⁩ متبوعة بحرف أو رقم أو شرطة سفلية أو محرف صيني إلى ملف أو عنصر مرجعي لهذا الطلب باسمه، وإلا يُرفض الطلب قبل احتساب أي شيء. تُطابق الأسماء بدءًا بالأطول ومن دون تمييز بين الأحرف الكبيرة والصغيرة. لا يمكن أن يتصل اسم ينتهي بحرف أو رقم أو شرطة سفلية مباشرةً بحرف أو رقم أو شرطة سفلية أخرى: تُرفض ⁦@image_12⁩ عند وجود صورة واحدة؛ اكتب ⁦@image_1 2⁩ أو ⁦@image_1,⁩.

مجموع الفيديوهات المرجعية وعناصر الفيديو لا يتجاوز ⁦5⁩، ومجموع الصور والفيديوهات والعناصر لا يتجاوز ⁦15⁩.

{
  "model": "kling-4-0-flash",
  "prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
  "image_urls": ["https://example.com/dancer.png"],
  "video_urls": ["https://example.com/routine.mp4"],
  "keep_original_sound": false,
  "duration": 8
}

العناصر

العنصر هو موضوع مسمّى يمكنك إعادة استخدامه في الموجّه. يوجد نوعان:

تتكون الأسماء من ⁦1–20⁩ حرفًا أو رقمًا أو شرطة سفلية أو محرفًا صينيًا، وتكون فريدة من دون تمييز بين الأحرف الكبيرة والصغيرة. الأسماء ⁦image_N⁩ و⁦video_N⁩ و⁦keyframe_N⁩ و⁦object_N⁩ و⁦audio_N⁩ و⁦first_frame⁩ و⁦last_frame⁩ محجوزة.

{
  "model": "kling-4-0-flash",
  "prompt": "@Mira opens the shop door and greets the morning crowd",
  "elements": [
    {
      "name": "Mira",
      "image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
      "tag": "character",
      "description": "baker in a flour-dusted apron"
    }
  ],
  "aspect_ratio": "9:16",
  "duration": 6
}

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

الصور والفيديوهات والصوت هي روابط ⁦HTTP(S)⁩ عامة. لا تُقبل معرّفات ⁦URI⁩ لبيانات ⁦Base64⁩: ارفع الملفات إلى تخزينك الخاص وأرسل روابطها. يجب أن تكون مدة الفيديوهات المرجعية وعناصر الفيديو معًا ⁦2–20⁩ ثانية؛ تُقرأ مدتها عند قبول الطلب، ويُرفض أي فيديو لا يمكن قراءة مدته قبل احتساب أي شيء.

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

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

text, reference images, image elements:   cost = duration × standard rate
reference videos or video elements:       cost = (output + max(output, input)) × video-input rate

⁦input⁩ هو مجموع مدة الفيديوهات المرجعية وعناصر الفيديو، مُقرّبًا إلى الأعلى إلى ثوانٍ كاملة. يُقاس عند قبول الطلب، لذا المبلغ المحتفظ به هو المبلغ المحتسب. مثال: مقطع مدته ⁦5⁩ ثوانٍ يسترشد بفيديو مرجعي مدته ⁦7.2⁩ ثانية يُحتسب على أساس ⁦5⁩ + ⁦8⁩ = ⁦13⁩ ثانية؛ ومع فيديو مرجعي مدته ⁦3⁩ ثوانٍ يُحتسب على أساس ⁦5⁩ + ⁦5⁩ = ⁦10⁩ ثوانٍ. المهام الفاشلة لا تُحتسب.

مخطط الإخراج

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

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

في اختباراتنا، عادت مقاطع مدتها ⁦5⁩ ثوانٍ بصيغة ⁦MP4⁩ (⁦H.264⁩) بدقة ⁦1280⁩ × ⁦720⁩ مع مسار ⁦AAC⁩ ستيريو، بعد ⁦91–103⁩ ثوانٍ من الإرسال؛ تزيد مدة الملف بنحو إطار واحد عن ⁦duration⁩ (⁦5.04⁩ ثوانٍ بدلًا من ⁦5⁩).

الأخطاء

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

انظر كتالوج الأخطاء المشترك للأكواد وحالات ⁦HTTP⁩ وإرشادات إعادة المحاولة.

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

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

نصائح

• صِف الموضوع والمكان وحركة الكاميرا والضوء والصوت؛ صوت المقطع يتابع الموجّه.
• استخدم ⁦Flash⁩ لتجربة الموجّهات ونسب العرض إلى الارتفاع والمراجع بتكلفة منخفضة، ثم انقل اللقطة الناجحة إلى ⁦Kling 4.0⁩ عندما تحتاج إلى ⁦1080p⁩ أو إطارات مفتاحية أو تعديل أو تمديد.
• أعطِ الشخصية المتكررة عنصرًا بزاويتين أو ثلاث زوايا واضحة بدلًا من صورة مرجعية واحدة.
• أضف ⁦no text, no logos⁩ لإبعاد العلامات المخترعة.

ذات صلة

• ⁦Playground⁩ وأسعار ⁦Kling 4.0 Flash⁩
• مرجع ⁦API⁩ ⁦Kling 4.0⁩
• تنزيل ⁦OpenAPI⁩
• ⁦Markdown⁩ قابلة للنسخ