Kling 4.0 API

مرجع شامل لواجهة API الخاصة بنماذج Kling 4.0 لتوليد الفيديو من Kuaishou.

إصدارات النموذج

تدعم واجهة API هذه خمسة إصدارات من النموذج:

مقارنة سريعة

نسب العرض إلى الارتفاع المدعومة

تدعم Text-to-Video وImage-to-Video وReference-to-Video وVideo Edit النسب التالية:

16:9, 9:16, 1:1, 21:9

القيمة الافتراضية هي 16:9. لا يدعم Video Extend المعامل aspect_ratio؛ إذ يتبع الناتج نسبة العرض إلى الارتفاع في الفيديو المصدر.

خيارات الدقة

تتطلب النماذج الخمسة جميعها resolution وduration. أدرج resolution صراحةً رغم أن قيمته الافتراضية هي 720p. لا توجد قيمة افتراضية للمعامل duration.

Kling 4.0 Text to Video

نقطة النهاية

POST /api/v1/video/task

معاملات الطلب

المطلوبة

الاختيارية

مثال على الطلب

javascriptنسخ
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Kling 4.0 Image to Video

معاملات الطلب

المطلوبة

الاختيارية

عند توفير كلٍّ من image_url وimage_end_url، يمكن أن يحتوي key_frames على 8 صور كحد أقصى. تُستخدم الإطارات الوسيطة حسب ترتيبها في المصفوفة؛ ويحدد النموذج توقيتها.

مثال على الطلب

javascriptنسخ
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

معاملات الطلب

المطلوبة

الاختيارية

الصور ومقاطع الفيديو والمقاطع الصوتية المرجعية كلها اختيارية. يمكنك توفير أي نوع واحد من الوسائط، أو الجمع بين الأنواع، أو عدم توفير أيٍّ من الأنواع الثلاثة.

تُضبط مدة الناتج duration بشكل مستقل بين 3-30 ثانية، ولا تُحتسب ضمن الحد الأقصى لمجموع مدد مقاطع الفيديو المرجعية.

مثال على الطلب

javascriptنسخ
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

معاملات الطلب

المطلوبة

الاختيارية

مثال على الطلب

javascriptنسخ
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

معاملات الطلب

المطلوبة

الاختيارية

لا ترسل aspect_ratio؛ إذ يتبع الناتج نسبة العرض إلى الارتفاع في الفيديو المصدر. تحتوي النتيجة على الفيديو الكامل، بما في ذلك الفيديو المصدر والتمديد. وتساوي مدته الإجمالية مدة الفيديو المصدر مضافًا إليها duration.

مثال على الطلب

javascriptنسخ
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

قواعد احتساب التكلفة

تُحتسب تكلفة Text-to-Video وImage-to-Video بناءً على دقة الناتج ومدة الفيديو المُولَّد. وتُحتسب تكلفة Video Extend بناءً على الدقة ومدة المقطع المضاف، وليس المدة الكاملة للفيديو المُعاد.

تأخذ طلبات Reference-to-Video التي تتضمن مقاطع فيديو مرجعية وطلبات Video Edit في الحسبان مدة فيديو الإدخال وفيديو الإخراج بالدقة المختارة. الحد الأدنى للمدة المحتسبة لفيديو الإدخال هو 3 ثوانٍ، والحد الأقصى 30 ثانية. عند استخدام عدة مقاطع فيديو مرجعية، تنطبق هذه الحدود على مجموع مددها، وليس على كل فيديو على حدة. ولا تحدد حدود المدة المحتسبة للتكلفة حدود الرفع.

في غياب مقاطع فيديو مرجعية، يستخدم Reference-to-Video قواعد احتساب التكلفة نفسها الخاصة بـ Text-to-Video، سواء تم توفير صور أو مقاطع صوتية مرجعية أم لا. في الطلبات التي تتضمن فيديو إدخال، لا تترتب رسوم منفصلة على الصور المرجعية والمقاطع الصوتية المرجعية المدعومة أو keep_original_sound.

تنسيق الاستجابة

الاستجابة الأولية

تُعيد جميع النماذج task_id للاستعلام الدوري:

jsonنسخ
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

أجرِ استعلامًا دوريًا باستخدام GET /api/v1/video/{task_id} للتحقق من الحالة واسترجاع الفيديو المُولَّد.

قيم الحالة

• submitted: تم قبول المهمة وهي بانتظار المعالجة
• processing: جارٍ توليد الفيديو
• succeed: اكتمل توليد الفيديو
• failed: فشل توليد الفيديو

أفضل الممارسات

1. المعاملات المطلوبة: وفّر دائمًا resolution وduration، حتى عند استخدام الدقة الافتراضية 720p
2. عدد الإطارات: احرص على ألا يتجاوز مجموع الإطار الأول والإطار النهائي والإطارات الوسيطة 10 إطارات
3. الوسائط المرجعية: التزم بالأعداد والمدد المحددة في الوثائق للوسائط المرجعية
4. الصوت الأصلي: استخدم keep_original_sound فقط مع Reference-to-Video أو Video Edit
5. تمديد الفيديو: اضبط duration على المدة الإضافية ولا تُضمِّن aspect_ratio