Modelos y parámetros

01Catálogo

El precio se indica por cada imagen, en dólares estadounidenses, y depende de la resolución. El cargo se hace al aceptar la solicitud, y una solicitud fallida es gratis: el importe vuelve de inmediato al saldo.

Los nombres de los modelos son identificadores para el campo model. Los modelos que tienes disponibles y tus precios los devuelve GET /models: una cuenta puede tener un precio personal o una lista más corta.

02Resolución y relación de aspecto

• resolution: 1K, 2K o 4K, da igual si es mayúscula o minúscula. Los valores admitidos dependen del modelo: solo 1K en Nano Banana Flash, Nano Banana 2 Lite, GPT Image 2 y GPT Image 2.5.
• Si no se indica resolution, la imagen se genera en la resolución predeterminada: 2K en Nano Banana Pro, Nano Banana 2 y Nano Banana 2.1, y 1K en Nano Banana Flash, Nano Banana 2 Lite y todos los modelos GPT Image.
• aspect_ratio: un valor exacto del tipo 16:9, sin espacios ni cifras invertidas. El conjunto de relaciones de aspecto depende del modelo.
• Si no se indica aspect_ratio, será 1:1. Que falte el campo no significa auto.
• La resolución es el nivel de tamaño del modelo, no un número de píxeles. Los campos width y height no se aceptan; si tu diseño necesita un tamaño exacto, comprueba las dimensiones del archivo recibido.

Qué significa auto

Nano Banana Pro, Nano Banana 2, Nano Banana 2.1 y Nano Banana Flash pueden elegir la relación de aspecto por sí solos: envía "aspect_ratio": "auto". Con imágenes de referencia, la relación suele repetir la de la primera imagen. Sin imágenes de referencia no se garantiza la relación de aspecto: si tu diseño depende de ella, indica aspect_ratio de forma explícita. Nano Banana 2 Lite y los modelos GPT Image no tienen el valor auto: la relación de aspecto la eliges tú.

Qué pasa si eliges algo imposible

Un modelo que no genera esa resolución o esa relación de aspecto responde 400 antes del cargo. En error.details.supported llega la lista de valores admitidos y no se gasta dinero.

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "Unsupported resolution: 4K. Supported: 1K (case-insensitive) (omit resolution to render 1K).",
    "details": { "resolution": "4K", "supported": ["1K"] }
  }
}

HTTP/1.1 400 Bad Request

{
  "error": {
    "code": "ERR_INVALID_REQUEST",
    "message": "Unsupported aspect_ratio: 5:4. Supported: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 21:9 (omit aspect_ratio to render 1:1).",
    "details": {
      "aspect_ratio": "5:4",
      "supported": [
        "1:1", "16:9", "9:16", "4:3",
        "3:4", "2:3", "3:2", "21:9"
      ]
    }
  }
}

Pruébalo tú: en el constructor de solicitudes, las opciones en gris muestran los mismos rechazos.

03Catálogo mediante la API

El endpoint no hace ningún cargo y no ocupa un slot de generación. Cuenta para el límite general de solicitudes de la cuenta (Límites). El parámetro category es opcional: para imágenes envía image.

curl --fail-with-body --max-time 20 \
  "https://api.rendergrid.io/api/public/v1/models?category=image" \
  -H "Authorization: Bearer $RENDERGRID_API_KEY"

import os
from decimal import Decimal
import requests

key = os.environ["RENDERGRID_API_KEY"]
response = requests.get(
    "https://api.rendergrid.io/api/public/v1/models",
    params={"category": "image"},
    headers={"Authorization": f"Bearer {key}"},
    timeout=(5, 20),
)
response.raise_for_status()

for model in response.json()["models"]:
    # toma el precio de la resolución de variants, no del price raíz
    prices = {
        v["variant_key"]: Decimal(v["price"])
        for v in model.get("variants", [])
    }
    print(model["id"], prices)

// Node.js 22+, archivo .mjs
const base = "https://api.rendergrid.io/api/public/v1";
const url = new URL(`${base}/models`);
url.searchParams.set("category", "image");
const key = process.env.RENDERGRID_API_KEY;
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) {
  const body = await response.text();
  throw new Error(`HTTP ${response.status}: ${body}`);
}

for (const model of (await response.json()).models) {
  // toma el precio de la resolución de variants, no del price raíz
  const prices = Object.fromEntries((model.variants ?? []).map((v) => [v.variant_key, v.price]));
  console.log(model.id, prices);
}

{
  "currency": "USD",
  "models": [
    {
      "id": "nano-banana-2",
      "category": "image",
      "display_name": "Nano Banana 2",
      "price": "0.0250",
      "unit": "per_image",
      "variants": [
        { "variant_key": "1k", "price": "0.0250" },
        { "variant_key": "2k", "price": "0.0400" },
        { "variant_key": "4k", "price": "0.0600" }
      ]
    },
    {
      "id": "gpt-image-2.5",
      "category": "image",
      "display_name": "GPT Image 2.5",
      "price": "0.0250",
      "unit": "per_image",
      "variants": [{ "variant_key": "1k", "price": "0.0250" }]
    }
  ]
}

currency

La moneda de todos los importes de la respuesta: USD.

id

El identificador del modelo para el campo model de la solicitud de generación.

price

El precio de la resolución más barata del modelo, como cadena en dólares. Esto no es el precio de tu imagen: depende de resolution.

unit

La unidad del precio: per_image, por imagen.

variants

Los precios por resolución: variant_key (1k, 2k, 4k) y price; en la respuesta completa cada variante tiene además display_name y unit. Toma aquí el precio de la resolución elegida.

04Precio y cargo

El precio de una imagen depende del modelo y de la resolución. Por ejemplo, Nano Banana 2.1 cuesta $0,02 en 1K, $0,03 en 2K y $0,04 en 4K, y GPT Image 2, $0,02 en 1K. El precio más bajo es $0,015 por imagen en 1K, en Nano Banana Flash y Nano Banana 2 Lite.

Si no se indica resolution, la imagen se genera y se paga en la resolución predeterminada: para Nano Banana Pro, Nano Banana 2 y Nano Banana 2.1 es 2K, aunque el price raíz del catálogo muestre 1K. El importe aparece en el campo cost de la respuesta 202.

FAQPreguntas frecuentes