محسّن الجودة (الترقية)

تتيح لك نقطة نهاية محسّن الجودة ترقية وتحسين دقة وتفاصيل الصور الدقيقة بذكاء، مع دعم دقة تصل إلى 4K.

الطلب

أرسل صورتك ودقة الهدف إلى نقطة النهاية الشاملة /v1/run:

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

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "upscale",
           "inputs": {
             "imageUrl": "https://example.com/1k-image.jpg",
             "targetQuality": "2k"
           }
         }'

الاستجابة

نظرًا لأن عملية الترقية قد تستغرق ما يصل إلى 20 ثانية، فإن نقطة النهاية /v1/run تُرجع حالة 201 Created فورًا مع معرف مهمة غير متزامن (id). يجب عليك استقصاء واجهة برمجة تطبيقات الحالة باستخدام هذا المعرف (id) لاسترداد الصورة النهائية. بدلاً من ذلك، يمكنك تكوين خطافات الويب (webhooks) لتلقي الإشعارات تلقائيًا. يرجى ملاحظة أن مرسل خطافات الويب لدينا يفرض مهلة صارمة تبلغ 15 ثانية. يجب أن يؤكد خادمك استلام خطاف الويب برمز حالة 2xx في غضون 15 ثانية، وإلا سنعتبره فاشلاً ونعيد المحاولة لاحقًا.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "upscale"
}

عند اكتمال المهمة (status: "success"), سيحتوي حقل output على مصفوفة عناوين URL الناتجة:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/upscale-123.jpg"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

معلمات الطلب

المعلمات المطلوبة

أخطاء وقت التشغيل

تستخدم أخطاء وقت التشغيل لهذه الميزة المجموعة المشتركة الموثقة في معالجة الأخطاء. إذا حدث خطأ أثناء المعالجة، فسيتم تحديث status إلى "error" وسيحتوي حقل error على سبب الفشل المحدد.

تكلفة الاعتمادات

بالنسبة لطلبات واجهة برمجة تطبيقات المطورين، تتناسب التكلفة مع targetQuality.

الصيغة: Cost = QualityCredits