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

​
نقاط النهاية

نقطة النهايةالغرضالأنسب لـ
POST /image/editتحرير صورة واحدة باستخدام موجّهالتعديلات العامة والإصلاح الموضعي المعتمد على الموجّه
POST /image/multi-editتحرير باستخدام 1-3 صور متراكبةتعديلات أكثر تحكمًا باستخدام أقنعة أو طبقات
POST /image/background-removeإزالة الخلفية من صورةقصاصات شفافة للمنتجات والصور الشخصية والأصول

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

  • استخدم /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”. الطلب: 
POST https://api.venice.ai/api/v1/image/edit
Authorization: Bearer $VENICE_API_KEY
Content-Type: application/json

{
  "model": "qwen-edit",
  "prompt": "Replace the cloudy sky with a warm sunrise while preserving the buildings and canal",
  "image": "https://example.com/venice-canal.jpg"
}
الاستجابة (200): يحتوي جسم الاستجابة على بيانات ثنائية خام بصيغة image/png. احفظها مباشرة في ملف. 
import base64
import os
import requests

with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

response = requests.post(
    "https://api.venice.ai/api/v1/image/edit",
    headers={
        "Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "qwen-edit",
        "prompt": "Remove the tourist crowd from the square and keep the architecture intact",
        "image": image_base64,
    },
)

with open("edited.png", "wb") as f:
    f.write(response.content)

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

تقبل نقطة النهاية /image/multi-edit ما يصل إلى ثلاث صور. الصورة الأولى هي الصورة الأساسية، أما الصور المتبقية فيُتعامل معها كطبقات تحرير أو أقنعة، مما يمنحك تحكمًا أكبر من التحرير المعتمد على الموجّه فقط. هذا هو الخيار الأفضل عندما تريد:
  • استهداف منطقة محددة باستخدام قناع
  • دمج تركيبة موجودة مع طبقة فوقها
  • تقييد التحرير بشكل أدق مما يسمح به موجّه صورة واحدة
طلب JSON: 
{
  "modelId": "qwen-edit",
  "prompt": "Replace the blank billboard area with a glowing Venice film festival poster while preserving lighting and perspective",
  "images": [
    "https://example.com/street-scene.png",
    "https://example.com/billboard-mask.png"
  ]
}
طلب Multipart: 
curl https://api.venice.ai/api/v1/image/multi-edit \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -F "modelId=qwen-edit" \
  -F "prompt=Replace the blank billboard area with a glowing Venice film festival poster while preserving lighting and perspective" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o multi-edited.png
كما هو الحال في /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
أما لتغييرات المشهد الأوسع، فاوصف ما يجب أن يبقى كما هو: 
Replace the background with a modern photo studio backdrop while preserving the subject pose, facial features, and clothing.
إذا استمر التحرير في التأثير على المنطقة الخطأ، فانتقل من /image/edit إلى /image/multi-edit وزوّد طبقة قناع أو طبقة فوقية.

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

استخدم /image/background-remove عندما تريد عزل موضوع المقدمة على خلفية شفافة. تُعيد نقطة النهاية هذه ملف PNG بقناة شفافية (alpha). باستخدام رابط صورة: 
curl https://api.venice.ai/api/v1/image/background-remove \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -H "Content-Type: application/json" \
  -o cutout.png \
  -d '{
    "image_url": "https://example.com/product-photo.jpg"
  }'
باستخدام رفع ملف محلي: 
curl https://api.venice.ai/api/v1/image/background-remove \
  -H "Authorization: Bearer $VENICE_API_KEY" \
  -F "[email protected]" \
  -o cutout.png
استخدم إزالة الخلفية لـ:
  • صور منتجات التجارة الإلكترونية
  • الصور الشخصية وصور الملف الشخصي
  • الأصول التي تنوي وضعها فوق خلفية جديدة

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

​
/image/edit

المعاملالنوعمطلوبالافتراضيالوصف
imageملف، أو سلسلة base64، أو رابط URLنعم-الصورة المصدر المراد تحريرها
promptstringنعم-تعليمات نصية للتعديل
modelstringلاqwen-editمعرّف نموذج التحرير
aspect_ratiostringلاالافتراضي للنموذجنسبة الإخراج للنماذج التي تدعمها
modelIdstringمتروك (Deprecated)-اسم مرادف متروك للحقل model

​
/image/multi-edit

المعاملالنوعمطلوبالافتراضيالوصف
imagesمصفوفة من 1-3 ملفات أو سلاسل base64 أو روابط URLنعم-الصورة الأولى هي الأساسية؛ والباقي طبقات تحرير أو أقنعة
promptstringنعم-تعليمات نصية لكيفية دمج الطبقات أو تحريرها
modelIdstringلاqwen-editمعرّف نموذج التحرير

​
/image/background-remove

المعاملالنوعمطلوبالوصف
imageملف أو سلسلة base64أحد image أو image_urlالصورة المصدر المراد قصها
image_urlstringأحد image أو image_urlرابط عام للصورة المراد قصها

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

نقطة النهايةإدخال JSONإدخال Multipartالإخراج
/image/editسلسلة Base64 أو رابط URLرفع ملفimage/png
/image/multi-editسلاسل Base64 أو روابط URLرفع ملفاتimage/png
/image/background-removeسلسلة Base64 أو رابط URLرفع ملفimage/png
بالنسبة لنقاط نهاية التحرير، يجب أن تكون أبعاد الصورة 65536 بكسل على الأقل وألا تتجاوز 33177600 بكسل. ويجب أن تكون الملفات المرفوعة أقل من 25MB.

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

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

​
الأخطاء

الحالةالمعنىالإجراء
400معاملات الطلب غير صالحةتحقّق من عدد الصور وأسماء الحقول وصيغة الإدخال
401فشل المصادقةتحقّق من مفتاح API الخاص بك
402الرصيد غير كافٍأضف رصيدًا عبر venice.ai/settings/api
415نوع المحتوى غير صالحاستخدم JSON أو multipart form-data بشكل صحيح
429تجاوز حد المعدّل أو النموذج محمّل بأقصى طاقتهأعد المحاولة مع تأخير تصاعدي؛ افحص ترويسة Retry-After
500فشل في معالجة الاستدلالأعد إرسال الطلب
503النموذج بكامل طاقتهأعد المحاولة بعد تأخير قصير
بعض نماذج التحرير تتبنى سياسات محتوى أكثر صرامة من نماذج توليد الصور. على سبيل المثال، يحجب qwen-edit الطلبات التي تتضمن صورًا جنسية صريحة، أو قاصرين بصورة جنسية، أو عنفًا واقعيًا.

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