> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# واجهة برمجة تطبيقات توليد فيديوهات كليغ - تعليمات الدمج

> Kling video generation API guide - Ace Data Cloud

ستقدم هذه الوثيقة تعليمات دمج واجهة برمجة تطبيقات توليد فيديوهات كليغ، والتي يمكن استخدامها لتوليد فيديوهات رسمية من كليغ من خلال إدخال معلمات مخصصة.

## عملية التقديم

لاستخدام واجهة برمجة تطبيقات توليد فيديوهات كليغ، يجب أولاً الذهاب إلى [وحدة التحكم في بيانات Ace](https://platform.acedata.cloud/console/applications) للحصول على رمز API الخاص بك، للاحتفاظ به كنسخة احتياطية.

![](https://cdn.acedata.cloud/5hmkdg.jpg)

إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية.

**يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة.** عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في [وحدة التحكم](https://platform.acedata.cloud/console/coin).

> 📘 الوثائق الكاملة: [واجهة برمجة تطبيقات توليد فيديوهات كليغ →](https://platform.acedata.cloud/documents/kling-videos)

## الاستخدام الأساسي

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال كلمة التلميح `prompt`، وسلوك التوليد `action`، وصورة الإطار الأول المرجعية `start_image_url`، والنموذج `model`، للحصول على النتيجة المعالجة. أولاً، نحتاج ببساطة إلى تمرير حقل `action`، الذي تكون قيمته `text2video`، والذي يتضمن ثلاثة سلوكيات رئيسية: توليد فيديو من نص ( `text2video`)، توليد فيديو من صورة ( `image2video`)، وتوسيع الفيديو ( `extend`)، ثم نحتاج أيضًا إلى إدخال النموذج `model`، والذي يتضمن حاليًا النماذج التالية: `kling-v1`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1-master`, `kling-v2-5-turbo`, `kling-v2-6`, `kling-v3`, `kling-v3-omni`, `kling-o1`، المحتوى المحدد كما يلي:

<p>
  <img src="https://cdn.acedata.cloud/ke1bok.png" width="500" className="m-auto" />
</p>

يمكننا أن نرى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:

* `accept`: نوع الاستجابة التي ترغب في تلقيها، هنا يتم ملؤها بـ `application/json`، أي بتنسيق JSON.
* `authorization`: مفتاح استدعاء API، يمكن اختياره مباشرة بعد التقديم.

بالإضافة إلى ذلك، تم تعيين جسم الطلب، بما في ذلك:

* `model`: نموذج توليد الفيديو، والذي يتضمن بشكل رئيسي `kling-v1`, `kling-v1-6`, `kling-v2-master`, `kling-v2-1-master`, `kling-v2-5-turbo`, `kling-v2-6`, `kling-v3`, `kling-v3-omni`, `kling-o1`.
* `mode`: وضع توليد الفيديو، القيم الاختيارية هي الوضع القياسي `std`، الوضع السريع `pro`، ووضع 4K الأصلي `4k`. حيث أن `4k` يدعم فقط `kling-v3` و `kling-v3-omni`، وغير متوافق مع `camera_control` (تحكم الكاميرا).
* `action`: سلوك مهمة توليد الفيديو هذه، والتي تتضمن بشكل رئيسي ثلاثة سلوكيات، وهي: توليد فيديو من نص ( `text2video`)، توليد فيديو من صورة ( `image2video`)، وتوسيع الفيديو ( `extend`).
* `start_image_url`: عند اختيار سلوك توليد فيديو من صورة `image2video`، يجب تحميل رابط صورة الإطار الأول المرجعية.
* `end_image_url`: اختياري عند توليد فيديو من صورة، يحدد الإطار النهائي.
* `duration`: مدة الفيديو، بوحدة الثواني. يدعم `kling-v3` و `kling-v3-omni` مدة من 3-15 ثانية كأعداد صحيحة؛ ويدعم `kling-o1` فقط 5 ثوانٍ؛ بينما تدعم النماذج الأخرى 5 أو 10 ثوانٍ.
* `generate_audio`: هل يجب توليد الصوت بشكل متزامن، اختياري، قيمة منطقية. يدعم `kling-v3`، `kling-v3-omni` و `kling-v2-6` (فقط في وضع pro). القيمة الافتراضية هي `false`.
* `aspect_ratio`: نسبة عرض الفيديو إلى ارتفاعه، اختياري، يدعم `16:9`، `9:16`، `1:1`، القيمة الافتراضية هي `16:9`.
* `cfg_scale`: شدة العلاقة، النطاق \[0,1]، كلما زادت القيمة، زادت المطابقة لكلمة التلميح.
* `camera_control`: اختياري، يتحكم في معلمات حركة الكاميرا، يدعم الإعدادات المسبقة type/simple بالإضافة إلى التكوينات horizontal، vertical، pan، tilt، roll، zoom.
* `negative_prompt`: اختياري، كلمات التلميح العكسية التي لا ترغب في ظهورها، بحد أقصى 200 حرف.
* `image_list`: قائمة صور مرجعية Omni، مناسبة للنموذجين `kling-o1` و `kling-v3-omni`، انظر الاستخدام أدناه "مرجع Omni الشامل".
* `video_list`: قائمة فيديوهات مرجعية Omni (تدعم تحرير الفيديو)، مناسبة للنموذجين `kling-o1` و `kling-v3-omni`، انظر الاستخدام أدناه "مرجع Omni الشامل".
* `prompt`: كلمة التلميح.
* `callback_url`: URL الذي يحتاج إلى استدعاء النتائج.
* `async`: اختياري، عند تعيينه إلى `true`، تعيد الواجهة على الفور `task_id`، دون الحاجة لتقديم `callback_url`، ثم يمكن استعلام النتائج من خلال واجهة استعلام المهام المقابلة.

بعد الاختيار، يمكننا أن نرى أن الكود المقابل قد تم إنشاؤه على الجانب الأيمن، كما هو موضح في الصورة:

<p>
  <img src="https://cdn.acedata.cloud/3yjql0.png" width="500" className="m-auto" />
</p>

يمكنك الضغط على زر "Try" لإجراء اختبار، كما هو موضح في الصورة أعلاه، حيث حصلنا على النتيجة التالية:

```json theme={null}
{
  "success": true,
  "video_id": "900798310464749610",
  "video_url": "https://platform2.cdn.acedata.cloud/kling/6c68c267-065b-4423-b66b-a0e4c59ee0d5.mp4",
  "duration": "5.041",
  "state": "succeed",
  "task_id": "6c68c267-065b-4423-b66b-a0e4c59ee0d5"
}
```

تتضمن النتيجة العائدة عدة حقول، كما يلي:

* `success`: حالة مهمة توليد الفيديو في ذلك الوقت.
* `task_id`: معرف مهمة توليد الفيديو في ذلك الوقت.
* `video_id`: معرف الفيديو لمهمة توليد الفيديو في ذلك الوقت.
* `video_url`: رابط الفيديو لمهمة توليد الفيديو في ذلك الوقت.
* `duration`: مدة الفيديو لمهمة توليد الفيديو في ذلك الوقت.
* `state`: حالة مهمة توليد الفيديو في ذلك الوقت.

يمكننا أن نرى أننا حصلنا على معلومات الفيديو المرضية، كل ما علينا هو الحصول على رابط الفيديو الذي تم إنشاؤه من `data` في النتيجة.

بالإضافة إلى ذلك، إذا كنت ترغب في توليد الكود المقابل للدمج، يمكنك نسخه مباشرة، مثل كود CURL كما يلي:

```shell theme={null}
curl -X POST 'https://api.acedata.cloud/kling/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "kling-v3",
  "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle."
}'
```

## مصفوفة قدرات النموذج

تختلف دعم النماذج المختلفة للمعلمات بشكل كبير. تم تنظيم المصفوفة التالية من [وثائق نماذج الفيديو الرسمية لكليغ](https://app.klingai.com/global/dev/document-api/apiReference/model/videoModels)، يرجى التحقق من أن التركيبة الحالية من `model` / `mode` / `duration` تدعم الوظائف المطلوبة قبل الاستدعاء، وإلا ستعيد الواجهة العليا أخطاء مثل `model/mode/duration(...) is not supported with image_tail`.

| النموذج             | الوضع          | `end_image_url` (الإطار النهائي) | `generate_audio` (الموسيقى المصاحبة) | `camera_control` (تحكم الكاميرا) | الملاحظات                                         |
| ------------------- | -------------- | -------------------------------- | ------------------------------------ | -------------------------------- | ------------------------------------------------- |
| `kling-v1`          | std / pro      | ✅ فقط `duration=5`               | ❌                                    | ✅ فقط `duration=5`               | `extend` لا يدعم `negative_prompt` و `cfg_scale`  |
| `kling-v1-6`        | std            | ❌                                | ❌                                    | ❌                                | فيديو متعدد الصور، `extend` متاح في جميع الأوضاع  |
| `kling-v1-6`        | pro            | ✅                                | ❌                                    | ❌                                |                                                   |
| `kling-v2-master`   | —              | ❌                                | ❌                                    | ❌                                | وضع واحد، فقط `duration=5/10`                     |
| `kling-v2-1-master` | —              | ❌                                | ❌                                    | ❌                                | وضع واحد، فقط `duration=5/10`                     |
| `kling-v2-5-turbo`  | std            | ❌                                | ❌                                    | ❌                                |                                                   |
| `kling-v2-5-turbo`  | pro            | ✅                                | ❌                                    | ❌                                |                                                   |
| `kling-v2-6`        | std            | ❌                                | ❌                                    | ❌                                |                                                   |
| `kling-v2-6`        | pro            | ✅                                | ✅                                    | ❌                                | النموذج الوحيد الذي يدعم الموسيقى المصاحبة غير v3 |
| `kling-v3`          | std / pro      | ✅                                | ✅                                    | ✅                                | نطاق `duration` من 3 إلى 15 ثانية                 |
| `kling-v3`          | 4k             | ✅                                | ✅                                    | ❌                                | وضع 4K غير متوافق مع تحكم الكاميرا                |
| `kling-v3-omni`     | std / pro / 4k | ✅                                | ✅                                    | ❌                                |                                                   |
| `kling-o1`          | std / pro      | ✅                                | ❌                                    | ❌                                | يدعم فقط `duration=5`                             |

ملاحظات:

* `mode=4k` يدعمه فقط `kling-v3` و `kling-v3-omni`؛ وهو متعارض مع `camera_control` (تحكم الكاميرا).
* `end_image_url` يمكن استخدامه فقط مع `action=image2video` بالتزامن مع `start_image_url`. إرسال `end_image_url` فقط (بدون `start_image_url`) سيتم رفضه.
* `kling-v3` / `kling-v3-omni` يقبلان أي مدة صحيحة من 3 إلى 15 ثانية؛ `kling-o1` يقبل فقط 5؛ النماذج الأخرى تقبل فقط 5 أو 10.
* `generate_audio` افتراضيًا `false`. فقط `kling-v3`، `kling-v3-omni` و `kling-v2-6` (وضع pro) تدعم ذلك.

## ميزات توسيع الفيديو

إذا كنت ترغب في مواصلة إنشاء فيديو Kling تم إنشاؤه بالفعل، يمكنك تعيين المعامل `action` إلى `extend`، وإدخال ID الفيديو الذي تحتاج إلى مواصلة إنشائه، يتم الحصول على ID الفيديو بناءً على الاستخدام الأساسي كما هو موضح في الصورة أدناه:

<p>
  <img src="https://cdn.acedata.cloud/om6p6g.png" width="500" className="m-auto" />
</p>

في هذه الحالة، يمكنك رؤية ID الفيديو هو:

```
"video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c"
```

> ملاحظة، هنا ID الفيديو هو ID الفيديو الذي تم إنشاؤه بعد، إذا كنت لا تعرف كيفية إنشاء الفيديو، يمكنك الرجوع إلى الاستخدام الأساسي المذكور أعلاه لإنشاء الفيديو.

بعد ذلك، يجب علينا ملء الخطوة التالية التي تحتاج إلى توسيع الكلمات الرئيسية لتخصيص الفيديو الذي سيتم إنشاؤه، يمكنك تحديد المحتويات التالية:

* `model`: نموذج الفيديو الذي سيتم إنشاؤه، بشكل رئيسي `kling-v1`، `kling-v1-5` و `kling-v1-6`.
* `mode`: وضع الفيديو الذي سيتم إنشاؤه، القيم الاختيارية هي الوضع القياسي `std`، الوضع السريع `pro` ووضع 4K الأصلي `4k` (يدعمه فقط `kling-v3` و `kling-v3-omni`، غير متوافق مع تحكم الكاميرا).
* `duration`: مدة مهمة إنشاء الفيديو، تشمل بشكل رئيسي 5 ثوانٍ و 10 ثوانٍ.
* `start_image_url`: عند اختيار سلوك تحويل الصورة إلى فيديو `image2video`، يجب تحميل رابط الصورة المرجعية للإطار الأول.
* `prompt`: الكلمات الرئيسية.

مثال على كيفية الملء:

<p>
  <img src="https://cdn.acedata.cloud/ejimqy.png" width="500" className="m-auto" />
</p>

بعد الانتهاء من الملء، تم إنشاء الكود تلقائيًا كما يلي:

<p>
  <img src="https://cdn.acedata.cloud/52x4u5.png" width="500" className="m-auto" />
</p>

الكود المقابل بلغة Python:

```python theme={null}
import requests

url = "https://api.acedata.cloud/kling/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "action": "extend",
    "model": "kling-v1",
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "prompt": "White ceramic coffee mug on glossy marble countertop with morning window light. Camera slowly rotates 360 degrees around the mug, pausing briefly at the handle.",
    "duration": 10
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

عند النقر على التشغيل، يمكنك أن ترى أنه ستحصل على نتيجة كما يلي:

```json theme={null}
{
  "success": true,
  "video_id": "bbc3b105-ac72-4de2-8390-0cb37dc7d41e",
  "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/extendVideo/Cjil4mfBfs0AAAAAAKhr6A-0_raw_video_1.mp4",
  "duration": "9.6",
  "state": "succeed",
  "task_id": "3ece87e6-3ee3-4f5e-bd70-5ae5eca89a23"
}
```

يمكنك أن ترى أن محتوى النتيجة متطابق مع ما سبق، مما يحقق وظيفة توسيع الفيديو.

## Omni مرجع شامل (تحرير الفيديو / فيديو مرجعي / مرجع متعدد الصور)

`kling-o1` و `kling-v3-omni` هما نموذجين مستقلين، كلاهما يدعم القدرة على "المرجع الشامل". بناءً على إنشاء الفيديو من النص (`action=text2video`)، يمكن تمرير صور مرجعية أو فيديو مرجعي إضافي، لتحقيق **مرجع متعدد الصور، فيديو مرجعي وتحرير فيديو موجود مباشرة**.

**الاتفاق الأساسي**: يجب أن يتم الإشارة إلى المواد المرجعية في `prompt` بصيغة `&lt;&lt;<image_1>>>`، `&lt;&lt;<video_1>>>` (الترقيم يبدأ من 1) للإشارة إلى المواد المقابلة في `image_list` / `video_list`، حتى يتمكن النموذج من تطبيق هذه المراجع. إذا تم تمرير المواد فقط دون الإشارة إليها في الكلمات الرئيسية، فسيتم تجاهل المواد.

> ملاحظة أمان: API الحالية لا تفتح `element_list`. ID مكتبة عناصر Kling العلوية تنتمي إلى مساحة اسم حساب المزود، قبل توفير API إدارة العناصر المعزولة، يجب على العملاء استخدام `image_list` لتمرير صورة المرجع الرئيسية.

طلبات Omni لا تدعم `negative_prompt`، `cfg_scale` أو `camera_control`، ولا يمكن استخدام `mode=4k`. عند تضمين فيديو مرجعي، يجب أن تكون `generate_audio` `false`.

### فيديو مرجعي وتحرير الفيديو (`video_list`)

`video_list` يُستخدم لإدخال الفيديو المرجعي، وهو أكثر السيناريوهات استخدامًا في هذه القدرة، حقول عناصر المصفوفة كما يلي:

* `video_url`: رابط الفيديو المرجعي، لا يمكن أن يكون فارغًا. المتطلبات: صيغة MP4/MOV؛ دقة 720px–2160px؛ مدة 3–10 ثوانٍ؛ معدل الإطارات 24–60fps؛ حجم الملف ≤200MB؛ بحد أقصى فيديو واحد.
* `refer_type`: نوع المرجع، يمكن أن يكون `base` (افتراضي، **فيديو أساسي للتعديل**، أي "تعديل الفيديو مباشرة"، يمكن إضافة/حذف/تعديل العناصر، تغيير التكوين، تغيير الأسلوب، تغيير الألوان، تغيير الطقس، إلخ) أو `feature` (**مرجع مميز**، الإشارة إلى أسلوبه / حركته / متابعة اللقطة التالية).
* `keep_original_sound`: هل ترغب في الاحتفاظ بالصوت الأصلي للفيديو، يمكن أن يكون `yes` (احتفظ) أو `no` (إزالة).

> ملاحظة: عند وجود فيديو مرجعي، يجب أن تكون `generate_audio` `false`. لا يمكن تحديد الإطار الأول / الأخير للفيديو الذي يكون `refer_type=base`.

مثال على CURL لتحرير فيديو موجود (تغيير الفيديو إلى أسلوب أنمي) كما يلي:

```shell theme={null}
curl -X POST 'https://api.acedata.cloud/kling/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "kling-o1",
  "mode": "std",
  "duration": 5,
  "prompt": "اجعل <<<video_1>>> بأسلوب أنمي بمستوى سينمائي، مع الاحتفاظ بالحركة والتكوين الأصلي",
  "video_list": [
    {
      "video_url": "https://cdn.acedata.cloud/your-reference-video.mp4",
      "refer_type": "base",
      "keep_original_sound": "no"
    }
  ]
}'
```

### مرجع متعدد الصور (`image_list`)

`image_list` يُستخدم لإدخال الصور المرجعية (عناصر / مشاهد / أنماط، إلخ)، حقول عناصر المصفوفة كما يلي:

* `image_url`: رابط الصورة المرجعية، لا يمكن أن يكون فارغًا. المتطلبات: صيغة .jpg/.jpeg/.png؛ حجم الملف ≤10MB؛ الحد الأدنى للجانب ≥300px؛ نسبة العرض إلى الارتفاع 1:2.5 \~ 2.5:1.
* `type`: اختياري. عند عدم الإرسال، يُعتبر صورة مرجعية بحتة؛ عند الإرسال `first_frame` / `end_frame`، تُعتبر على التوالي كإطار أول / إطار أخير (معادلة لـ `start_image_url` / `end_image_url`).

عند الاستخدام، يجب الإشارة في `prompt` باستخدام `&lt;&lt;<image_1>>>`، `&lt;&lt;<image_2>>>`. حد العدد: عند عدم وجود فيديو مرجعي، يجب أن تكون الصور المرجعية ≤ 7؛ عند وجود فيديو مرجعي، يجب أن تكون الصور المرجعية ≤ 4. عند إرسال الإطارات الأولى / الأخيرة فقط، يمكن أيضًا استخدام `start_image_url` / `end_image_url` مباشرة، ولكن يجب استخدام الإطار الأخير مع الإطار الأول.

> ملاحظة: إذا تم إرسال `start_image_url` / `end_image_url` مع `image_list`، فإن الإطار الأول / الأخير سيأتي قبل `image_list`، مما قد يؤثر على علاقة ترتيب `&lt;&lt;<image_N>>>`. يُنصح باختيار واحد: عند الحاجة إلى إطار أول / آخر، يُفضل تحديده مباشرة في `image_list` باستخدام `type`، وعدم مزجه مع `start_image_url` / `end_image_url`.

مثال على CURL لإنشاء فيديو باستخدام مرجع متعدد الصور:

```shell theme={null}
curl -X POST 'https://api.acedata.cloud/kling/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "text2video",
  "model": "kling-o1",
  "mode": "std",
  "duration": 5,
  "prompt": "اجعل الشخصيات في <<<image_1>>> تقف في مشهد <<<image_2>>>، مع إضاءة سينمائية",
  "image_list": [
    { "image_url": "https://cdn.acedata.cloud/subject.png" },
    { "image_url": "https://cdn.acedata.cloud/scene.png" }
  ]
}'
```

## ردود الاتصال غير المتزامنة

نظرًا لأن وقت توليد فيديوهات Kling API طويل نسبيًا، حوالي 1-2 دقيقة، إذا لم يكن هناك استجابة لفترة طويلة، ستظل طلبات HTTP متصلة، مما يؤدي إلى استهلاك موارد النظام الإضافية، لذا يوفر هذا API أيضًا دعم ردود الاتصال غير المتزامنة.

العملية العامة هي: عندما يقوم العميل بإرسال الطلب، يحدد حقل `callback_url` إضافي، بعد إرسال العميل لطلب API، سيعود API على الفور بنتيجة تحتوي على حقل `task_id`، الذي يمثل معرف المهمة الحالية. عند اكتمال المهمة، سيتم إرسال نتيجة الفيديو المولد إلى `callback_url` المحدد من قبل العميل عبر POST JSON، والذي يتضمن أيضًا حقل `task_id`، بحيث يمكن ربط نتيجة المهمة من خلال المعرف.

دعونا نفهم كيفية القيام بذلك من خلال مثال.

أولاً، رد الاتصال عبر Webhook هو خدمة يمكنها استقبال طلبات HTTP، يجب على المطور استبدالها بعنوان URL الخاص بخادم HTTP الذي قام بإنشائه. هنا، لتسهيل العرض، نستخدم موقع Webhook عام [https://webhook.site/،](https://webhook.site/،) عند فتح هذا الموقع، ستحصل على عنوان URL لـ Webhook، كما هو موضح في الصورة:

![](https://cdn.acedata.cloud/tbcnai.png)

انسخ هذا العنوان URL، يمكنك استخدامه كـ Webhook، والعينة هنا هي `https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3`.

بعد ذلك، يمكننا تعيين حقل `callback_url` إلى عنوان URL الخاص بـ Webhook المذكور أعلاه، مع ملء المعلمات المناسبة، كما هو موضح في الصورة:

<p>
  <img src="https://cdn.acedata.cloud/vdx12s.png" width="500" className="m-auto" />
</p>

عند النقر على التشغيل، يمكنك أن ترى أنه سيتم الحصول على نتيجة على الفور، كما يلي:

```
{
  "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}
```

بعد لحظة، يمكننا ملاحظة نتيجة الفيديو المولد على `https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3`، كما هو موضح في الصورة:

![](https://cdn.acedata.cloud/zv5u2q.png)

المحتوى كما يلي:

```json theme={null}
{
    "success": true,
    "video_id": "030bb06d-98d4-4044-9042-0aa0822e8c8c",
    "video_url": "https://cdn.klingai.com/bs2/upload-kling-api/7822108635/text2video/CjJzzGfBfqcAAAAAAKdVMQ-0_raw_video_1.mp4",
    "duration": "5.1",
    "state": "succeed",
    "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0"
}
```

يمكنك أن ترى أن النتيجة تحتوي على حقل `task_id`، بينما الحقول الأخرى مشابهة لما سبق، من خلال هذا الحقل يمكن تحقيق الربط بين المهام.

## معالجة الأخطاء

عند استدعاء API، إذا واجهت أخطاء، سيقوم API بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:

* `400 token_mismatched`: طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
* `400 api_not_implemented`: طلب غير صالح، ربما بسبب معلمات مفقودة أو غير صالحة.
* `401 invalid_token`: غير مصرح، رمز تفويض غير صالح أو مفقود.
* `429 too_many_requests`: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
* `500 api_error`: خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

### مثال على استجابة الخطأ

```json theme={null}
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "فشل في جلب البيانات"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

## الاستنتاج

من خلال هذه الوثيقة، لقد تعرفت على كيفية استخدام واجهة برمجة تطبيقات توليد الفيديو من كليغ من خلال إدخال كلمات التلميح وصورة الإطار الأول المرجعية لتوليد الفيديو. نأمل أن تساعدك هذه الوثيقة في التواصل بشكل أفضل واستخدام هذه الواجهة. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.
