{ "aboutHtml": "

Runway Gen-4.5 هو نموذج لتوليد الفيديو بوضعَي النص إلى فيديو والصورة إلى فيديو. يستطيع اتباع متطلبات تصف تكوين المشهد وفعل الموضوع وتخطيط حركة الكاميرا وتسلسل الأحداث. والنتيجة المفيدة لقطة قصيرة مولّدة يمكن مراجعتها أو الاحتفاظ بها أو تجميعها مع لقطات أخرى.

اختر وضع الإدخال للقطة

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

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

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

صف المرئيات والحركة مباشرة

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

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

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

مصطلحات الكاميرا والفعل المتسلسل

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

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

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

المدة والأبعاد ومعدل الإطارات

يدعم Gen-4.5 مدد مقاطع من 2 إلى 10 ثوانٍ. يمكن للاختيار الأطول استيعاب أفعال مرتبة متعددة، بينما يمكن لرد فعل أو كشف وجيز استخدام لقطة أقصر. مخرجه الموثّق 720p، بمعدل 24 أو25 إطارًا في الثانية في سير عمل التوليد لدى الشركة المصنّعة.

تسرد مواصفات النص إلى فيديو نسبة 16:9 عند 1280 × 720 بكسل. وتسرد الصورة إلى فيديو أيضًا 9:16 عند 720 × 1280، و1:1 عند 960 × 960، و4:3 عند 1104 × 832، و3:4 عند 832 × 1104، و21:9 عند 1584 × 672. احتفظ بالوضع والأبعاد الفعلية معًا بدل افتراض أن وضعَي الإدخال يقدمان مجموعة نسب العرض نفسها.

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

ابنِ تسلسلًا أطول من لقطات مكتملة

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

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

احتفظ بمادة الإنتاج وراجعها

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

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

", "aboutText": "Runway Gen-4.5 هو نموذج لتوليد الفيديو بوضعَي النص إلى فيديو والصورة إلى فيديو. يستطيع اتباع متطلبات تصف تكوين المشهد وفعل الموضوع وتخطيط حركة الكاميرا وتسلسل الأحداث. والنتيجة المفيدة لقطة قصيرة مولّدة يمكن مراجعتها أو الاحتفاظ بها أو تجميعها مع لقطات أخرى.\n\n### اختر وضع الإدخال للقطة\n\nيبدأ النص إلى فيديو بوصف مكتوب للمشهد. ضمّن المحتوى المرئي والحركة معًا: الموضوع والمكان والإضاءة والتأطير والفعل وسلوك الكاميرا. يفيد هذا الوضع مشهدًا جديدًا أو لقطات مساندة أو لوحة خلفية أو مفهومًا بصريًا لا يلزم أن يعيد إطاره الأول صورة مقدّمة.\n\nيبدأ تحويل الصورة إلى فيديو بصورة تؤدي دور الإطار الأول. توفر تلك الصورة التكوين والموضوع والإضاءة والأسلوب. ركّز التوجيه المكتوب على ما ينبغي أن يحدث لاحقًا: فعل الموضوع والحركة في البيئة وحركة الكاميرا وتطور اللقطة.\n\nأعدّ صورة واضحة تظهر التفاصيل المهمة مسبقًا. قد تصبح الوجوه أو الأيدي الضبابية أو التشوهات الأخرى أوضح عند التحريك. وقد يتعارض مرجع يوحي بحركة سريعة عبر الغبار أو ضبابية حركة مع توجيه يطلب عنصرًا مصوّرًا ساكنًا.\n\n### صف المرئيات والحركة مباشرة\n\nاستخدم لغة طبيعية واضحة وأوصافًا إيجابية للنتيجة المقصودة. ويمكن لمتطلبات النص إلى فيديو ذكر منظور الكاميرا والموضوع والفعل أولًا، ثم إضافة معالجة المشهد. يفيد الوصف المفصل عندما تكون للقطة متطلبات محددة؛ ويتيح الأبسط مساحة أكبر للاستكشاف. لا يوجد عدد كلمات مثالي يعوّض الوضوح.\n\nمثلًا، صف منظرًا قريبًا لمصباح مكتب نحاسي يضيء، تتبعه حركة كاميرا بطيئة تكشف دفترًا بجواره. حدّد الخامات المرئية والضوء للنص إلى فيديو. وإذا كانت صورة مقدّمة تثبت تلك التفاصيل بالفعل، يستطيع توجيه الصورة إلى فيديو التركيز على تغير الضوء والكشف بالكاميرا.\n\nتجنب التوجيهات المتناقضة. يختلف المنظر المثبّت بحركة موضوع طفيفة عن لقطة تتبّع حيوية بكاميرا محمولة باليد. أضف التفاصيل التي تحدد اللقطة المفيدة بدل قائمة طويلة بأساليب بصرية غير مترابطة.\n\n### مصطلحات الكاميرا والفعل المتسلسل\n\nيميّز دليل الكاميرا لدى الشركة المصنّعة التأطير والزوايا والحركة والتركيز. تغيّر اللقطة القريبة ما يملأ الإطار، وتغيّر الزاوية المنخفضة المنظور، ويدير التحريك الأفقي مجال رؤية الكاميرا، وتتبع حركة التتبّع موضوعًا. وتنقل تعليمة rack-focus التركيز بين عناصر مرئية داخل المشهد. حدّد ما ينبغي رؤيته أو كشفه أثناء تطور الحركة.\n\nيمكن للتوجيهات المتسلسلة التعبير عن الأحداث بلغة عادية أو بطوابع زمنية تقريبية. توجه تلك الطوابع الترتيب والتوقيت التقريبي؛ ولا تضمن التنفيذ بدقة الإطار. امنح الأفعال المطلوبة وقتًا كافيًا لتحدث طبيعيًا ضمن مدة المقطع المختارة.\n\nللقطة ثابتة، صف الحركة التي تخص ما داخل الإطار وعزّز قصد الكاميرا الساكنة. تلاحظ الشركة المصنّعة صعوبة المناظر التي لا تتحرك إطلاقًا، خصوصًا بعض اللقطات الواسعة أو التأسيسية. راجع الحركات الصغيرة غير المرغوبة في النتيجة الفعلية بدل افتراض أن عبارة الكاميرا الثابتة تجعلها مستحيلة.\n\n### المدة والأبعاد ومعدل الإطارات\n\nيدعم Gen-4.5 مدد مقاطع من 2 إلى 10 ثوانٍ. يمكن للاختيار الأطول استيعاب أفعال مرتبة متعددة، بينما يمكن لرد فعل أو كشف وجيز استخدام لقطة أقصر. مخرجه الموثّق 720p، بمعدل 24 أو25 إطارًا في الثانية في سير عمل التوليد لدى الشركة المصنّعة.\n\nتسرد مواصفات النص إلى فيديو نسبة 16:9 عند 1280 × 720 بكسل. وتسرد الصورة إلى فيديو أيضًا 9:16 عند 720 × 1280، و1:1 عند 960 × 960، و4:3 عند 1104 × 832، و3:4 عند 832 × 1104، و21:9 عند 1584 × 672. احتفظ بالوضع والأبعاد الفعلية معًا بدل افتراض أن وضعَي الإدخال يقدمان مجموعة نسب العرض نفسها.\n\nيمكن لنسبة الصورة تحديد التكوين الافتراضي، وقد يؤدي تغييرها إلى اقتطاع المدخل. تحقّق من موضع الموضوع قبل الحكم على الحركة: فالفعل الصحيح غير مفيد إذا اقتُطع جزء أساسي من الصورة المصدر.\n\n### ابنِ تسلسلًا أطول من لقطات مكتملة\n\nللعمل الذي تقوده صورة، تصف الشركة المصنّعة استكمال تسلسل باستخدام آخر إطار لمقطع مكتمل مدخلَ صورةٍ لعملية توليد أخرى. ثم تُجمع المقاطع في محرّر فيديو مع معالجة الإطار المشترك وتوقيته أثناء التحرير. هذا تسلسل من لقطات منفصلة، لا توليد واحد غير محدود المدة.\n\nاحتفظ بإطار النهاية ومتطلباته المقابلة ليبدأ المقطع التالي من الحالة البصرية المقصودة. افحص الاستمرارية في اللقطات الموصولة، بما يشمل مظهر الموضوع واتجاه الكاميرا والانتقال بين المقاطع.\n\n### احتفظ بمادة الإنتاج وراجعها\n\nبعد التوليد، راجع المقطع كاملًا واحتفظ بالمخرج المكتمل. يوفر سير عمل الجهة المنتجة أيضًا خيارات منفصلة لرفع الدقة والتصدير الإنتاجي مثل ProRes أو تسلسل PNG. هذه خيارات إضافية للمسار؛ وتظل أبعاد التوليد الأصلية منفصلة عن نتيجة مكبّرة لاحقًا.\n\nاستخدم Gen-4.5 للمفاهيم السينمائية والأفكار البصرية المتحركة واللقطات المساندة وتطوير المشاهد القصيرة. احتفظ بالتوجيه والصورة المدخلة عند استخدامها والمدة والوضع والمقطع المُعاد معًا. تحقّق من ترتيب الأفعال وسلوك الكاميرا وتفاصيل الموضوع والقطعات غير المرغوبة والتأطير المقصود، ثم أجرِ تصحيحًا محددًا للقطة.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ebe049e989581edf31773c5a9629bf733c8906388512515c38a7bc139e1104eb", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
•

Runway: Gen-4.5

Runway /runway/gen-4.5

البداية

ينشئ Runway Gen-4.5 فيديوهات من وصف مشهد أو صورة مع توجيه حركة. تدعم مقاطعه ذات 2–10 ثوانٍ وتوجيهاته الصريحة للكاميرا واختيارات التكوين المنفصلة للنص إلى فيديو والصورة إلى فيديو المفاهيم السينمائية واللقطات المساندة والمشاهد البصرية المتحركة.

المدخلات المقبولة
النص · الصور
النتائج
فيديو
عن النموذج

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

Runway Gen-4.5 هو نموذج لتوليد الفيديو بوضعَي النص إلى فيديو والصورة إلى فيديو. يستطيع اتباع متطلبات تصف تكوين المشهد وفعل الموضوع وتخطيط حركة الكاميرا وتسلسل الأحداث. والنتيجة المفيدة لقطة قصيرة مولّدة يمكن مراجعتها أو الاحتفاظ بها أو تجميعها مع لقطات أخرى.

اختر وضع الإدخال للقطة

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

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

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

صف المرئيات والحركة مباشرة

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

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

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

مصطلحات الكاميرا والفعل المتسلسل

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

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

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

المدة والأبعاد ومعدل الإطارات

يدعم Gen-4.5 مدد مقاطع من 2 إلى 10 ثوانٍ. يمكن للاختيار الأطول استيعاب أفعال مرتبة متعددة، بينما يمكن لرد فعل أو كشف وجيز استخدام لقطة أقصر. مخرجه الموثّق 720p، بمعدل 24 أو25 إطارًا في الثانية في سير عمل التوليد لدى الشركة المصنّعة.

تسرد مواصفات النص إلى فيديو نسبة 16:9 عند 1280 × 720 بكسل. وتسرد الصورة إلى فيديو أيضًا 9:16 عند 720 × 1280، و1:1 عند 960 × 960، و4:3 عند 1104 × 832، و3:4 عند 832 × 1104، و21:9 عند 1584 × 672. احتفظ بالوضع والأبعاد الفعلية معًا بدل افتراض أن وضعَي الإدخال يقدمان مجموعة نسب العرض نفسها.

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

ابنِ تسلسلًا أطول من لقطات مكتملة

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

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

احتفظ بمادة الإنتاج وراجعها

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

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

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

Ailoot Ultra · فيديو POST /v1/videos
الإدخال
text, image
الإخراج
video
صيغة الإخراج
بايتات MP4 الأصلية؛ دون تطبيع أو إعادة ترميز
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
runway/gen-4.5
القيمة الافتراضية—
الحقلpromptالنوعstringالمتطلبمطلوبالقيم والحدودالقيمة الافتراضية—
الحقلdurationالنوعintegerالمتطلبمطلوبالقيم والحدود
⁦2⁩, ⁦3⁩, ⁦4⁩, ⁦5⁩, ⁦6⁩, ⁦7⁩, ⁦8⁩, ⁦9⁩, ⁦10⁩
الحد الأدنى: ⁦1⁩
الحد الأقصى: ⁦600⁩
القيمة الافتراضية—
الحقلresolutionالنوعstringالمتطلباختياريالقيم والحدود
720p
القيمة الافتراضية—
الحقلaspect_ratioالنوعstringالمتطلباختياريالقيم والحدود
16:9, 9:16
القيمة الافتراضية—
الحقلgenerate_audioالنوعbooleanالمتطلباختياريالقيم والحدود
false
القيمة الافتراضية—
الحقلframe_imagesالنوعarrayالمتطلباختياريالقيم والحدود
الحد الأدنى للعناصر: ⁦1⁩
الحد الأقصى للعناصر: ⁦1⁩
محتوى الإدخال: مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame_type على first_frame. لا يتكرر كل دور إطار أكثر من مرة.
المفاتيح الدقيقة: type, image_url, frame_type
الشروط: تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image_url إلا على url. احذف frame_images في الطلبات النصية فقط.
القيمة الافتراضية—
الحقلinput_referencesالنوعarrayالمتطلباختياريالقيم والحدودالقيمة الافتراضية—
الحقلsizeالنوعstringالمتطلباختياريالقيم والحدود
1280x720, 720x1280
النمط: ^[1-9][0-9]*x[1-9][0-9]*$
القيمة الافتراضية—
الحقلseedالنوعintegerالمتطلباختياريالقيم والحدود
الحد الأدنى: ⁦‎-9,223,372,036,854,775,808⁩
الحد الأقصى: ⁦9,223,372,036,854,775,807⁩
القيمة الافتراضية—
الحقلcallback_urlالنوعstringالمتطلباختياريالقيم والحدود
النمط: ^https://
القيمة الافتراضية—
الحقلsession_idالنوعstringالمتطلباختياريالقيم والحدودالقيمة الافتراضية—
الحقلtraceالنوعobjectالمتطلباختياريالقيم والحدودالقيمة الافتراضية—
الحقلuserالنوعstringالمتطلباختياريالقيم والحدودالقيمة الافتراضية—
تركيبات مواد الإدخال

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

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

model: النوع: string · runway/gen-4.5

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. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.

المفاتيح الدقيقة: type, image_url, frame_type

model: النوع: string · runway/gen-4.5

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, seed, 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 من الرموز
الإعداداتسعر الفيديوجدول التعرفة—الكمية المتوقعة—وحدة الفوترةلكل ثانية فيديوشروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا.الرسوم
الإخراج · سعر الفيديو · تقدير للمقارنة فقط $0.24 لكل ثانية فيديو
الإعداداتتكلفة التوليد التقديريةجدول التعرفة—الكمية المتوقعةتقدير لتوليد واحدوحدة الفوترة—شروط الفوترة—الرسوم
الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.48 تقدير قبل الإنشاء

هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

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

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

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

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

الإعداداتشروط الفوترةالرسوم
الإعداداتسعر الفيديوشروط الفوترةلم يُذكر شرط إضافي في مفتاح التسعير هذا.الرسوم
الإخراج · سعر الفيديو $0.24 لكل ثانية فيديو

مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته.

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

Ailoot Ultra · فيديو

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

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

Ailoot Ultra · فيديو

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

التحقق من حالة المهمة
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
عمليات أخرى لقراءة المحتوى
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
الاحتفاظ بكل النتائج المكتملة

احفظ كل فيديو مكتمل أو ملف مُرجع؛ ونزّل كل أصل من 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 runway/gen-4.5

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

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

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

runway/gen-4.5

", "method_identity": { "effective_request_model_id": "runway/gen-4.5", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|runway%2Fgen-4.5", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "الوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "تحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه.", "type": "not_found_error" }, { "condition": "مفتاح API لا يطابق الحساب الذي تمت المصادقة عليه.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "تحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال.", "type": "authentication_error" }, { "condition": "تعذرت قراءة الطلب، أو فهرس التنزيل غير صالح.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "صحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية.", "type": "invalid_request_error" }, { "condition": "يتعذر تسعير إعداد الفيديو المختار.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "اختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح.", "type": "price_unavailable" }, { "condition": "إدخال الفيديو أو مهمة المتابعة الأصلية غير صالح.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "استخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه.", "type": "invalid_request_error" }, { "condition": "الرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "تحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد.", "type": "billing_error" }, { "condition": "التحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "انتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى.", "type": "server_error" }, { "code": "result_pending_check", "condition": "تحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "احتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "تنزيل الفيديو الموجود غير متاح مؤقتاً.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "تحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة.", "type": "server_error" }, { "condition": "لم يُنشر محتوى الفيديو.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "تحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.", "required": [ "model", "prompt", "duration" ], "required_material": "موجّه نصي." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "موجّه نصي وصورة للإطار الأول." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "موضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "عنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "بصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "حجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "مدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "عرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "معرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "ما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "معرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "عناوين URL موقّعة لمحتوى مملوك لك", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image_url إلا على url. احذف frame_images في الطلبات النصية فقط.", "content": "مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame_type على first_frame. لا يتكرر كل دور إطار أكثر من مرة.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "تكلفة التوليد التقديرية", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "runway/gen-4.5", "nativeProvenance": { "input_facts_canonical_sha256": "5b271e0c2361947453eb964e328d7f181ccafad3340d858127679f408f2de99f", "input_html_sha256": "7824afde6526e3d99f1fa4f1d2df563a04eedd879026dac8be5a3a37d77c140f", "private_audit_sha256": "c08ce49c38f3bf85fcc3e3d87a15d0e98cfe9caae201f6252d6da44dce4edb72", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ar/runway-gen-4-5/", "description": "ينشئ Runway Gen-4.5 فيديوهات من وصف مشهد أو صورة مع توجيه حركة. تدعم مقاطعه ذات 2–10 ثوانٍ وتوجيهاته الصريحة للكاميرا واختيارات التكوين المنفصلة للنص إلى فيديو والصورة إلى فيديو المفاهيم السينمائية واللقطات المساندة والمشاهد البصرية المتحركة.", "locale": "ar", "md_url": "https://ailoot.ai/models/ar/runway-gen-4-5/index.md", "title": "Runway: Gen-4.5 — Ailoot", "url": "https://ailoot.ai/models/ar/runway-gen-4-5/" }, "rawModel": { "about": "Runway Gen-4.5 هو نموذج لتوليد الفيديو بوضعَي النص إلى فيديو والصورة إلى فيديو. يستطيع اتباع متطلبات تصف تكوين المشهد وفعل الموضوع وتخطيط حركة الكاميرا وتسلسل الأحداث. والنتيجة المفيدة لقطة قصيرة مولّدة يمكن مراجعتها أو الاحتفاظ بها أو تجميعها مع لقطات أخرى.\n\n### اختر وضع الإدخال للقطة\n\nيبدأ النص إلى فيديو بوصف مكتوب للمشهد. ضمّن المحتوى المرئي والحركة معًا: الموضوع والمكان والإضاءة والتأطير والفعل وسلوك الكاميرا. يفيد هذا الوضع مشهدًا جديدًا أو لقطات مساندة أو لوحة خلفية أو مفهومًا بصريًا لا يلزم أن يعيد إطاره الأول صورة مقدّمة.\n\nيبدأ تحويل الصورة إلى فيديو بصورة تؤدي دور الإطار الأول. توفر تلك الصورة التكوين والموضوع والإضاءة والأسلوب. ركّز التوجيه المكتوب على ما ينبغي أن يحدث لاحقًا: فعل الموضوع والحركة في البيئة وحركة الكاميرا وتطور اللقطة.\n\nأعدّ صورة واضحة تظهر التفاصيل المهمة مسبقًا. قد تصبح الوجوه أو الأيدي الضبابية أو التشوهات الأخرى أوضح عند التحريك. وقد يتعارض مرجع يوحي بحركة سريعة عبر الغبار أو ضبابية حركة مع توجيه يطلب عنصرًا مصوّرًا ساكنًا.\n\n### صف المرئيات والحركة مباشرة\n\nاستخدم لغة طبيعية واضحة وأوصافًا إيجابية للنتيجة المقصودة. ويمكن لمتطلبات النص إلى فيديو ذكر منظور الكاميرا والموضوع والفعل أولًا، ثم إضافة معالجة المشهد. يفيد الوصف المفصل عندما تكون للقطة متطلبات محددة؛ ويتيح الأبسط مساحة أكبر للاستكشاف. لا يوجد عدد كلمات مثالي يعوّض الوضوح.\n\nمثلًا، صف منظرًا قريبًا لمصباح مكتب نحاسي يضيء، تتبعه حركة كاميرا بطيئة تكشف دفترًا بجواره. حدّد الخامات المرئية والضوء للنص إلى فيديو. وإذا كانت صورة مقدّمة تثبت تلك التفاصيل بالفعل، يستطيع توجيه الصورة إلى فيديو التركيز على تغير الضوء والكشف بالكاميرا.\n\nتجنب التوجيهات المتناقضة. يختلف المنظر المثبّت بحركة موضوع طفيفة عن لقطة تتبّع حيوية بكاميرا محمولة باليد. أضف التفاصيل التي تحدد اللقطة المفيدة بدل قائمة طويلة بأساليب بصرية غير مترابطة.\n\n### مصطلحات الكاميرا والفعل المتسلسل\n\nيميّز دليل الكاميرا لدى الشركة المصنّعة التأطير والزوايا والحركة والتركيز. تغيّر اللقطة القريبة ما يملأ الإطار، وتغيّر الزاوية المنخفضة المنظور، ويدير التحريك الأفقي مجال رؤية الكاميرا، وتتبع حركة التتبّع موضوعًا. وتنقل تعليمة rack-focus التركيز بين عناصر مرئية داخل المشهد. حدّد ما ينبغي رؤيته أو كشفه أثناء تطور الحركة.\n\nيمكن للتوجيهات المتسلسلة التعبير عن الأحداث بلغة عادية أو بطوابع زمنية تقريبية. توجه تلك الطوابع الترتيب والتوقيت التقريبي؛ ولا تضمن التنفيذ بدقة الإطار. امنح الأفعال المطلوبة وقتًا كافيًا لتحدث طبيعيًا ضمن مدة المقطع المختارة.\n\nللقطة ثابتة، صف الحركة التي تخص ما داخل الإطار وعزّز قصد الكاميرا الساكنة. تلاحظ الشركة المصنّعة صعوبة المناظر التي لا تتحرك إطلاقًا، خصوصًا بعض اللقطات الواسعة أو التأسيسية. راجع الحركات الصغيرة غير المرغوبة في النتيجة الفعلية بدل افتراض أن عبارة الكاميرا الثابتة تجعلها مستحيلة.\n\n### المدة والأبعاد ومعدل الإطارات\n\nيدعم Gen-4.5 مدد مقاطع من 2 إلى 10 ثوانٍ. يمكن للاختيار الأطول استيعاب أفعال مرتبة متعددة، بينما يمكن لرد فعل أو كشف وجيز استخدام لقطة أقصر. مخرجه الموثّق 720p، بمعدل 24 أو25 إطارًا في الثانية في سير عمل التوليد لدى الشركة المصنّعة.\n\nتسرد مواصفات النص إلى فيديو نسبة 16:9 عند 1280 × 720 بكسل. وتسرد الصورة إلى فيديو أيضًا 9:16 عند 720 × 1280، و1:1 عند 960 × 960، و4:3 عند 1104 × 832، و3:4 عند 832 × 1104، و21:9 عند 1584 × 672. احتفظ بالوضع والأبعاد الفعلية معًا بدل افتراض أن وضعَي الإدخال يقدمان مجموعة نسب العرض نفسها.\n\nيمكن لنسبة الصورة تحديد التكوين الافتراضي، وقد يؤدي تغييرها إلى اقتطاع المدخل. تحقّق من موضع الموضوع قبل الحكم على الحركة: فالفعل الصحيح غير مفيد إذا اقتُطع جزء أساسي من الصورة المصدر.\n\n### ابنِ تسلسلًا أطول من لقطات مكتملة\n\nللعمل الذي تقوده صورة، تصف الشركة المصنّعة استكمال تسلسل باستخدام آخر إطار لمقطع مكتمل مدخلَ صورةٍ لعملية توليد أخرى. ثم تُجمع المقاطع في محرّر فيديو مع معالجة الإطار المشترك وتوقيته أثناء التحرير. هذا تسلسل من لقطات منفصلة، لا توليد واحد غير محدود المدة.\n\nاحتفظ بإطار النهاية ومتطلباته المقابلة ليبدأ المقطع التالي من الحالة البصرية المقصودة. افحص الاستمرارية في اللقطات الموصولة، بما يشمل مظهر الموضوع واتجاه الكاميرا والانتقال بين المقاطع.\n\n### احتفظ بمادة الإنتاج وراجعها\n\nبعد التوليد، راجع المقطع كاملًا واحتفظ بالمخرج المكتمل. يوفر سير عمل الجهة المنتجة أيضًا خيارات منفصلة لرفع الدقة والتصدير الإنتاجي مثل ProRes أو تسلسل PNG. هذه خيارات إضافية للمسار؛ وتظل أبعاد التوليد الأصلية منفصلة عن نتيجة مكبّرة لاحقًا.\n\nاستخدم Gen-4.5 للمفاهيم السينمائية والأفكار البصرية المتحركة واللقطات المساندة وتطوير المشاهد القصيرة. احتفظ بالتوجيه والصورة المدخلة عند استخدامها والمدة والوضع والمقطع المُعاد معًا. تحقّق من ترتيب الأفعال وسلوك الكاميرا وتفاصيل الموضوع والقطعات غير المرغوبة والتأطير المقصود، ثم أجرِ تصحيحًا محددًا للقطة.", "alias_of": null, "aliases": [], "author": "Runway", "available": null, "canonical_model": "runway/gen-4.5", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "التسعير الكامل للتكوين في التفاصيل." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "cb4a8a486aaac9d58ece6322", "label": "مراجع أسعار إعدادات الفيديو", "profiles": [ { "basis": "مرجع السعر المنشور للإعداد المعروض. تتبع الرسوم النهائية الإعداد الفعلي الذي تمت فوترته.", "dimensions": { "conditions": "لم يُذكر شرط إضافي في مفتاح التسعير هذا." }, "label": "سعر الفيديو", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "runway/gen-4.5", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "احتفظ بكل مخرج فعلي مملوك لك وبالبيانات الوصفية المقاسة المُعادة معه.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "الوصول إلى الفيديو غير متاح، أو لم يُعثر على معرّف الفيديو هذا.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "تحقق من الوصول إلى الفيديو. للفيديو الموجود، استخدم معرّفه العام الأصلي ومفتاح API نفسه.", "type": "not_found_error" }, { "condition": "مفتاح API لا يطابق الحساب الذي تمت المصادقة عليه.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "تحقق من مفتاح API وإمكانية وصول حسابك قبل الإرسال.", "type": "authentication_error" }, { "condition": "تعذرت قراءة الطلب، أو فهرس التنزيل غير صالح.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "صحّح متن الطلب. للتنزيل، اختر فهرس مخرج أعادته المهمة الأصلية.", "type": "invalid_request_error" }, { "condition": "يتعذر تسعير إعداد الفيديو المختار.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "اختر إعداد فيديو مدعوماً وأكمل خياراته المطلوبة قبل إرسال طلب مصحح.", "type": "price_unavailable" }, { "condition": "إدخال الفيديو أو مهمة المتابعة الأصلية غير صالح.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "استخدم مدخلات HTTPS صالحة. للمتابعة، استخدم المعرّف العام للفيديو الأصلي المكتمل لديك مع مفتاح API نفسه.", "type": "invalid_request_error" }, { "condition": "الرصيد المتاح أو الحدود المقررة لا تسمح بحجز الرصيد.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "تحقق من رصيدك المتاح وحدودك قبل إرسال طلب جديد.", "type": "billing_error" }, { "condition": "التحقق من الفيديو أو التخزين أو الوصول إلى الخدمة غير متاح مؤقتاً.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "انتظر إتاحة الخدمة. إذا كان لديك معرّف فيديو بالفعل، فتحقق من تلك المهمة الأصلية بدلاً من إنشاء عملية توليد أخرى.", "type": "server_error" }, { "code": "result_pending_check", "condition": "تحتاج نتيجة الفيديو الأصلية والرسم المحتسب إلى التحقق.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "احتفظ بمعرّف الفيديو المُعاد وتحقق من تلك المهمة. لا ترسل طلب توليد بديل أثناء التحقق منها.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "تنزيل الفيديو الموجود غير متاح مؤقتاً.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "تحقق من مهمة الفيديو نفسها لاحقاً ونزّل مخرجها الموجود. ينشئ التوليد الجديد عملية منفصلة.", "type": "server_error" }, { "condition": "لم يُنشر محتوى الفيديو.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "تحقق من حالة المهمة الأصلية. نزّل المخرجات بعد أن تُبلِغ عن completed؛ وإذا أبلغت عن failed، فاتبع إشعارها المتعلق بالتحقق من الرسم المحتسب.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + المعرّف الأصلي + X-Should-Retry:false؛ لا تعِد تنفيذ العملية الأصلية مطلقاً" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "قدّم prompt كنص وduration بعدد صحيح من الثواني. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.", "required": [ "model", "prompt", "duration" ], "required_material": "موجّه نصي." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "runway/gen-4.5" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "الحقل frame_images مصفوفة. يحتوي كل كائن إطار على type وimage_url وframe_type؛ ويحتوي image_url على url. اضبط type على image_url. استخدم first_frame. لا يتكرر كل دور إطار أكثر من مرة. وفّر عنوان URL عاماً لصورة عبر HTTPS لكل إطار. اختر دقة مدعومة؛ وأضف نسبة أبعاد أو استخدم مقاساً مدرجاً.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "موجّه نصي وصورة للإطار الأول." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "موضع هذا الفيديو في قائمة المخرجات، بدءاً من الصفر.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "عنوان URL موقّع عبر HTTPS لتنزيل هذا الفيديو المكتمل.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "بصمة SHA-256 لبايتات الفيديو الأصلي؛ وتكون القيمة null إذا لم تتوفر.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "حجم ملف الفيديو الأصلي بالبايت؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "مدة الفيديو المقاسة بالمللي ثانية؛ وتكون القيمة null إذا لم تتوفر.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "عرض الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "ارتفاع الفيديو بالبكسل؛ وتكون القيمة null إذا لم يتوفر.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "معرّف ترميز الفيديو؛ وتكون القيمة null إذا لم يُسجَّل.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "ما إذا كان الفيديو يحتوي على مسار صوتي؛ وتكون القيمة null إذا لم يُقَس ذلك.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "معرّف ترميز الصوت؛ وتكون القيمة null إذا لم يُسجَّل معرّف.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "عناوين URL موقّعة لمحتوى مملوك لك", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "runway/gen-4.5" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "runway/gen-4.5" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "تصف هذه المفاتيح كل كائن إطار؛ ولا يحتوي image_url إلا على url. احذف frame_images في الطلبات النصية فقط.", "content": "مصفوفة من كائنات الإطارات. يحتوي كل كائن على type=image_url وimage_url الذي يحتوي على url، وعلى frame_type. استخدم عنوان URL لصورة عبر HTTPS واضبط frame_type على first_frame. لا يتكرر كل دور إطار أكثر من مرة.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 1, "max_items": 1, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 2, 3, 4, 5, 6, 7, 8, 9, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "runway/gen-4.5" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "تكلفة التوليد التقديرية", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"aspect_ratio\":\"16:9\",\"duration\":8,\"model\":\"runway/gen-4.5\",\"prompt\":\"A serene mountain landscape at sunset\",\"resolution\":\"720p\"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "runway/gen-4.5", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.24", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "cents_per_second_output", "label": "Video price", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "0.48", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.48", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "runway/gen-4.5", "request_model_id": "runway/gen-4.5", "route_label": "Ultra" } ], "name": "Runway: Gen-4.5", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.48, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.48, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "credit_usd": "0.01", "credits_per_second": "12" }, "label": "Ultra", "units": [ { "amount": "0.24", "amount_unit": "usd_per_output_video_second", "conditions": { "credit_usd": "0.01", "credits_per_second": "12" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.10", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "prores_or_png_sequence", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.40", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_up_to_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 2, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "label": "Ultra", "units": [ { "amount": "0.80", "amount_unit": "usd_per_output_video_second", "conditions": { "format_class": "10bit_or_hdr_above_4mp", "surcharge_adds_to_model_base": true }, "key": "base", "label": "base", "profile_index": 3, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "output_video_second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.24", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD_cent", "billing_original_rate": "24", "key": "cents_per_second_output", "label": "output second", "native_amount_usd_per_unit": "0.24", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "runway/gen-4.5", "short": "ينشئ Runway Gen-4.5 فيديوهات من وصف مشهد أو صورة مع توجيه حركة. تدعم مقاطعه ذات 2–10 ثوانٍ وتوجيهاته الصريحة للكاميرا واختيارات التكوين المنفصلة للنص إلى فيديو والصورة إلى فيديو المفاهيم السينمائية واللقطات المساندة والمشاهد البصرية المتحركة." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "ينشئ Runway Gen-4.5 فيديوهات من وصف مشهد أو صورة مع توجيه حركة. تدعم مقاطعه ذات 2–10 ثوانٍ وتوجيهاته الصريحة للكاميرا واختيارات التكوين المنفصلة للنص إلى فيديو والصورة إلى فيديو المفاهيم السينمائية واللقطات المساندة والمشاهد البصرية المتحركة.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "469f53a2fad6e87116b48a5fd2c571de81f436e3e74feec10a9a0d3e1cd51972", "raw_model_js_projection_sha256": "c785b9eea18ed3fa9fe7cc1dd658f6fe474a448a99d001e835c5e61394043852", "raw_model_json_sha256": "469f53a2fad6e87116b48a5fd2c571de81f436e3e74feec10a9a0d3e1cd51972", "renderer_sha256": "081ee0fd5b6b1b60564b02c52d62547e01e922c8c0a16e91a0d055073e76a10e" }, "sourceRevision": "f59c281ba7764c42460c8bff2d2e93928a61079f8f4caade8bde7af44c303c1b" }