Imagen a Imagen

Descripción General

Usa tu clave API para editar o transformar imágenes existentes mediante un endpoint HTTP simple. Los créditos se deducen automáticamente según el número de imágenes procesadas.

Endpoint

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

Autenticación

Incluye tu clave API en el header Authorization. ¿Aún no tienes una? Crea tu clave API aquí.

Authorization: Bearer TU_API_KEY
Content-Type: application/json

Cuerpo de la Petición

{
  "prompt": "Transforma este paisaje en una escena invernal con nieve",
  "image": "https://example.com/image.jpg",
  "num": 1,
  "model": "gemini-3-pro-image-preview",
  "image_size": "16:9"
}

Parámetros

prompt (requerido): Descripción textual de la transformación deseada
image (requerido): URL de imagen fuente o data URL base64. Puede ser una cadena o un array de cadenas
num (opcional): Número de variaciones a generar (por defecto: 1, máximo: 9)
model (opcional): Modelo de IA a usar (por defecto: gemini-3-pro-image-preview)
image_size (opcional): Relación de aspecto de la imagen de salida

Valores soportados para model:

Valores soportados para image_size:

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

Tamaños adicionales soportados solo por modelos gemini-3.1-flash:

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

Deducción de Créditos

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

Respuesta

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

Ejemplo con curl

curl -X POST "https://api.nanobananaapi.dev/v1/images/edit" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Transforma este paisaje en una escena invernal con nieve",
    "image": "https://example.com/image.jpg",
    "num": 1,
    "model": "gemini-3-pro-image-preview"
  }'

On this page