Skip to main content
POST
API de texto para imagem do Gemini
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
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

Autorizações

x-goog-api-key
string
header
obrigatório

BetterToken API Key.

Cabeçalhos

X-BetterToken-Max-Images
integer
padrão:1

Máximo de imagens retornadas e cobradas, não uma quantidade garantida. Padrão: 1.

Intervalo obrigatório: 1 <= x <= 4

Parâmetros de caminho

model
enum<string>
padrão:nano-banana-2.1
obrigatório

Model ID da BetterToken. Escolha um dos três modelos Nano Banana.

Opções disponíveis:
nano-banana-pro,
nano-banana-2,
nano-banana-2.1

Corpo

application/json
contents
object[]
obrigatório

Histórico. Preserve o content completo do modelo e thoughtSignature nas próximas edições.

Minimum array length: 1
generationConfig
object

Configurações de geração.

Resposta

Resultado. Verifique imagens finais e finishReason.

candidates
object[]
promptFeedback
object
usageMetadata
object