Skip to main content
POST
API de texto a imagen de Gemini
Genera imágenes a partir de texto con Nano Banana Pro, 2 o 2.1. POST /v1beta/models/{model}:generateContent La generación por texto y la edición usan el mismo endpoint. Para editar, añade una imagen de referencia a la solicitud.

Probar una solicitud

Introduce tu BetterToken API Key en x-goog-api-key, elige model y cambia el texto en contents. Empieza con 1K y 1:1 y pulsa Send.
Al pulsar Send se envía una solicitud real de generación que puede generar cargos. Espera la respuesta síncrona. Tras un timeout o desconexión, comprueba el consumo y el resultado antes de reenviar.
Los tres ofrecen 1K, 2K y 4K. Nano Banana 2 y 2.1 admiten 14 proporciones; Pro admite 10. X-BetterToken-Max-Images limita las imágenes devueltas y facturables, sin garantizar esa cantidad. Proporciones
BetterToken API no admite generación con búsqueda, incluidos Google Web Search e Image Search grounding. No añadas herramientas de búsqueda.
Para generar por texto basta una descripción; no hace falta imagen de referencia. Usa generateContent sin streaming. No se admiten Files, Batch, Interactions ni streaming.

Leer la respuesta

Las imágenes aparecen en candidates[].content.parts[].inlineData. Recorre los elementos, omite thought: true, decodifica data y elige la extensión según mimeType. No presupongas que la imagen es el primer elemento ni que siempre es PNG.

Guías relacionadas

Autorizaciones

x-goog-api-key
string
header
requerido

BetterToken API Key.

Encabezados

X-BetterToken-Max-Images
integer
predeterminado:1

Máximo de imágenes devueltas y facturables, no una cantidad garantizada. Valor predeterminado: 1.

Rango requerido: 1 <= x <= 4

Parámetros de ruta

model
enum<string>
predeterminado:nano-banana-2.1
requerido

Model ID de BetterToken. Elige uno de los tres modelos Nano Banana.

Opciones disponibles:
nano-banana-pro,
nano-banana-2,
nano-banana-2.1

Cuerpo

application/json
contents
object[]
requerido

Historial. Conserva el content completo del modelo y thoughtSignature para siguientes ediciones.

Minimum array length: 1
generationConfig
object

Configuración de generación.

Respuesta

Resultado. Comprueba los elementos de imagen finales y finishReason.

candidates
object[]
promptFeedback
object
usageMetadata
object