> ## 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 para imagem do Gemini
> Gere imagens Nano Banana pela API Gemini da BetterToken. Selecione modelo, descrição, resolução e proporção e teste solicitações no painel interativo da documentação.
Gere imagens por texto com Nano Banana Pro, 2 ou 2.1.
`POST /v1beta/models/{model}:generateContent`
A geração por texto e a edição usam o mesmo endpoint. Para editar, adicione uma imagem de referência à solicitação.
## Testar uma solicitação
Informe sua BetterToken API Key em **x-goog-api-key**, escolha **model** e altere o texto em **contents**. Comece com `1K` e `1:1` e clique em **Send**.
Clicar em **Send** envia uma solicitação real de geração que pode gerar cobrança. Aguarde a resposta síncrona. Após timeout ou desconexão, confira o consumo e o resultado antes de reenviar.
Os três oferecem `1K`, `2K` e `4K`. Nano Banana 2 e 2.1 aceitam 14 proporções; Pro aceita 10. `X-BetterToken-Max-Images` limita imagens retornadas e cobradas, sem garantir essa quantidade. [Proporções](/pt-br/api-reference/nano-banana#aspect-ratios)
A BetterToken API não oferece geração com pesquisa, incluindo Google Web Search e Image Search grounding. Não adicione ferramentas de pesquisa.
Para gerar por texto, basta uma descrição; não é preciso imagem de referência. Use `generateContent` sem streaming. Files, Batch, Interactions e streaming não são aceitos.
## Ler a resposta
As imagens ficam em `candidates[].content.parts[].inlineData`. Percorra os elementos, ignore `thought: true`, decodifique `data` e escolha a extensão por `mimeType`. Não presuma que a imagem está no primeiro elemento nem que sempre é PNG.
## Guias relacionados
* [Edição de imagens](/pt-br/api-reference/gemini-images-edits)
* [SDK, salvamento e edições sucessivas](/pt-br/api-reference/nano-banana)
* [Apresentação dos modelos](/pt-br/model-updates/nano-banana)
* Catálogo de modelos
## OpenAPI
````yaml api-reference/gemini-images-generations.pt-br.json POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
title: API de texto para imagem do Gemini
description: >-
Gere imagens Nano Banana pela API Gemini da BetterToken. Selecione modelo,
descrição, resolução e proporção e teste solicitações no painel interativo
da documentação.
version: 1.0.0
servers:
- url: https://bettertoken.ai
security:
- geminiApiKey: []
paths:
/v1beta/models/{model}:generateContent:
post:
summary: API de texto para imagem do Gemini
description: >-
Gere imagens por texto com Nano Banana Pro, 2 ou 2.1. A BetterToken API
não oferece geração com pesquisa, incluindo Google Web Search e Image
Search grounding. Não adicione ferramentas de pesquisa.
operationId: generateGeminiImage_pt_br
parameters:
- name: model
in: path
required: true
description: Model ID da BetterToken. Escolha um dos três 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 imagens retornadas e cobradas, não uma quantidade
garantida. Padrão: 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: >-
Histórico. Preserve o content completo do modelo e
thoughtSignature nas próximas edições.
minItems: 1
items:
type: object
required:
- parts
properties:
role:
type: string
description: >-
user para uma nova solicitação; model para respostas
anteriores no histórico.
enum:
- user
- model
default: user
parts:
type: array
description: >-
Texto e imagens. Coloque text e inlineData em
elementos separados.
minItems: 1
items:
anyOf:
- type: object
required:
- text
properties:
text:
type: string
description: Descrição da imagem ou instrução de edição.
example: >-
Fotografia de estúdio de uma caneca de
cerâmica azul sobre uma mesa branca.
additionalProperties: true
- type: object
required:
- inlineData
properties:
inlineData:
type: object
description: Referência incorporada em base64.
required:
- mimeType
- data
properties:
mimeType:
type: string
description: Tipo MIME da referência.
enum:
- image/png
- image/jpeg
example: image/png
data:
type: string
description: >-
Bytes da imagem em base64 sem prefixo
Data URL.
contentEncoding: base64
example: REPLACE_WITH_IMAGE_BASE64
additionalProperties: false
additionalProperties: true
additionalProperties: false
generationConfig:
type: object
description: Configurações de geração.
properties:
responseModalities:
type: array
description: Solicite explicitamente a saída de imagem.
items:
type: string
enum:
- IMAGE
default:
- IMAGE
candidateCount:
type: integer
enum:
- 1
default: 1
description: Omita ou use o inteiro 1. Não envie n na raiz.
imageConfig:
type: object
description: Configurações de saída da imagem.
properties:
imageSize:
type: string
description: Resolução. Use K maiúsculo.
enum:
- 1K
- 2K
- 4K
default: 1K
aspectRatio:
type: string
description: >-
Proporção. Pro aceita 10; 2 e 2.1 também aceitam
1:4, 4:1, 1:8 e 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: >-
Fotografia de estúdio de uma caneca de cerâmica azul
sobre uma mesa branca.
generationConfig:
responseModalities:
- IMAGE
candidateCount: 1
imageConfig:
imageSize: 1K
aspectRatio: '1:1'
responses:
'200':
description: Resultado. Verifique imagens finais e 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 ou recurso não aceito.
'401':
description: API Key ausente ou inválida.
'402':
description: Saldo insuficiente.
'429':
description: Limite de solicitações ou serviço ocupado.
'500':
description: Erro de geração. Confira o resultado antes de tentar novamente.
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.