bria/increase-resolution

المواصفات التقنية لـ bria/increase-resolution

ما هو bria/increase-resolution؟

bria/increase-resolution هو نقطة نهاية لنموذج ترقية دقة الصور من Bria لزيادة دقة الصورة من دون إعادة تخيّل أو إعادة توليد للمحتوى الأساسي. تصف Bria هذا المسار بأنه قدرة مخصّصة لزيادة الدقة تحافظ على الصورة الأصلية بدلًا من إضافة تفاصيل مخترعة جديدة، ما يجعله مناسبًا لتدفّقات عمل تحتاج إلى تكبير أنظف مع موثوقية بصرية متوقعة.

ينتمي هذا النموذج إلى مجموعة واجهات برمجة تطبيقات تحرير الصور الأوسع لدى Bria، التي تتضمن نقاط نهاية مخصّصة لعمليات مثل التوسيع، وتحرير الخلفية، والتقنيع، والمحو. ضمن هذه المجموعة، يُعد bria/increase-resolution الخيار المتخصّص لعملية التكبير المباشرة.

نظرًا لأن Bria تميّز هذا المسار عن نقطة النهاية المنفصلة "Enhance Image"، فمن الأفضل فهم bria/increase-resolution كأداة فائقة الدقة تركّز على الحفاظ على المحتوى: فهي تكبّر دقة الصورة باستخدام طريقة تكبير مخصّصة، بينما تهدف نقطة "Enhance Image" إلى إعادة توليد خامات أكثر ثراءً أو إضافة ثراء بصري.

الميزات الرئيسية لـ bria/increase-resolution

• ترقية الدقة: يرفع دقة الصور المُدخلة بمضاعفات مدعومة 2x أو 4x، ما يوفر للمطورين مسارًا بسيطًا للحصول على مخرجات أعلى دقة للأصول القائمة.
• سلوك يحافظ على المحتوى: مُصمَّم للحفاظ على محتوى الصورة الأصلية بدلًا من إعادة توليدها أو تغييرها إبداعيًا، وهو مفيد لمسارات عمل حسّاسة للعلامة التجارية وأنابيب معالجة حتمية.
• دعم مخرجات كبيرة: يدعم التكبير حتى أقصى مساحة إخراج قدرها 8192 × 8192 بكسل، ما يسمح بتسليم عالي الدقة للعديد من حالات الإنتاج.
• مرونة في استيعاب الإدخال: يقبل إما عناوين URL لصور متاحة للعامة أو حمولات صور مُرمَّزة بصيغة Base64، ما يسهل الدمج مع الوسائط المستضافة وسير عمل التحميل المباشر.
• توافق واسع مع الصيغ: يعمل مع مدخلات JPEG وJPG وPNG وWEBP، وتشير وثائق نقطة النهاية لدى Bria أيضًا إلى قيود حول الصيغ/أنماط الألوان المدعومة واستجابات 415 للحالات غير المدعومة.
• الحفاظ على الشفافية: يتضمن خيار preserve_alpha بحيث يمكن للصور ذات قنوات ألفا الاحتفاظ بالبكسلات الشفافة وشبه الشفافة في الإخراج.
• معالجة ملائمة للوضع غير المتزامن: يدعم المعالجة غير المتزامنة افتراضيًا، مع إرجاع رابط حالة لتتبّع المهام الطويلة، ويوفّر أيضًا وضعًا متزامنًا عند الحاجة.
• ضوابط إشراف مدمجة: توثّق Bria إشرافًا على صور الإدخال والإخراج لهذا المسار، ما يساعد الفرق على فرض استخدام إنتاجي أكثر أمانًا.

كيفية الوصول ودمج bria/increase-resolution

الخطوة 1: التسجيل للحصول على مفتاح API

للوصول إلى واجهة bria/increase-resolution، أنشئ حسابًا على CometAPI ثم أنشئ مفتاح API من لوحة التحكم. بعد تسجيل الدخول، خزّن المفتاح بأمان كمتغيّر بيئة مثل COMETAPI_API_KEY. سيُستخدم هذا المفتاح لمصادقة جميع الطلبات إلى bria/increase-resolution.

الخطوة 2: إرسال الطلبات إلى واجهة bria/increase-resolution

استخدم نقطة CometAPI المتوافقة مع Bria عند POST /bria/image/edit/increase-resolution.

curl https://api.cometapi.com/bria/image/edit/increase-resolution \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A paper boat floating on calm water at sunrise.",
    "num_results": 1
  }'

الخطوة 3: استرجاع النتائج والتحقق منها

تعيد الواجهة معرّف مهمة. استخدم الاستطلاع على GET /bria/{task_id} للتحقق من حالة المعالجة واسترجاع رابط صورة الإخراج عند الاكتمال.