فيديوهات

#فيديوهات

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

طلب

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

Authorization: Bearer KITTA_API_KEY

استخدم فقط مسارات نقطة النهاية التي يتم إرجاعها بواسطة GET /api/openapi.json. لا تقم بنسخ المسارات من عمليات النشر الأخرى إلى العملاء الخارجيين.

إجابة

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

الفواتير والائتمانات

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

أخطاء

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

نقاط النهاية العامة الحالية

استخدم GET /api/open/v1/media/models?mediaType=video للنماذج المعتمدة، وPOST /api/open/v1/media/videos/jobs لإنشاء المهمة، وGET /api/open/v1/media/videos/jobs/{jobId} للاستعلام عنها. يتطلب الإنشاء قيمة Idempotency-Key فريدة؛ إعادة المحاولة بالقيمة نفسها تعيد الاستجابة الأولى دون إنشاء أو خصم مكرر. تُستخدم حصة API لا أرصدة الموقع، وتُعاد الحصة بصورة آمنة عند فشل الإنشاء أو الحفظ أو المعالجة غير المتزامنة أو انتهاء المهلة.