الصور

#صور

يتم تمثيل إنشاء الصور في التنقل في المستندات، لذا تحتفظ المستندات الخارجية بخريطة منتج متسقة. يعتمد توفر نقطة النهاية العامة في الخارج على المخطط. تحقق من GET /api/openapi.json قبل استدعاء نقاط نهاية الصورة من كود الإنتاج.

طلب

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

Authorization: Bearer FISHAUDIO_API_KEY

لا تستنتج المسارات الخارجية من المستندات الأخرى. استخدم فقط المسارات الموجودة في مخطط OpenAPI الخارجي للبيئة المنشورة.

إجابة

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

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

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

أخطاء

تعامل مع النموذج غير المدعوم، والصورة المرجعية غير الصالحة، والأرصدة غير الكافية، وفشل المعالجة بشكل منفصل. إذا كانت نقاط نهاية الصورة غائبة عن GET /api/openapi.json، فتعامل مع الإمكانية على أنها غير متاحة للعامة للحساب.

نقاط OpenAPI الأساسية

• عرض النماذج: GET /api/open/v1/media/models?mediaType=image
• إنشاء صورة: POST /api/open/v1/media/images/jobs
• جلب المهمة: GET /api/open/v1/media/images/jobs/{jobId}

يجب أن يتضمن كل طلب إنشاء ترويسة Idempotency-Key فريدة. تستخدم الواجهة حصة API بدلاً من أرصدة عضوية الويب، وتعيد الحصة بصورة آمنة ومتكررة عند فشل المزود أو التخزين أو حفظ المهمة.