# واجهة API لنموذج Kling 2.6 Motion Control

مرجع API كامل لتوليد الفيديو باستخدام Kling 2.6 Motion Control من Kuaishou.

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

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

| النموذج | المعرّف | الوصف |
|-------|-----|-------------|
| **Kling 2.6 Motion Control** | `kling-2.6-motion-control` | توليد فيديو باستخدام موجّه نصي وصورة مرجعية واحدة وفيديو مرجعي واحد |

## Kling 2.6 Motion Control

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

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

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

#### مطلوبة

| المعلمة | النوع | الوصف |
|-----------|------|-------------|
| `model_name` | string | يجب أن تكون القيمة `"kling-2.6-motion-control"` |
| `prompt` | string | موجّه لتوليد الفيديو، بحد أقصى 5000 حرف |
| `images` | string[] | عنوان URL لصورة مرجعية واحدة فقط. يدعم `.jpg` و`.jpeg` و`.png`؛ يجب ألا يتجاوز حجم الملف 50 MB. يجب ألا يقل كل من العرض والارتفاع عن 300 px، وأن تكون نسبة أبعاد الصورة بين 1:2.5 و2.5:1 |
| `videos` | string[] | عنوان URL لفيديو مرجعي واحد فقط. يدعم `.mp4` و`.mov`؛ يجب ألا يتجاوز حجم الملف 100 MB. يجب أن يكون كل من العرض والارتفاع بين 340 و3850 px، شاملًا الحدين. يجب ألا تقل المدة عن 3 ثوانٍ؛ ويعتمد الحد الأقصى على `character_orientation` |
| `character_orientation` | string | مطلوبة دون قيمة افتراضية. `"image"`: يتبع اتجاه الشخصية في الصورة المرجعية؛ يجب أن تتراوح مدة الفيديو المرجعي بين 3-10 ثوانٍ. `"video"`: يتبع اتجاه الشخصية في الفيديو المرجعي؛ يجب أن تتراوح مدة الفيديو المرجعي بين 3-30 ثانية. يشمل كلا النطاقين الحدين الأدنى والأقصى |
| `resolution` | string | دقة الإخراج: `"720p"` أو `"1080p"`. مطلوبة دون قيمة افتراضية |

#### اختيارية

| المعلمة | النوع | الوصف |
|-----------|------|-------------|
| `keep_original_sound` | boolean | ما إذا كان سيتم الاحتفاظ بالصوت الأصلي للفيديو المرجعي. تقبل `true` أو `false`؛ والقيمة الافتراضية هي `true` |

تتبع مدة الإخراج مدة الفيديو المصدر. المعلمة `duration` غير مدعومة. تُحدَّد نسبة أبعاد الإخراج وفقًا لوسائط الإدخال، ولا تُدعَم `aspect_ratio`. لم يحدد المزوّد الأساسي أيّ مدخل يحدد نسبة أبعاد الإخراج أو قاعدة الاختيار الدقيقة.

تُحتسب التكلفة بناءً على مدة الفيديو المصدر بعد تقريبها إلى أقرب ثانية صحيحة ودقة الإخراج المحددة. مثلًا، تُحتسب مدة 5.4 ثانية على أنها 5 ثوانٍ، ومدة 5.5 ثانية على أنها 6 ثوانٍ.

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

استبدل عناوين URL للوسائط في المثال بعناوين ملفاتك الخاصة التي تستوفي المتطلبات أعلاه.

```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-2.6-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

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

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

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

تُرجع `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. **الوسائط المرجعية**: قدّم صورة واحدة وفيديو واحدًا فقط، وتحقق من تنسيقاتهما وأحجام ملفاتهما وأبعادهما قبل الإرسال
2. **اتجاه الشخصية**: أعد التحقق من مدة الفيديو المرجعي عند تغيير `character_orientation`، خاصةً عند اختيار `"image"`
3. **الصوت الأصلي**: اضبط `keep_original_sound` على `false` لعدم الاحتفاظ بالصوت الأصلي للفيديو المرجعي؛ ويُحتفَظ بالصوت عند عدم تضمين هذه المعلمة