# Kling 3.0 Turbo API

مرجع API كامل لنماذج توليد الفيديو Kling 3.0 Turbo من Kuaishou.

## متغيرات النموذج

يدعم هذا API متغيرين للنموذج:

| النموذج | ID | الوصف |
|-------|-----|-------------|
| **Kling 3.0 Turbo Text to Video** | `kling-3.0-turbo-text-to-video` | توليد سريع للفيديو من النص |
| **Kling 3.0 Turbo Image to Video** | `kling-3.0-turbo-image-to-video` | تحريك سريع للصورة إلى فيديو |

## مقارنة سريعة

| الميزة | نص إلى فيديو | صورة إلى فيديو |
|---------|---------------|----------------|
| الإدخال | موجه نصي | صورة + موجه نصي |
| نطاق المدة | 3-15 ثانية | 3-15 ثانية |
| خيارات الدقة | 720p, 1080p | 720p, 1080p |
| نسب العرض إلى الارتفاع | 16:9, 9:16, 1:1 | غير مدعومة (مدفوعة بالمصدر) |
| إطار البداية | غير مدعوم | مطلوب |

### نسب العرض إلى الارتفاع المدعومة (نص إلى فيديو)

| النسبة | الوصف |
|-------|-------------|
| `16:9` | أفقي (شاشة عريضة) |
| `9:16` | عمودي (رأسي) |
| `1:1` | مربع |

## Kling 3.0 Turbo Text to Video

### نقطة النهاية

```
POST /api/v1/video/task
```

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

#### مطلوب

| المعامل | النوع | الوصف |
|-----------|------|-------------|
| `model_name` | string | يجب أن يكون `"kling-3.0-turbo-text-to-video"` |
| `prompt` | string | موجه توليد الفيديو |
| `resolution` | string | دقة الإخراج: `"720p"` أو `"1080p"` |
| `duration` | number | مدة الفيديو بالثواني (3-15) |

#### اختياري

| المعامل | النوع | الوصف |
|-----------|------|-------------|
| `aspect_ratio` | string | نسبة عرض الفيديو إلى ارتفاعه: `"16:9"` أو `"9:16"` أو `"1:1"`. الافتراضي هو `"16:9"` |
| `sound` | boolean | توليد صوت محيطي للفيديو |

### مثال طلب

```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-3.0-turbo-text-to-video',
    prompt: 'A girl sits on a train, looking out the window with a melancholic expression, cinematic lighting',
    aspect_ratio: '16:9',
    resolution: '720p',
    duration: 5,
    sound: true
  })
});

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

## Kling 3.0 Turbo Image to Video

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

#### مطلوب

| المعامل | النوع | الوصف |
|-----------|------|-------------|
| `model_name` | string | يجب أن يكون `"kling-3.0-turbo-image-to-video"` |
| `prompt` | string | موجه الحركة والمشهد |
| `image_url` | string | URL صورة الإطار الأول |
| `resolution` | string | دقة الإخراج: `"720p"` أو `"1080p"` |
| `duration` | number | مدة الفيديو بالثواني (3-15) |

#### اختياري

| المعامل | النوع | الوصف |
|-----------|------|-------------|
| `sound` | boolean | توليد صوت محيطي للفيديو |

### مثال طلب

```javascript
{
  model_name: 'kling-3.0-turbo-image-to-video',
  prompt: 'The character slowly turns her head and looks out the window, subtle camera movement',
  image_url: 'https://example.com/test-first-frame.png',
  resolution: '720p',
  duration: 5,
  sound: true
}
```

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

استجابة الإرسال:

```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`.

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

- اجعل الموجهات مركزة على الحركة وسلوك الكاميرا وأجواء المشهد.
- بالنسبة إلى image-to-video، استخدم صورة إطار أول نظيفة بموضوع واضح.
- استخدم مددا أقصر للتكرار الأسرع، ثم زد المدة للتصييرات النهائية.