Imagem para Imagem

Visão Geral

Use sua chave API para editar ou transformar imagens existentes através de um endpoint HTTP simples. Os créditos são deduzidos automaticamente com base no número de imagens processadas.

Endpoint

Método: POST
URL: https://api.nanobananaapi.dev/v1/images/edit

Autenticação

Inclua sua chave API no header Authorization. Ainda não tem uma? Crie sua chave API aqui.

Authorization: Bearer SUA_API_KEY
Content-Type: application/json

Corpo da Requisição

{
  "prompt": "Transforme esta paisagem em uma cena de inverno com neve",
  "image": "https://example.com/image.jpg",
  "num": 1,
  "model": "gemini-3-pro-image-preview",
  "image_size": "16:9"
}

Parâmetros

prompt (obrigatório): Descrição textual da transformação desejada
image (obrigatório): URL da imagem fonte ou data URL base64. Pode ser uma string ou um array de strings
num (opcional): Número de variações a gerar (padrão: 1, máximo: 9)
model (opcional): Modelo de IA a usar (padrão: gemini-3-pro-image-preview)
image_size (opcional): Proporção da imagem de saída

Valores suportados para model:

Valores suportados para image_size:

1:1
16:9
9:16
4:3
3:4
2:3
3:2
4:5
5:4

Tamanhos adicionais suportados apenas por modelos gemini-3.1-flash:

21:9
1:4
4:1
8:1
1:8

Dedução de Créditos

gemini-2.5-flash-image: Por imagem: 2 créditos
gemini-3-pro-image-preview: Por imagem: 8 créditos
gemini-3-pro-image-preview-2k: Por imagem: 8 créditos
gemini-3-pro-image-preview-4k: Por imagem: 16 créditos
gemini-3.1-flash-image-preview-512: Por imagem: 4 créditos
gemini-3.1-flash-image-preview: Por imagem: 4 créditos
gemini-3.1-flash-image-preview-2k: Por imagem: 6 créditos
gemini-3.1-flash-image-preview-4k: Por imagem: 8 créditos

Resposta

{
  "code": 0,
  "message": "ok",
  "data": {
    "url": "https://api.nanobananaapi.dev/v1/images/1234567890.png"
  }
}

Exemplo com curl

curl -X POST "https://api.nanobananaapi.dev/v1/images/edit" \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Transforme esta paisagem em uma cena de inverno com neve",
    "image": "https://example.com/image.jpg",
    "num": 1,
    "model": "gemini-3-pro-image-preview"
  }'

On this page