/api/v1/image/multi-edit

curl --request POST \
  --url https://api.venice.ai/api/v1/image/multi-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "aspect_ratio": "16:9",
  "modelId": "firered-image-edit",
  "output_format": "png",
  "quality": "high",
  "resolution": "1K",
  "safe_mode": false
}
'

"<string>"

Images

تحرير الصور المتعدد

Edit or modify an image using up to three layered inputs (base image plus masks/overlays).

Supported input formats by Content-Type:

multipart/form-data: Only file uploads are supported. Send images as form file fields.
application/json: Base64 strings and URLs are supported:
- Raw base64 string: "iVBORw0KGgoAAAANSUhEUgAA..."
- Data URL: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
- HTTP/HTTPS URL: "https://example.com/image.png"

For models with resolution tiers that require explicit dimensions, omit aspect_ratio or set it to auto to infer the closest supported aspect ratio from the first input image. Provide aspect_ratio directly when exact output dimensions are required. Use output_format to request jpeg, jpg, png, or webp output.

Authentication: This endpoint accepts either a Bearer API key or a SIGN-IN-WITH-X header for x402 wallet-based authentication. The legacy X-Sign-In-With-X header is also accepted during migration. When using x402, a 402 Payment Required response indicates insufficient balance and includes top-up instructions.

POST

image

multi-edit

/api/v1/image/multi-edit

curl --request POST \
  --url https://api.venice.ai/api/v1/image/multi-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "aspect_ratio": "16:9",
  "modelId": "firered-image-edit",
  "output_format": "png",
  "quality": "high",
  "resolution": "1K",
  "safe_mode": false
}
'

"<string>"

التسعير: يختلف تسعير التحرير المتعدد حسب النموذج. راجع نظرة عامة على التسعير للحصول على الأسعار الحالية لكل عملية تحرير.

مستويات الجودة

تقبل بعض نماذج التحرير المتعدد معاملًا اختياريًا quality (low أو medium أو high) يوازن بين دقة الصورة المرئية والتكلفة. مدعوم حاليًا من gpt-image-2-edit؛ تتجاهل النماذج الأخرى المعامل.

{
  "modelId": "gpt-image-2-edit",
  "images": ["iVBORw0KGgo...", "iVBORw0KGgo..."],
  "prompt": "blend the two scenes into one cinematic frame",
  "resolution": "2K",
  "quality": "medium"
}

عند حذف quality، يستخدم النموذج مستواه الافتراضي (high لـ gpt-image-2-edit). توجد الأسعار لكل مستوى (1K/2K/4K × low/medium/high) ضمن model_spec.pricing.quality في endpoint النماذج ومذكورة في نظرة عامة على التسعير.

التسعير المُدرِك للجودة هو الإعداد الافتراضي لجميع مستدعي API و SDK — لا يلزم header للموافقة. يتم احتساب الطلبات التي تحذف quality بالسعر الافتراضي للنموذج (high لـ gpt-image-2-edit).

التفويضات

Authorization

string

header

مطلوب

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

الجسم

Edit an image by compositing up to three layered images with a single prompt. Supports base64-encoded strings and URLs.

prompt

string

مطلوب

The text directions to edit or modify the image. Short, descriptive prompts work best (e.g., "remove the tree", "change the sky to sunrise"). Character limit is model specific and is listed in the promptCharacterLimit setting in the model list endpoint.

Required string length: 1 - 32768

images

(string<uri> | string)[]

مطلوب

Array of 1 to 3 images used for multi-editing. The first image is treated as the base image, and the remaining images are used as edit layers/masks. Each image can be a base64-encoded string or a URL starting with http:// or https://. Image dimensions must be at least 65536 pixels and must not exceed 33177600 pixels. File size must be less than 25MB.

Required array length: 1 - 3 elements

Image as a base64-encoded string or a URL starting with http:// or https://

aspect_ratio

enum<string>

The aspect ratio for the output image. Use 'auto' or omit this parameter to infer the closest supported aspect ratio from the first input image when explicit sizing is required by the model.

الخيارات المتاحة:

auto,

1:1,

3:2,

16:9,

21:9,

9:16,

2:3,

3:4,

4:5

مثال:

"16:9"

modelId

enum<string>

افتراضي:firered-image-edit

The model ID to use for multi-edit.

الخيارات المتاحة:

firered-image-edit,

qwen-edit,

qwen-edit-uncensored,

grok-imagine-edit,

grok-imagine-quality-edit,

qwen-image-2-edit,

qwen-image-2-pro-edit,

wan-2-7-pro-edit,

flux-2-max-edit,

gpt-image-2-edit,

gpt-image-1-5-edit,

nano-banana-2-edit,

nano-banana-pro-edit,

seedream-v5-lite-edit,

seedream-v4-edit

Minimum string length: 1

output_format

enum<string>

Output format for the edited image. Accepts jpeg, jpg, png, or webp. When omitted, the format is inferred from resolution: PNG for 1K edits and JPEG for 2K/4K edits.

الخيارات المتاحة:

jpeg,

png,

webp

مثال:

"png"

quality

enum<string>

Output quality for supported models (e.g. GPT Image 2 / GPT Image 2 Edit). Higher values can increase the final request charge. See the model list for supported options.

الخيارات المتاحة:

low,

medium,

high

مثال:

"high"

resolution

string

Resolution tier for the output image (e.g. "1K", "2K", "4K"). Supported values vary by model - check GET /api/v1/models for model-specific options. Defaults to "1K" when not specified.

Required string length: 1 - 10

مثال:

"1K"

safe_mode

boolean

افتراضي:true

Whether to use safe mode. If enabled, this will blur images that are classified as having adult content.

مثال:

false

الاستجابة

The response is of type file.

تحرير (المعروف بـ Inpaint)إزالة الخلفية

⌘I

​مستويات الجودة

التفويضات

الجسم

الاستجابة

مستويات الجودة