/api/v1/image/edit

curl --request POST \
  --url https://api.venice.ai/api/v1/image/edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Colorize",
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB7GkOtAAAAIGNIUk0A..."
}
'

"<string>"

Images

Edit (alias Inpaint)

Edit or modify an image based on the supplied prompt. The image can be provided either as a multipart form-data file upload or as a base64-encoded string in a JSON request. 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 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

edit

/api/v1/image/edit

curl --request POST \
  --url https://api.venice.ai/api/v1/image/edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Colorize",
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgAAAAIACAIAAAB7GkOtAAAAIGNIUk0A..."
}
'

"<string>"

Questo è un endpoint sperimentale e può essere soggetto a modifiche.

Prezzi: I prezzi dell’image editing variano in base al modello. Il modello predefinito (qwen-edit) è di $0,04 per modifica. Consulta l’endpoint Models per tutti i modelli di edit disponibili e i relativi prezzi.

Livelli di qualità

Alcuni modelli di edit accettano un parametro opzionale quality (low, medium, high) che bilancia fedeltà visiva e costo. Attualmente supportato da gpt-image-2-edit; gli altri modelli ignorano il parametro.

{
  "model": "gpt-image-2-edit",
  "image": "iVBORw0KGgo...",
  "prompt": "change the sky to a sunrise",
  "resolution": "2K",
  "quality": "medium"
}

Quando ometti quality, il modello usa il proprio livello predefinito (high per gpt-image-2-edit). I prezzi per livello (1K/2K/4K × low/medium/high) si trovano sotto model_spec.pricing.quality nell’endpoint Models e sono elencati nella panoramica dei prezzi.

I prezzi basati sulla qualità sono l’impostazione predefinita per tutti i chiamanti API e SDK — non è richiesto alcun header di opt-in. Le richieste che omettono quality vengono fatturate al livello predefinito del modello (high per gpt-image-2-edit).

Postman Collection

Per ulteriori esempi, consulta questa Postman Collection.

Il modello predefinito (qwen-edit) blocca le richieste che tentano di generare immagini sessualmente esplicite, sessualizzare minori o rappresentare violenza reale. Altri modelli possono avere policy di contenuto diverse.

Autorizzazioni

Authorization

string

header

obbligatorio

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

Corpo

Edit an image based on the supplied prompt.

image

obbligatorio

The image to edit. Can be either a file upload, 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.

prompt

string

obbligatorio

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

Esempio:

"Change the color of the sky to a sunrise"

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 input image when explicit sizing is required by the model. Supported values vary by model - check GET /api/v1/models for model-specific options.

Opzioni disponibili:

auto,

1:1,

3:2,

16:9,

21:9,

9:16,

2:3,

3:4,

4:5

Esempio:

"16:9"

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

Esempio:

"1K"

model

string

predefinito:firered-image-edit

The model ID to use for image editing.

Minimum string length: 1

modelId

enum<string>

deprecato

Deprecated: Use "model" instead. The model ID to use for image editing.

Opzioni disponibili:

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.

Opzioni disponibili:

jpeg,

png,

webp

Esempio:

"png"

safe_mode

boolean

predefinito:true

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

Esempio:

false

Risposta

The response is of type file.

Upscale e miglioramento Multi-Edit immagine

⌘I

​Livelli di qualità

​Postman Collection

Autorizzazioni

Corpo

Risposta

Livelli di qualità

Postman Collection