إنشاء وسائط غير متزامنة
قم بإنشاء مهام للصور أو مقاطع الفيديو أو الموسيقى واسترداد مخرجاتها بشكل غير متزامن.
قم بإرسال أعمال إنشاء الوسائط التي تستغرق وقتًا طويلاً دون إبقاء طلب الاستدلال مفتوحًا.
POST
/v1/async-tasks/image-generationsنص الطلب
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
model | string | لا | معرف نموذج الوسائط. عند حذفه، يستخدم التوجيه سلوك المزود الافتراضي المحدد. |
prompt | string | نعم | وصف المخرجات المطلوبة. |
n | integer | لا | عدد الصور من 1 إلى 10؛ الافتراضي هو 1. |
seed | integer | لا | بذرة حتمية غير سالبة عند دعمها. |
| حقول إضافية | object | لا | الأبعاد وعناصر التحكم في الإنشاء التي يدعمها المزود. يتم رفض الحقول غير المعروفة ذات المستوى الأعلى؛ الخيارات الخاصة بالمزود تنتمي تحت provider_options أو parameters. |
تقبل طلبات الفيديو duration_seconds موجبًا حتى 300 و fps صحيحًا موجبًا حتى 120. تقبل طلبات الموسيقى duration_seconds حتى 1200 وتتطلب واحدًا على الأقل من prompt أو lyrics أو title.
دورة حياة المهمة
- أرسل طلب إنشاء صورة أو فيديو أو موسيقى.
- قم بتخزين معرف المهمة المُرجع.
- قم بالاستقصاء عن
GET /v1/async-tasks/{task_id}حتى تكتمل المهمة. - قم بتنزيل المخرجات عبر عنوان URL الخاص بالملف المؤقت الموقّع.
عناوين URL للملفات المؤقتة محدودة زمنيًا. قم بتخزين الأصل النهائي في مساحتك التخزينية الخاصة بك عندما يكون الاحتفاظ طويل الأجل مطلوبًا.
أسماء مستعارة للتوافق
قد تستخدم عمليات التكامل الحالية /v1/images/generations أو /v1/videos/generations أو /v1/music/generations. يجب أن تستخدم عمليات التكامل الجديدة مسارات /v1/async-tasks/*-generations الصريحة أعلاه.