Image to Image

Transform an existing image using a text prompt. Uses the same endpoint as text-to-image — simply include the image_url field pointing to a publicly accessible image.

Note

The image_url must be publicly accessible. Private or authenticated URLs will result in a 400 Bad Request. For base64 input, encode to a data: URL (coming soon).

Parameters

modelstringrequired

"nano-banana" | "nano-banana-2" | "nano-banana-pro"

promptstringrequired

Describes how to transform the input image

image_urlstringrequired

Publicly accessible URL of the source image (JPEG, PNG, WebP)

aspect_ratiostringoptional

"1:1" | "16:9" | "9:16" | "4:3" | "3:4". Defaults to "1:1".

Prompt tips

→Describe the style transformation, not just the subject — e.g. "turn into oil painting" vs. just "painting"
→Reference specific art styles: "Monet impressionism", "Bauhaus poster", "Studio Ghibli anime"
→Use strong adjectives for texture: "rough", "glossy", "watercolor washes"
→Combine with content edits: "woman in the photo wearing a red jacket instead"

cURL request

bash

curl -X POST https://api.apinanobanana.com/v1/images/generate \
  -H "Authorization: Bearer nb_sk_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "Transform this into a watercolor painting",
    "image_url": "https://example.com/my-photo.jpg",
    "aspect_ratio": "1:1"
  }'

Response · 200 OK

json

{
  "id": "gen_img2img_d4e5f6",
  "model": "nano-banana",
  "image_url": "https://storage.apinanobanana.com/user123/i2i_1712678400000.png",
  "credits_used": 20,
  "credits_remaining": 980,
  "created_at": "2026-04-09T17:00:00Z"
}

cURL request

bash

curl -X POST https://api.apinanobanana.com/v1/images/generate \
  -H "Authorization: Bearer nb_sk_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "Transform this into a watercolor painting",
    "image_url": "https://example.com/my-photo.jpg",
    "aspect_ratio": "1:1"
  }'

Response · 200 OK

json

{
  "id": "gen_img2img_d4e5f6",
  "model": "nano-banana",
  "image_url": "https://storage.apinanobanana.com/user123/i2i_1712678400000.png",
  "credits_used": 20,
  "credits_remaining": 980,
  "created_at": "2026-04-09T17:00:00Z"
}