Эта страница есть на русском

Esta página también está en español

此页面也有中文版

Get started

Image editing

Upload up to 14 reference images and describe the edit in the prompt: what to keep and what to change. There are no masks; the text sets the area of the edit. All 10 models accept reference images.

  • up to 14reference images
  • PNG, JPEG, WebPfile formats
  • 25 MiBper file
  • 24 hfile lifetime
Sort

Showing 7 of 7 · stats for 7 days

01How to edit

How to edit an image with a reference image

A reference image is an image the model takes as a basis: a product, a face, a style, or a composition.

  1. Upload a file. POST /uploads with the fields file and kind=image. PNG, JPEG, and WebP up to 25 MiB work. The response has file_id and how long it is valid.
  2. Pass the reference images. Up to 14 IDs in image_file_ids, or from 1 to 14 links in image_urls; you can’t mix them.
  3. Describe the edit in the prompt. What to keep and what to change: “Keep the teapot unchanged, replace the background with a light studio one.” There are no masks; the text sets the area of the edit.
  4. Keep the time limits in mind. An uploaded file is valid for 24 hours and the result is stored for one day, so download it to your own storage. The price depends on the model and resolution; the number of reference images doesn’t affect it.

Reference images larger than 7 MiB or 4,096 pixels on the longer side may be downscaled or re-encoded; keep your originals.

curl · upload and edit
# 1. upload a reference image; the response has file_id and expires_at
curl https://api.rendergrid.io/api/public/v1/uploads \
  -H "Authorization: Bearer $RENDERGRID_API_KEY" \
  -F "file=@product.png" \
  -F "kind=image"

# 2. pass file_id in the request and describe the edit
curl https://api.rendergrid.io/api/public/v1/images/generate \
  -H "Authorization: Bearer $RENDERGRID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2.1",
    "prompt": "Keep the teapot unchanged, replace the background with a light studio one",
    "image_file_ids": ["a1b2c3d4e5f60718"]
  }'

02Comparison

Models side by side

Resolutions, aspect ratios, reference images, price, and average time over 7 days. The name links to the model page.

Model comparison
ModelMakerResolutionsAspect ratiosReference imagesPrice fromTime
Nano Banana Pronano-banana-proGoogle1K, 2K, 4K10 + autoup to 14from $0.0439 s average
Nano Banana 2nano-banana-2Google1K, 2K, 4K14 + autoup to 14from $0.02534 s average
Nano Banana 2.1 Newnano-banana-2.1Google1K, 2K, 4K14 + autoup to 14from $0.0240 s average
Nano Banana Flashnano-banana-flashGoogle1K10 + autoup to 14from $0.01529 s average
Nano Banana 2 Litenano-banana-2-liteGoogle1K10up to 14from $0.01532 s average
GPT Image 2gpt-image-2OpenAI1K10up to 14from $0.0243 s average
GPT Image 2.5gpt-image-2.5OpenAI1K13up to 14from $0.02535 s average

Aspect ratios are counted without auto: it is available on 4 Google models; Nano Banana 2 Lite doesn’t have it. The price depends on the resolution; the full table is on the “Pricing” page.

03FAQ

Questions about models

How do I edit an image?
Upload a file through POST /uploads, pass its file_id in image_file_ids, and describe the edit in the prompt: what to keep and what to change.
How many reference images can I pass?
Up to 14, for all 10 models. PNG, JPEG, and WebP work, up to 25 MiB each. A file larger than 7 MiB or 4,096 pixels on the longer side may be downscaled or re-encoded.
Are there masks and inpainting?
No: masks are not supported. To change part of an image, pass it as a reference image and describe the edit in the prompt.
How long does an uploaded file last?
A file ID is valid for 24 hours. Uploading the same file again gives a new ID for another 24 hours. Generation results are stored for one day.
How much does an edit cost?
The same as a regular generation: the price depends on the model and resolution, and the number of reference images doesn’t affect it. A failed request is free.
Can I pass links instead of files?
Yes: from 1 to 14 public links in image_urls. Don’t mix them with image_file_ids. If the source is slow or requires authorization, upload the file through POST /uploads.

04Articles

Read about the models

All articles

High volumes

High volumes? Leave your contact and we’ll work out custom terms

A per-image price for your volume, limits for your traffic and a direct line on Telegram.

High-volume terms
Images per month