الانتقال إلى المحتوى الرئيسي
تحرير الصور في Venice متزامن. أرسل صورتك المصدر إلى /image/edit أو /image/multi-edit فتعود النتيجة المحرَّرة في الاستجابة ذاتها كملف PNG. أما للقصاصات (Cutouts)، فإن /image/background-remove يُعيد ملف PNG شفافًا.
نقاط نهاية تحرير الصور تجريبية، وقد يتغير السلوك الخاص بكل نموذج بمرور الوقت.

نقاط النهاية

متى تستخدم كل نقطة نهاية

  • استخدم /image/edit عندما تمتلك صورة مصدر واحدة وترغب في تغيير جزء منها أو إزالته أو إعادة تنسيقه بموجّه.
  • استخدم /image/multi-edit عندما تحتاج إلى تحكم إضافي عبر الأقنعة أو الطبقات أو الطبقات المرجعية.
  • استخدم /image/background-remove عندما تريد فقط استخراج موضوع المقدمة بشفافية نظيفة.
للإصلاح الموضعي (Inpainting)، استخدم /image/edit أو /image/multi-edit. أما المعامل القديم inpaint في /image/generate فقد تم إيقافه.

الخطوة 1: تحرير صورة واحدة

تحرير الصورة الواحدة هو أبسط تدفق إصلاح موضعي. أرسل صورة واحدة مع موجّه قصير مثل “remove the sign” أو “change the sky to sunrise” أو “replace the background with a studio backdrop”. الطلب:
الاستجابة (200): يحتوي جسم الاستجابة على بيانات ثنائية خام بصيغة image/png. احفظها مباشرة في ملف.

الخطوة 2: استخدم multi-edit للأقنعة أو الإصلاح الموضعي بالطبقات

تقبل نقطة النهاية /image/multi-edit ما يصل إلى ثلاث صور. الصورة الأولى هي الصورة الأساسية، أما الصور المتبقية فيُتعامل معها كطبقات تحرير أو أقنعة، مما يمنحك تحكمًا أكبر من التحرير المعتمد على الموجّه فقط. هذا هو الخيار الأفضل عندما تريد:
  • استهداف منطقة محددة باستخدام قناع
  • دمج تركيبة موجودة مع طبقة فوقها
  • تقييد التحرير بشكل أدق مما يسمح به موجّه صورة واحدة
طلب JSON:
طلب Multipart:
كما هو الحال في /image/edit، يكون جسم الاستجابة بيانات image/png خام.
تستخدم نقطة النهاية /image/multi-edit حاليًا الحقل modelId بدلاً من model في مخطط الطلب.

نصائح للإصلاح الموضعي

يعمل الإصلاح الموضعي المعتمد على الموجّه بأفضل شكل عندما تكون التعليمة قصيرة ومحلية:
  • remove the tree
  • change the sky to sunset
  • replace the logo with a blank sign
  • restore the torn corner of the photo
أما لتغييرات المشهد الأوسع، فاوصف ما يجب أن يبقى كما هو:
إذا استمر التحرير في التأثير على المنطقة الخطأ، فانتقل من /image/edit إلى /image/multi-edit وزوّد طبقة قناع أو طبقة فوقية.

الخطوة 3: إزالة الخلفية

استخدم /image/background-remove عندما تريد عزل موضوع المقدمة على خلفية شفافة. تُعيد نقطة النهاية هذه ملف PNG بقناة شفافية (alpha). باستخدام رابط صورة:
باستخدام رفع ملف محلي:
استخدم إزالة الخلفية لـ:
  • صور منتجات التجارة الإلكترونية
  • الصور الشخصية وصور الملف الشخصي
  • الأصول التي تنوي وضعها فوق خلفية جديدة

معاملات الطلب

/image/edit

/image/multi-edit

/image/background-remove


صيغ الإدخال المدعومة

بالنسبة لنقاط نهاية التحرير، يجب أن تكون أبعاد الصورة 65536 بكسل على الأقل وألا تتجاوز 33177600 بكسل. ويجب أن تكون الملفات المرفوعة أقل من 25MB.

النماذج والتسعير

نموذج التحرير الافتراضي هو qwen-edit، بسعر 0.04 دولار لكل عملية تحرير. وقد تختلف أسعار وقيود النماذج الأخرى القادرة على التحرير. راجع:

الأخطاء

بعض نماذج التحرير تتبنى سياسات محتوى أكثر صرامة من نماذج توليد الصور. على سبيل المثال، يحجب qwen-edit الطلبات التي تتضمن صورًا جنسية صريحة، أو قاصرين بصورة جنسية، أو عنفًا واقعيًا.

مسارات العمل ذات الصلة