Image Studio — Edit Live

POST /v1/images/studio/edit

Edit one or more input images with a text instruction. The endpoint is always async — it accepts your job and returns immediately with a job_id. Retrieve the result by polling the status_url or by supplying a callback_url to receive a webhook when the job completes.

Request body

Parameter	Type	Required	Description
`prompt`	string	Yes	Editing instructions. 1-2,000 characters.
`image_urls`	array of strings	Yes	1-5 reference image URLs to edit. Some models use only the first image — see the model catalog.
`model`	string	Yes	Edit model to use. The API defaults to `standard` if omitted, but integrations should send this explicitly. Full list in the model catalog.
`callback_url`	string	No	Webhook URL that will receive the final result.
`additional_settings`	object	No	Model-specific settings (e.g., `resolution`, `quality`, `aspect_ratio`). Refer to the model catalog for accepted values per model.
`enable_fallback`	boolean	No	Defaults to `true`. Accepted for forward compatibility; image edit fallback behavior is model-dependent.

Model support

Default model: standard. The API can default model when omitted, but production integrations should send it explicitly so the selected edit model is clear. common means callback_url, additional_settings, and enable_fallback. Model-specific knobs are passed in additional_settings.

Model ID	Display name	Required params	Optional supported params	Cost	ETA
`standard`	Gemini 2.5 Flash	`prompt`, `image_urls`, `model`	common; `image_urls` 1-5	`$0.10`	~8s
`pro`	Gemini 3 Pro	`prompt`, `image_urls`, `model`	common; `image_urls` 1-5	`$0.20`	~10s
`qwen-image/edit-2511`	Qwen Image Edit 2511	`prompt`, `image_urls`, `model`	common; `image_urls` 1-3	`$0.10`	~15s
`Seedream-4.5-uncensored`	Seedream v4.5	`prompt`, `image_urls`, `model`	common + `seed`; `image_urls` 1-5	`$0.10`	~15s
`Wan-2.6`	Wan 2.6	`prompt`, `image_urls`, `model`	common + `seed`, `negative_prompt`; `image_urls` 1-5	`$0.10`	~20s
`Wan-2.6-image-edit`	Wan 2.6 Image Edit	`prompt`, `image_urls`, `model`	common + `seed`, `negative_prompt`; `image_urls` 1-5	`$0.10`	~15s
`group-edit`	Qwen Group Photo	`prompt`, `image_urls`, `model`	common + `seed`; `image_urls` 1-5	`$0.10`	~20s
`xai/grok-imagine-image/edit`	Grok Imagine Edit	`prompt`, `image_urls`, `model`	common + `seed`; provider uses the first image	`$0.10`	~15s
`seedream-v5`	Seedream v5 Lite	`prompt`, `image_urls`, `model`	common; `image_urls` 1-5	`$0.10`	~15s
`nano-banana-2/edit`	Nano Banana 2 Edit	`prompt`, `image_urls`, `model`	common + `resolution` (`0.5k`, `1k`, `2k`, `4k`), `aspect_ratio`, `output_format` (`png`, `jpeg`), `enable_web_search`, `enable_image_search`; `image_urls` 1-5	`0.5k/1k/2k $0.10`, `4k $0.20`	~20s
`nano-banana-2/edit-fast`	Nano Banana 2 Edit Fast	`prompt`, `image_urls`, `model`	common + `resolution` (`2k`, `4k`), `aspect_ratio`, `output_format` (`png`, `jpeg`); `image_urls` 1-5	`$0.10`	~12s
`seedream-v4.5/edit-sequential`	Seedream v4.5 Edit Sequential	`prompt`, `image_urls`, `model`	common + `seed`, `max_images` (1-15); `image_urls` 1-5	`$0.10`	~25s
`seedream-v5.0-lite/edit-sequential`	Seedream v5 Lite Edit Sequential	`prompt`, `image_urls`, `model`	common + `max_images` (1-15); `image_urls` 1-5	`$0.10`	~25s
`wan-2.7-image-edit`	Wan 2.7 Image Edit	`prompt`, `image_urls`, `model`	common + `seed`; `image_urls` 1-5	`$0.10`	~15s
`wan-2.7-image-edit-pro`	Wan 2.7 Image Edit Pro	`prompt`, `image_urls`, `model`	common + `seed`; `image_urls` 1-5	`$0.10`	~20s
`gpt-image-2/edit`	GPT Image 2 Edit	`prompt`, `image_urls`, `model`	common + `quality` (`low`, `medium`, `high`), `resolution` (`1k`, `2k`), `aspect_ratio`, `output_format` (`png`, `jpeg`, `webp`); `image_urls` 1-5	`low/medium $0.10`, `high 1k $0.30`, `high 2k $0.40`	~20s

Example request

curl --request POST "https://api.uncensored.com/api/v1/images/studio/edit" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Add a vibrant sunset background and warm lighting",
    "image_urls": ["https://example.com/photo.jpg"],
    "model": "pro",
    "callback_url": "https://your-server.com/webhook"
  }'

Submit response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "status_url": "https://api.uncensored.com/api/v1/images/studio/edit/jobs/550e8400-e29b-41d4-a716-446655440000",
  "mode": "edit",
  "webhook_url": "https://your-server.com/webhook",
  "created_at": "2026-05-17T10:30:00Z"
}

Get job status

GET /v1/images/studio/edit/jobs/{job_id}

Poll every 2-5 seconds. Most jobs complete in 10-90 seconds depending on the model.

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "image_url": "https://media.lesscensored.com/images/abc123.png",
  "model": "pro",
  "is_fallback": false,
  "error": null,
  "created_at": "2026-05-17T10:30:00Z",
  "completed_at": "2026-05-17T10:30:15Z",
  "processing_time": 15.2
}

Response fields

Field	Description
`job_id`	ID of the job.
`status`	`processing`, `completed`, or `failed`.
`image_url`	URL of the edited image when `status` is `completed`.
`model`	The model that produced the result.
`is_fallback`	`true` if the requested model was temporarily unavailable and a substitute produced the result. The `model` field reports which one.
`error`	Error message when `status` is `failed`; otherwise `null`.
`processing_time`	Total time in seconds the job took to complete.

Webhook payload

If you supplied callback_url, the same JSON shape as the status response is POSTed to your webhook once the job reaches a terminal state (completed or failed).

Multi-image edits

Pass up to 5 image URLs in image_urls. The first image is typically the primary subject; additional images are treated as references. Not every model supports multi-image — the model catalog marks which models do.

Variable pricing

Models such as nano-banana-2/edit and gpt-image-2/edit price the request based on resolution and/or quality. Pass these in additional_settings:

{
  "prompt": "Replace the background with a snowy mountain scene",
  "image_urls": ["https://example.com/photo.jpg"],
  "model": "gpt-image-2/edit",
  "additional_settings": {
    "quality": "medium",
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }
}

See the model catalog for each model’s accepted values.

Status codes

Status code	Description
`202`	Job accepted and queued.
`400`	Invalid request (e.g., missing `image_urls`, unknown `model`).
`402`	Insufficient funds.
`403`	Content moderation failed, or your API key’s scope does not permit this model.
`429`	Rate limit exceeded.
`500`	Internal server error.

Introduction

Models

Image Generation