كيفية استخدام API Kling 4.0: الأوضاع والإطارات المفتاحية والمراجع والتعديل والتمديد

لاستخدام API Kling 4.0، أنشئ مفتاح API، أرسل جسم JSON واحد مع معرّف النموذج kling-4-0 وموجّهك، واستعلم المهمة التي يرجعها حتى يكون رابط الفيديو جاهزًا. نفس نقطة النهاية تغطي كل الأوضاع الخمسة: فيديو من نص، فيديو من صورة مع حتى ⁦10⁩ إطارات، مراجع من صور وفيديوهات وصوت، تعديل فيديو، وتمديد واحد. الملفات الإعلامية التي ترسلها وحقل واحد، omni_reference_task_type، يقررآن الوضع الذي يعمل.

هذا الدليل يمشي خلال كل وضع مع أجسام طلبات تعمل في ⁦22⁩ أكتوبر ⁦2026⁩، ثم يظهر كيفية احتساب كل وضع وأي طلبات مرفوضة قبل احتساب أي شيء.

ماذا تحتاج قبل الطلب الأول؟

⁦1⁩. مفتاح API. أنشئ واحدًا على صفحة مفاتيح API واحتفظ به على خادمك. لا تضعه أبدًا في كود المتصفح. ⁦2⁩. رصيد. أضف رصيدًا على صفحة الفوترة. الأرصدة لا تنتهي صلاحيتها، والمهام الفاشلة لا تُحتسب. ⁦3⁩. معرّف النموذج kling-4-0.

export SEEDROUTER_API_KEY="your-key"

كيف ترسل طلب Kling 4.0؟

أرسل المهمة إلى /v1/videos/generations:

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"
  }'

الاستجابة هي مهمة، وليس فيديو:

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

لكل حقل ما عدا model وفي معظم الأوضاع prompt افتراضي:

لا يوجد مفتاح صوت: كل مقطع Kling 4.0 يأتي مع مسار ستيريو. لا يوجد أيضًا حقل mode أو negative_prompt أو watermark. المخطط صارم، لذا حقل غير معروف مرفوض برسالة HTTP 400 قبل إنشاء مهمة وخطأ إملائي لا يتحول أبدًا إلى مقطع مدفوع مع الإعداد مُتجاهلًا بصمت.

كيف تحصل على الفيديو؟

استعلم GET /v1/tasks/{id} كل ⁦10⁩–⁦20⁩ ثانية حتى تكون status هي completed أو failed. خمسة اختبارات لنا أخذت بين دقيقة ⁦41⁩ ثانية و⁦4⁩ دقائق ⁦22⁩ ثانية لمقاطع ⁦3⁩ ثوانٍ و⁦720p⁩، لذا خطط للدقائق، ليس الثوانٍ.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

مهمة منتهية تبدو هكذا:

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

هذا هو المقطع الذي أنتجه الطلب الأول على هذه الصفحة، ⁦5⁩ ثوانٍ بـ ⁦720p⁩:

⁦Kling 4.0⁩ من نص إلى فيديو، ⁦720p⁩، ⁦5⁩ ثوانٍ، مع صوت ستيريو.

مقاطع ⁦720p⁩ لنا عادت كـ ⁦MP4⁩ (⁦H.264⁩) بـ ⁦1280⁩ × ⁦720⁩ مع مسار ⁦AAC⁩ ستيريو. احفظ الملف إلى تخزينك الخاص: الروابط المستضافة ليست دائمة. مهلة شبكة أثناء الاستعلام لا تعني فشل التوليد، لذا احتفظ بمعرّف المهمة وتحقق منها مرة أخرى بدلًا من إرسال مهمة جديدة.

أي وضع يعمل طلب Kling 4.0؟

الملفات الإعلامية في الجسم تختار الوضع. omni_reference_task_type يجعلها واضحة حيث ستكون الملفات الإعلامية وحدها غير واضحة:

الإطارات والملفات الإعلامية المرجعية لا يمكن دمجهما في طلب واحد، وvideo_url بدون edit أو extend مرفوض. كلاهما يرجع HTTP 400 قبل إنشاء مهمة.

كيف تثبّت إطارات مفتاحية في Kling 4.0؟

أرسل image_with_roles، قائمة من كائنات {url, role}. بالضبط first_frame واحد، last_frame اختياري وحتى ⁦8⁩ مدخلات keyframe، ⁦10⁩ صور مجموعًا. الإطارات المفتاحية تُستخدم بالترتيب الذي تُدرجها، لذا القائمة هي الخط الزمني.

{
  "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
}

لمجرد بداية ونهاية، image_urls: [first, last] أقصر. فيديو من صورة هو الوضع الوحيد حيث قد يُترك prompt بدونه؛ المقطع يأخذ شكل الإطار الأول.

كيف تستخدم صورًا وفيديوهات ومراجع صوتية؟

أضف video_urls (حتى ⁦5⁩ مقاطع، ⁦30⁩ ثانية مستخدمة مجموعًا) وaudio_urls (حتى ⁦3⁩ مقاطع من ⁦5⁩–⁦30⁩ ثانية) وصور مرجعية، أقصى ⁦15⁩ ملف. اذكرها في الموجّه كـ @Image1 و@Video1 و@Audio1، مرقّمة من ⁦1⁩ في كل قائمة:

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

