Source: https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/
Canonical: https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/
Language: ar

# Kling: Video v3.0 Standard

[Markdown](https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/index.md) · [JSON](https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/facts.json)

## [Kling: Video v3.0 Standard](https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/)

Kling VIDEO 3.0 Standard هو نمط الفيديو بدقة 720p من Kuaishou لمتطلبات النص والصور. أنشئ مشاهد من ثلاث إلى خمس عشرة ثانية بصوت أصلي ومراجع للعناصر المصوّرة وتوجيه بإطارَي البداية والنهاية وسرد بلقطة واحدة أو لقطات متعددة.

- [**Ailoot Ultra · فيديو** `POST /v1/videos` `kwaivgi/kling-v3.0-std`](https://ailoot.ai/models/ar/kwaivgi-kling-v3-0-std/#method-0)

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Kling VIDEO 3.0 Standard هو نمط Kuaishou بدقة 720p لتوليد مشهد فيديو من نص أو صورة مقدّمة. يستخدم الصوت الأصلي ومراجع العناصر المصوّرة والسرد متعدد اللقطات في إصدار VIDEO 3.0، مع مدة مقطع مرنة من ثلاث إلى خمس عشرة ثانية. يفيد هذا النمط تطوير اتجاه بصري أو معاينة سرد قصير أو إنشاء مشهد موجز بفعل وصوت محددين.

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

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

يمكن للوحة قصة قصيرة أن تبدأ بمنظر للمكان وتنتقل إلى الفعل وتنتهي بالتفصيل الذي يشرح النتيجة. حدّد الموضوع الباقي في كل لقطة وكيف يتغير التأطير. يستطيع الوضع التلقائي تكييف التغطية للمشهد، بينما يمنح التسلسل المخصص تعليمات صريحة لأجزائه المنفصلة. ويقبل التوجيه المفرد العادي حتى 2,500 حرف في مرجع الشركة المصنّعة.

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

يمكن لإطارَي البداية والنهاية توجيه انتقال مشروط بصورة نحو تكوين نهائي مطلوب. استخدم إطارات تنقل اتصالًا معقولًا وصف الفعل بينها. تقبل مواصفات الصور لدى الشركة المصنّعة JPG وJPEG وPNG، لا تزيد عن 10 MB وبأبعاد لا تقل عن 300 بكسل؛ ويجب أن تقع نسبة عرض صورة البداية بين 1:2.5 و2.5:1. أعدّ مواد الإطارات لتلك المهمة بدل اعتبار وصف لوحة قصة حزمة إدخال قابلة للاستبدال معها.

يستطيع نمط Standard توليد صوت أصلي عند تفعيل ذلك الوضع؛ ويعطّل مرجع الشركة المصنّعة الصوت افتراضيًا. صف العبارات المنطوقة والأجواء والصوت ذي الصلة جزءًا من المشهد. يدعم VIDEO 3.0 معالجة الكلام بالصينية والإنجليزية واليابانية والكورية والإسبانية، بما يشمل التبديل بين اللغات واللكنات أو اللهجات المدعومة. ويذكر دليل الشركة المصنّعة أن الحوار المدخل بلغة أخرى يُترجم إلى الإنجليزية. اجعل الشخصية المتحدثة واضحةً في مشهد متعدد الشخصيات وأبقِ الكلمات قصيرة بما يكفي للأداء المقصود.

يمكن لمتطلبات حوار أصلية إسناد عبارة إلى Speaker A ورد فعل مرئي إلى Speaker B وتغير منظور يتبع التبادل. صف صوت المكان منفصلًا عن الحوار كي لا يصبح تأثير خلفي تعليمة كلام ملتبسة. استخدم المراجع لتحديد مظهر العناصر المصوّرة والنص لتحديد ما تفعل وتقوله.

الحروف المرئية جزء آخر من مسار 3.0. قد تحتوي الصورة المصدر لافتة أو تعليقًا أو ملصق منتج يهم مظهره أثناء التحريك. عرّف ذلك النص ودوره في المشهد ثم افحص النتيجة للتهجئة والوضوح والثبات. ولمادة حملة قصيرة، اجعل الرسالة المهمة بارزة في التكوين بدل الاعتماد على ملصق صغير جدًا في الخلفية.

إخراج Standard هو 720p. وPro نمط 1080p يُختار بصورة منفصلة، و4K الأصلي وضع آخر لدى الجهة المنتجة بدل أن يكون إعداد Standard تلقائيًا. تشمل اختيارات نسبة العرض للنص 16:9 و9:16 و1:1. اختر الصيغة والتأطير للموضع المقصود، ثم حافظ على ذلك الاتجاه البصري أثناء مقارنة تغيرات الفعل أو الضوء أو ترتيب اللقطات.

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

**Ailoot Ultra · فيديو** `POST /v1/videos` `kwaivgi/kling-v3.0-std`

[`kwaivgi/kling-v3.0-std`](https://ailoot.ai/models/ar/#m=kwaivgi%2Fkling-v3.0-std&route=Ultra&caller=kwaivgi%2Fkling-v3.0-std&fmt=videos)

Kuaishou /`kwaivgi/kling-v3.0-std`

### البداية

Kling VIDEO 3.0 Standard هو نمط الفيديو بدقة 720p من Kuaishou لمتطلبات النص والصور. أنشئ مشاهد من ثلاث إلى خمس عشرة ثانية بصوت أصلي ومراجع للعناصر المصوّرة وتوجيه بإطارَي البداية والنهاية وسرد بلقطة واحدة أو لقطات متعددة.

المدخلات المقبولة

النص · الصور

النتائج

فيديو

### متاح في Ailoot · المدخلات والطرائق

**Ailoot Ultra · فيديو** `POST /v1/videos`

الإدخال

`text`, `image`

الإخراج

`video`

صيغة الإخراج

بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز

| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
| --- | --- | --- | --- | --- |
| الحقل`model` | النوع`string` | المتطلبمطلوب | القيم والحدود kwaivgi/kling-v3.0-std | القيمة الافتراضية— |
| الحقل`prompt` | النوع`string` | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
| الحقل`duration` | النوع`integer` | المتطلبمطلوب | القيم والحدود ⁦3⁩, ⁦4⁩, ⁦5⁩, ⁦6⁩, ⁦7⁩, ⁦8⁩, ⁦9⁩, ⁦10⁩, ⁦11⁩, ⁦12⁩, ⁦13⁩, ⁦14⁩, ⁦15⁩ الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦600⁩ | القيمة الافتراضية— |
| الحقل`resolution` | النوع`string` | المتطلباختياري | القيم والحدود 720p | القيمة الافتراضية— |
| الحقل`aspect_ratio` | النوع`string` | المتطلباختياري | القيم والحدود 16:9, 9:16, 1:1 | القيمة الافتراضية— |
| الحقل`generate_audio` | النوع`boolean` | المتطلباختياري | القيم والحدود false, true الشروط: يؤدي حذف هذا الخيار إلى اختيار السعر الذي يتضمن الصوت. اضبطه على false لاختيار السعر دون صوت. افحص has\_audio في النتيجة لمعرفة ما إذا أُعيد مسار صوتي. | القيمة الافتراضية— |
| الحقل`frame_images` | النوع`array` | المتطلباختياري | القيم والحدود الحد الأدنى للعناصر: ⁦1⁩ الحد الأقصى للعناصر: ⁦2⁩ محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image\_url وimage\_url الذي يحتوي على url، وعلى frame\_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame\_type على first\_frame أو last\_frame. لا يتكرر كل دور إطار أكثر من مرة. المفاتيح الدقيقة: type, image\_url, frame\_type الشروط: تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image\_url إلا على url. احذف frame\_images في الطلبات النصية فقط. | القيمة الافتراضية— |
| الحقل`input_references` | النوع`array` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
| الحقل`size` | النوع`string` | المتطلباختياري | القيم والحدود 1280x720, 720x1280, 720x720 النمط: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | القيمة الافتراضية— |
| الحقل`callback_url` | النوع`string` | المتطلباختياري | القيم والحدود النمط: ^https:// | القيمة الافتراضية— |
| الحقل`session_id` | النوع`string` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
| الحقل`trace` | النوع`object` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |
| الحقل`user` | النوع`string` | المتطلباختياري | القيم والحدود | القيمة الافتراضية— |

تركيبات مواد الإدخال

**تحويل النص إلى فيديو** · موجّه نصي. · مطلوب: model, prompt, duration

`قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.`

`model`: النوع: string · kwaivgi/kling-v3.0-std

`prompt`: النوع: string · الحد الأقصى لبايتات UTF-8: ⁦10,000⁩ · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم

**تحويل الصورة إلى فيديو** · موجّه نصي وصورة للإطار الأول. · مطلوب: model, prompt, duration, frame\_images

`الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame مع last_frame اختياري. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.`

المفاتيح الدقيقة: type, image\_url, frame\_type

`model`: النوع: string · kwaivgi/kling-v3.0-std

`prompt`: النوع: string · الحد الأقصى لبايتات UTF-8: ⁦10,000⁩ · يجب أن يتضمن الإدخال محارف غير المسافات البيضاء: نعم

معلمات الطريقة ودورة حياتها

| المعلمة | المواصفات |
| --- | --- |
| المعلمة`content_type` | المواصفاتapplication/json |
| المعلمة`required` | المواصفاتmodel, prompt, duration |
| المعلمة`material_types` | المواصفاتtext, image |
| المعلمة`additional_properties` | المواصفاتfalse |
| المعلمة`optional_controls` | المواصفاتresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, callback\_url, session\_id, trace, user |

دورة الحياة: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### الباقات

##### كيفية احتساب الرسوم النهائية

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

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع

غير محدد عند اختيار الوضع السريع

الوضع المرن

غير محدد عند اختيار وضع flex

أقصى جهد للاستدلال

غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

#### تعرفات تقديرية للمقارنة

#### الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

| الإعدادات | جدول التعرفة | الكمية المتوقعة | مكوّن الرسوم | دقة المرجع | وضع المرجع | الصوت المرجعي | وحدة الفوترة | شروط الفوترة | الرسوم |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| الإعداداتالتعرفات الأساسية للرموز | جدول التعرفةالتعرفة الأساسية | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط **—** / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط **—** / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط **—** / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط **—** / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط **—** / 1K من الرموز |
| الإعداداتمخرجات الفيديو · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم`reference_output_rate` | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط **$0.168** لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةالصوت: with\_audio | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط **$0.252** لكل ثانية فيديو |
| الإعداداتتحويل الصورة إلى فيديو (صور الإطارات) · 1080p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم`reference_output_rate` | دقة المرجع1080p | وضع المرجعتحويل الصور إلى فيديو (صور الإطارات) | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط **$0.168** لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: image\_to\_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط **$0.168** لكل ثانية فيديو |
| الإعداداتتحويل النص إلى فيديو · 1080p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم`reference_output_rate` | دقة المرجع1080p | وضع المرجعتحويل النص إلى فيديو | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط **$0.168** لكل ثانية إخراج |
| الإعداداتتحويل النص إلى فيديو · 480p · السعر المرجعي | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم`reference_output_rate` | دقة المرجع480p | وضع المرجعتحويل النص إلى فيديو | الصوت المرجعيمن دون صوت | وحدة الفوترةلكل ثانية إخراج | شروط الفوترة— | الرسوم الإخراج · التعرفة المرجعية لثانية من الفيديو الناتج · تقدير للمقارنة فقط **$0.168** لكل ثانية إخراج |
| الإعداداتسعر الفيديو | جدول التعرفة— | الكمية المتوقعة— | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترةلكل ثانية فيديو | شروط الفوترةنمط التوليد: text\_to\_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو · تقدير للمقارنة فقط **$0.168** لكل ثانية فيديو |
| الإعداداتتكلفة التوليد التقديرية | جدول التعرفة— | الكمية المتوقعةتقدير لتوليد واحد | مكوّن الرسوم— | دقة المرجع— | وضع المرجع— | الصوت المرجعي— | وحدة الفوترة— | شروط الفوترة— | الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط **$0.504** تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة. |

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. [كيفية عمل حجز المبلغ وتسوية الرسوم →](https://ailoot.ai/docs/ar/billing/reserve/)

#### تفاصيل التعرفة المرجعية

لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.

مراجع أسعار إعدادات الفيديو

#### الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

| الإعدادات | شروط الفوترة | الرسوم |
| --- | --- | --- |
| الإعداداتسعر الفيديو | شروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا. | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةالصوت: with\_audio | الرسوم الإخراج · سعر الفيديو **$0.252** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text\_to\_video؛ الدقة: 480p | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text\_to\_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: image\_to\_video؛ الدقة: 720p | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: text\_to\_video؛ الدقة: 1080p | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |
| الإعداداتسعر الفيديو | شروط الفوترةنمط التوليد: image\_to\_video؛ الدقة: 1080p | الرسوم الإخراج · سعر الفيديو **$0.168** لكل ثانية فيديو مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته. |

### أمثلة للطلبات

#### Ailoot Ultra · فيديو

curl · أنشئ فيديو

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-std","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### استلام النتائج وحفظها

#### Ailoot Ultra · فيديو

عناوين URL موقّعة لمحتوى مملوك لك

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### التحقق من حالة المهمة

GET · جلب حالة العملية الأصلية

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

عمليات أخرى لقراءة المحتوى

حفظ كل المخرجات المكتملة المملوكة لك

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من URL الخاص به الذي تم إرجاعه فعليًا.

احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.

##### عند الحاجة إلى التحقق من الاستجابة الأصلية

503 result\_pending\_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً

حقول الاستجابة

| الحقل | النوع | المعنى |
| --- | --- | --- |
| الحقل`index` | النوعinteger | المعنىموضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر. |
| الحقل`content_url` | النوعstring | المعنىعنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل. |
| الحقل`sha256` | النوعstring \| null | المعنىبصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر. |
| الحقل`size_bytes` | النوعinteger \| null | المعنىحجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر. |
| الحقل`duration_ms` | النوعinteger \| null | المعنىمدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر. |
| الحقل`width` | النوعinteger \| null | المعنىعرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
| الحقل`height` | النوعinteger \| null | المعنىارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر. |
| الحقل`video_codec` | النوعstring \| null | المعنىمعرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل. |
| الحقل`has_audio` | النوعboolean \| null | المعنىما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك. |
| الحقل`audio_codec` | النوعstring \| null | المعنىمعرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف. |

الأخطاء والخطوات التالية

| الاستجابة | الشرط | الخطوة التالية |
| --- | --- | --- |
| الاستجابة⁦404⁩ · `not_found_error` | الشرطالوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا. | الخطوة التاليةتحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه. |
| الاستجابة⁦401⁩ · `authentication_error` | الشرطمفتاح API لا يطابق الحساب الذي تمت المصادقة عليه. | الخطوة التاليةتحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال. |
| الاستجابة⁦400⁩ · `invalid_request_error` | الشرطتعذرت قراءة الطلب، أو فهرس التنزيل غير صالح. | الخطوة التاليةصحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية. |
| الاستجابة⁦422⁩ · `price_unavailable` | الشرطيتعذر تسعير إعداد الفيديو المختار. | الخطوة التاليةاختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح. |
| الاستجابة⁦422⁩ · `invalid_request_error` | الشرطإدخال الفيديو أو مهمة المتابعة الأصلية غير صالح. | الخطوة التاليةاستخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه. |
| الاستجابة⁦402⁩ · `billing_error` | الشرطالرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد. | الخطوة التاليةتحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد. |
| الاستجابة⁦503⁩ · `server_error` | الشرطالتحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً. | الخطوة التاليةانتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى. |
| الاستجابة⁦503⁩ · `result_pending_check` | الشرطتحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق. | الخطوة التاليةاحتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها. |
| الاستجابة⁦503⁩ · `owned_result_unavailable` | الشرطتنزيل الفيديو الموجود غير متاح مؤقتاً. | الخطوة التاليةتحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة. |
| الاستجابة⁦409⁩ · `video_not_ready` | الشرطلم يُنشر محتوى الفيديو. | الخطوة التاليةتحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب. |

### الأسماء البديلة

#### الأسماء البديلة للنموذج

**Ailoot Ultra** [`kwaivgi/kling-v3.0-std`](https://ailoot.ai/models/ar/#m=kwaivgi%2Fkling-v3.0-std&route=Ultra&caller=kwaivgi%2Fkling-v3.0-std&fmt=videos)

#### الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

#### معرّفات النماذج ذات الصلة IDs

[`kwaivgi/kling-v3.0-std`](https://ailoot.ai/models/ar/#m=kwaivgi%2Fkling-v3.0-std&route=Ultra&caller=kwaivgi%2Fkling-v3.0-std&fmt=videos)

FAQ · Kling: Video v3.0 Standard

ما المدخلات والنتائج المتاحة؟

`POST /v1/videos` · `kwaivgi/kling-v3.0-std`: `text`, `image` → `video`

ما الحقول التي يستخدمها الطلب؟

`POST /v1/videos` · `kwaivgi/kling-v3.0-std`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `callback_url`, `session_id`, `trace`, `user`

ما الحدود المطبقة؟

`POST /v1/videos` · `kwaivgi/kling-v3.0-std`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

## الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

## اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك

اختر خطة بخصم لطلباتك المنتظمة.

رمز خصم حتى 50%

أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.

المصروفات في السجل

يحفظ النموذج والرموز والمبلغ لكل طلب.

[اختر اشتراكا](https://ailoot.ai/docs/ar/billing/subscriptions/) · [اعرض أسعار النماذج](https://ailoot.ai/models/ar/)

## اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري

أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.

ترخيص إعادة البيع

أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.

المستندات على الموقع

العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

[اطلب ترخيص إعادة بيع](mailto:support@ailoot.ai) · [العرض واتفاقية الترخيص](https://ailoot.ai/legal/offer?lang=ar)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.