Nano Banana: texto para imagem e tamanho
IDs de modelo e escolha de endpoint: visão geral do Nano Banana.
aspectRatio e a resolução por imageSize; ambos ficam em generationConfig.imageConfig.Exemplo de texto para imagem
Python
import base64
from google import genai
from google.genai import types
client = genai.Client(
api_key="YOUR_OFOX_API_KEY",
http_options={"api_version": "v1beta", "base_url": "https://api.ofox.io/gemini"},
)
resp = client.models.generate_content(
model="google/gemini-3.1-flash-image",
contents="Uma maçã vermelha sobre uma mesa branca",
config=types.GenerateContentConfig(
response_modalities=["IMAGE"],
image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
),
)
for part in resp.candidates[0].content.parts:
if part.inline_data:
with open("output.png", "wb") as f:
f.write(part.inline_data.data)No SDK de Python, inline_data.data vem em binário e pode ser gravado diretamente em arquivo; no cURL, o retorno é uma string base64, que precisa ser decodificada primeiro.
Valores suportados por modelo
As 10 proporções comuns: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9. Proporções fora da lista (como 5:3) retornam 400 Request contains an invalid argument.
Como escrever a resolução: recomenda-se usar as maiúsculas 1K, 2K e 4K em imageSize, como na documentação oficial do Google; em nossas medições, a OfoxAI também aceita minúsculas. O nível 512 não leva a unidade K.
Sem imageConfig: o modelo decide a proporção. Se precisar de uma proporção fixa, informe-a explicitamente.
Tamanhos de saída medidos
Um PNG em 4K tem cerca de 16 MB; codificado em base64, o corpo da resposta passa de 20 MB. Confirme que o cliente, os proxies e o sistema de logs não truncam respostas grandes.
Em caso de erro, consulte Solução de erros.