الصور المرجعية يمكن أيضًا أن تذهب في image_urls، لكن فقط مع omni_reference_task_type: "reference"؛ بدونه، image_urls تُقرأ كإطارات أول وأخيرة. صوت فيديو المرجع الخاص به يُستبدل بشكل افتراضي؛ اضبط audio_setting: "origin" للاحتفاظ به.

كيف تعدّل فيديو باستخدام Kling 4.0؟

اضبط omni_reference_task_type على edit، مرّر الفيديو في video_url، وصِف التغيير. حتى ⁦10⁩ صور مرجعية يمكن أن تذهب في image_urls.

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

الإدخال يجب أن يكون على الأقل ⁦3⁩ ثوانٍ طويل وفقط أول ⁦30⁩ ثانية تُستخدم. اترك بدون duration والنتيجة تتابع طول فيديو الإدخال؛ الصوت الأصلي يُحتفظ به إلا إذا اضبطت audio_setting: "auto".

كيف تمدد فيديو؟

اضبط omni_reference_task_type على extend، مرّر الفيديو، وأعطِ duration كطول الجزء الجديد. ⁦Kling 4.0⁩ يستمر من الإطار الأخير ويرجع الأصلي زائد الثواني الجديدة كملف واحد. في اختبارنا مقطع ⁦5.2⁩ ثانية ممدد بـ ⁦3⁩ ثوانٍ عاد ⁦8.1⁩ ثواني طويل.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

أضف last_frame_image لاختيار حيث ينتهي الجزء الجديد. التمديد يحتفظ بنسبة الإدخال وصوته، لذا aspect_ratio وaudio_setting مرفوضة.

كم تكلف طلب Kling 4.0؟

يُحتسب Kling 4.0 لكل ثانية من الفيديو بسعر تحدده الدقة. الثواني التي تُحتسب تعتمد على الوضع:

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

فيديو لا يمكن قراءة طوله مرفوض قبل احتساب أي شيء، ومهمة تفشل لا تُحتسب.

أي طلبات مرفوضة قبل احتساب أي شيء؟

هذه ترجع HTTP 400 عند الإرسال، بلا مهمة مُنشأة ولا احتساب:

مهمة تم قبولها ثم تفشل، على سبيل المثال على سياسة محتوى النموذج، ترجع status: "failed" برمز error ولا تُحتسب. كتالوج الأخطاء يسرد الأكواز.

هل يمكن لوكيل برمجي تشغيله لك؟

نعم. صفحة Kling 4.0 لديها موجّه جاهز لـ ⁦Claude Code⁩ أو ⁦Codex⁩ أو ⁦Cursor⁩ يقرأ المفتاح من بيئتك، يظهر الطلب وتكلفته، ينتظر موافقتك، ثم يُرسل ويستعلم وينزّل المقطع. نفس الصفحة لديها playground يُرسل الجسم الدقيق الذي سيرسله كودك، مع كل حقل مجمّع حسب الوضع.

أسئلة Kling 4.0 API

هل API Kling 4.0 مجاني؟

لا. يُحتسب لكل ثانية من الفيديو. حسابات SeedRouter الجديدة تحصل على رصيد صغير لتجربته، لا يوجد اشتراك، والمهام الفاشلة لا تُحتسب.

هل Kling 4.0 Flash في API؟

ليس بعد. Kling 4.0 Flash نموذج منفصل وأخف في العائلة نفسها؛ Kling يسرده مع مقاطع ⁦720p⁩ أقصر بدون عدة إطارات مفتاحية.^[1] معرّف النموذج kling-4-0 هو Kling 4.0 الكامل.

كيف يختلف Kling 4.0 عن Kling 3.0 في API؟

⁦Kling 4.0⁩ يصنع مقاطع حتى ⁦30⁩ ثانية، يتقبل إطارات مفتاحية ومراجع فيديو وصوت، ويمكنه تعديل أو تمديد فيديو؛ الصوت دائمًا قيد التشغيل. ⁦Kling 3.0⁩ يصنع مقاطع ⁦3⁩–⁦15⁩ ثانية، يقدم ⁦4K⁩ وموجّهات متعددة اللقطات والعناصر المسماة، ومفتاح صوت. دليل API Kling 3.0 يغطي حقوله. Kling أعلن ⁦4.0⁩ مع طوله ⁦30⁩ ثانية و⁦10⁩ إطارات مفتاحية وصوت ستيريو في ⁦30⁩ سبتمبر ⁦2026⁩.^[2]

هل يمكنني إلغاء مهمة؟

لا. بمجرد قبول مهمة، تعمل حتى اكتمال أو فشل. المهام الفاشلة لا تُحتسب.

المراجع

1. Kling AI. Kling 4.0 video generation (نظرة عامة على الميزات والأسئلة الشائعة). تم الفحص في ⁦8⁩ أكتوبر ⁦2026⁩ في kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. ⁦30⁩ سبتمبر ⁦2026⁩. تم الفحص في ⁦8⁩ أكتوبر ⁦2026⁩ في kling.ai.