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
service_tier (opcional): Seleção do nível de serviço (padrão: default)
- default: Capacidade compartilhada padrão, menor custo de créditos
- priority: Capacidade de maior prioridade com melhor estabilidade, 1.5x custo de créditos

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

Nível Padrão (default)

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

Nível Prioritário (priority, 1.5x)

gemini-2.5-flash-image: Por imagem: 3 créditos
gemini-3-pro-image-preview: Por imagem: 12 créditos
gemini-3-pro-image-preview-2k: Por imagem: 12 créditos
gemini-3-pro-image-preview-4k: Por imagem: 24 créditos
gemini-3.1-flash-image-preview-512: Por imagem: 6 créditos
gemini-3.1-flash-image-preview: Por imagem: 6 créditos
gemini-3.1-flash-image-preview-2k: Por imagem: 9 créditos
gemini-3.1-flash-image-preview-4k: Por imagem: 12 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