/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”. الطلب:image/png. احفظها مباشرة في ملف.
الخطوة 2: استخدم multi-edit للأقنعة أو الإصلاح الموضعي بالطبقات
تقبل نقطة النهاية/image/multi-edit ما يصل إلى ثلاث صور. الصورة الأولى هي الصورة الأساسية، أما الصور المتبقية فيُتعامل معها كطبقات تحرير أو أقنعة، مما يمنحك تحكمًا أكبر من التحرير المعتمد على الموجّه فقط.
هذا هو الخيار الأفضل عندما تريد:
- استهداف منطقة محددة باستخدام قناع
- دمج تركيبة موجودة مع طبقة فوقها
- تقييد التحرير بشكل أدق مما يسمح به موجّه صورة واحدة
/image/edit، يكون جسم الاستجابة بيانات image/png خام.
تستخدم نقطة النهاية
/image/multi-edit حاليًا الحقل modelId بدلاً من model في مخطط الطلب.نصائح للإصلاح الموضعي
يعمل الإصلاح الموضعي المعتمد على الموجّه بأفضل شكل عندما تكون التعليمة قصيرة ومحلية:remove the treechange the sky to sunsetreplace the logo with a blank signrestore 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 دولار لكل عملية تحرير. وقد تختلف أسعار وقيود النماذج الأخرى القادرة على التحرير.
راجع:
- تسعير الصور
- Models API باستخدام
type=inpaint
الأخطاء
بعض نماذج التحرير تتبنى سياسات محتوى أكثر صرامة من نماذج توليد الصور. على سبيل المثال، يحجب
qwen-edit الطلبات التي تتضمن صورًا جنسية صريحة، أو قاصرين بصورة جنسية، أو عنفًا واقعيًا.مسارات العمل ذات الصلة
- استخدم توليد الصور عندما تبدأ من نص بدلاً من صورة موجودة.
- استخدم نماذج الصور لمقارنة عائلات نماذج التوليد والتحرير والتحسين.
- استخدم Image Edit API وMulti-Edit API وBackground Remove API للاطلاع على تفاصيل المخطط الكاملة.