> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# API de texto a imagen de Gemini
> Genera imágenes Nano Banana con la API Gemini de BetterToken. Selecciona modelo, descripción, resolución y proporción y prueba solicitudes en el panel interactivo.
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](/es/api-reference/nano-banana#aspect-ratios)
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
* [Edición de imágenes](/es/api-reference/gemini-images-edits)
* [SDK, guardado y edición por turnos](/es/api-reference/nano-banana)
* [Presentación de modelos](/es/model-updates/nano-banana)
* Catálogo de modelos
## OpenAPI
````yaml api-reference/gemini-images-generations.es.json POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
title: API de texto a imagen de Gemini
description: >-
Genera imágenes Nano Banana con la API Gemini de BetterToken. Selecciona
modelo, descripción, resolución y proporción y prueba solicitudes en el
panel interactivo.
version: 1.0.0
servers:
- url: https://bettertoken.ai
security:
- geminiApiKey: []
paths:
/v1beta/models/{model}:generateContent:
post:
summary: API de texto a imagen de Gemini
description: >-
Genera imágenes a partir de texto con Nano Banana Pro, 2 o 2.1.
BetterToken API no admite generación con búsqueda, incluidos Google Web
Search e Image Search grounding. No añadas herramientas de búsqueda.
operationId: generateGeminiImage_es
parameters:
- name: model
in: path
required: true
description: Model ID de BetterToken. Elige uno de los tres modelos Nano Banana.
schema:
type: string
enum:
- nano-banana-pro
- nano-banana-2
- nano-banana-2.1
default: nano-banana-2.1
- name: X-BetterToken-Max-Images
in: header
description: >-
Máximo de imágenes devueltas y facturables, no una cantidad
garantizada. Valor predeterminado: 1.
schema:
type: integer
minimum: 1
maximum: 4
default: 1
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- contents
properties:
contents:
type: array
description: >-
Historial. Conserva el content completo del modelo y
thoughtSignature para siguientes ediciones.
minItems: 1
items:
type: object
required:
- parts
properties:
role:
type: string
description: >-
user para solicitudes nuevas; model para respuestas
anteriores en el historial.
enum:
- user
- model
default: user
parts:
type: array
description: >-
Texto e imágenes. Coloca text e inlineData en
elementos separados.
minItems: 1
items:
anyOf:
- type: object
required:
- text
properties:
text:
type: string
description: >-
Descripción de imagen o instrucción de
edición.
example: >-
Fotografía de estudio de una taza de
cerámica azul sobre una mesa blanca.
additionalProperties: true
- type: object
required:
- inlineData
properties:
inlineData:
type: object
description: Referencia incrustada en base64.
required:
- mimeType
- data
properties:
mimeType:
type: string
description: Tipo MIME de la referencia.
enum:
- image/png
- image/jpeg
example: image/png
data:
type: string
description: Bytes en base64 sin prefijo Data URL.
contentEncoding: base64
example: REPLACE_WITH_IMAGE_BASE64
additionalProperties: false
additionalProperties: true
additionalProperties: false
generationConfig:
type: object
description: Configuración de generación.
properties:
responseModalities:
type: array
description: Solicita explícitamente salida de imagen.
items:
type: string
enum:
- IMAGE
default:
- IMAGE
candidateCount:
type: integer
enum:
- 1
default: 1
description: Omite o usa el entero 1. No envíes n en la raíz.
imageConfig:
type: object
description: Configuración de imagen de salida.
properties:
imageSize:
type: string
description: Resolución. Usa K mayúscula.
enum:
- 1K
- 2K
- 4K
default: 1K
aspectRatio:
type: string
description: >-
Proporción. Pro admite 10; 2 y 2.1 también admiten
1:4, 4:1, 1:8 y 8:1.
enum:
- '1:1'
- '1:4'
- '1:8'
- '2:3'
- '3:2'
- '3:4'
- '4:1'
- '4:3'
- '4:5'
- '5:4'
- '8:1'
- '9:16'
- '16:9'
- '21:9'
default: '1:1'
additionalProperties: false
additionalProperties: false
additionalProperties: false
example:
contents:
- role: user
parts:
- text: >-
Fotografía de estudio de una taza de cerámica azul sobre
una mesa blanca.
generationConfig:
responseModalities:
- IMAGE
candidateCount: 1
imageConfig:
imageSize: 1K
aspectRatio: '1:1'
responses:
'200':
description: Resultado. Comprueba los elementos de imagen finales y finishReason.
content:
application/json:
schema:
type: object
properties:
candidates:
type: array
items:
type: object
properties:
content:
type: object
properties:
role:
type: string
parts:
type: array
items:
type: object
properties:
text:
type: string
thought:
type: boolean
thoughtSignature:
type: string
inlineData:
type: object
properties:
mimeType:
type: string
data:
type: string
contentEncoding: base64
finishReason:
type: string
promptFeedback:
type: object
additionalProperties: true
usageMetadata:
type: object
additionalProperties: true
example:
candidates:
- content:
role: model
parts:
- inlineData:
mimeType: image/png
data: BASE64_IMAGE_DATA
finishReason: STOP
'400':
description: Parámetros inválidos o función no admitida.
'401':
description: API Key ausente o inválida.
'402':
description: Saldo insuficiente.
'429':
description: Límite de solicitudes o servicio ocupado.
'500':
description: Error de generación. Comprueba el resultado antes de reintentar.
components:
securitySchemes:
geminiApiKey:
type: apiKey
in: header
name: x-goog-api-key
description: BetterToken API Key.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.