Guia da API Nano Banana: Geração e Edição de Imagens via TokenLab

A API Nano Banana oferece aos desenvolvedores recursos de geração e edição de imagens de alto rendimento, acessíveis diretamente através da camada de API unificada do TokenLab. Este guia demonstra como autenticar, estruturar payloads e integrar esses pipelines de geração de imagem em suas aplicações de produção.

Principais pontos

• A API Nano Banana é especializada em geração rápida de imagens e tarefas de edição precisas.
• O TokenLab simplifica a integração fornecendo um SDK único e faturamento unificado para múltiplos provedores de modelos.
• As estruturas de payload exigem dimensões, formatos de prompt e parâmetros de força específicos para um resultado ideal.
• Os desenvolvedores podem comparar o desempenho e as métricas de preços da Nano Banana com outros modelos padrão da indústria diretamente no TokenLab.

O que é a API Nano Banana?

A API Nano Banana é uma interface especializada projetada para geração e manipulação de imagens de baixa latência. Ela atende desenvolvedores que precisam de prototipagem rápida e fluxos de trabalho de produção escaláveis sem a sobrecarga de gerenciar modelos de difusão auto-hospedados. Ao rotear solicitações através do TokenLab, os desenvolvedores podem acessar este modelo junto com um conjunto mais amplo de ferramentas.

Ao avaliar a melhor API de modelos de imagem de IA em 2026, os desenvolvedores frequentemente comparam a Nano Banana com modelos maiores como Stable Diffusion XL ou Midjourney. Embora esses modelos ofereçam resultados de alta fidelidade para prompts complexos, a Nano Banana foca na velocidade de execução e eficiência de custos. Você pode revisar as especificações técnicas e a disponibilidade deste modelo no diretório de modelos do TokenLab (observado em 07/07/2026).

Autenticação e Configuração via TokenLab

Para interagir com a API Nano Banana, você deve rotear suas solicitações através do gateway do TokenLab. Isso requer uma chave de API e um cliente HTTP padrão. A lista de verificação a seguir descreve as etapas necessárias para preparar seu ambiente de desenvolvimento.

Lista de verificação de integração

• Crie uma conta de desenvolvedor ativa no TokenLab.
• Gere uma chave de API de produção no painel do TokenLab.
• Salve a chave de API como uma variável de ambiente chamada TOKENLAB_API_KEY.
• Instale uma biblioteca de cliente HTTP, como requests em Python ou axios em Node.js.
• Verifique o saldo da sua conta ou a configuração de faturamento para garantir chamadas de API ininterruptas.

Após concluir essas etapas, configure seu cliente para apontar para o endpoint do TokenLab. A URL base para todas as solicitações é https://api.tokenlab.sh/v1, e a chave de API deve ser passada no cabeçalho de autorização.

# Exemplo de comando curl para verificar a autenticação
curl -X GET "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Implementando a Geração de Imagens com a API Nano Banana

A geração de texto para imagem é o principal ponto de entrada para a API Nano Banana. A API aceita um payload JSON contendo o prompt de texto, as dimensões desejadas e os parâmetros de inferência.

Para entender como os custos operacionais da Nano Banana se comparam a outros modelos, consulte o guia de comparação de preços do TokenLab. Como os preços dos modelos podem mudar com base nas atualizações dos provedores, os leitores devem verificar os preços atuais na fonte vinculada.

O script Python abaixo demonstra como enviar uma solicitação de texto para imagem para a API Nano Banana através do TokenLab.

import os
import requests
import json

def generate_image(prompt, width=512, height=512):
    api_key = os.getenv("TOKENLAB_API_KEY")
    if not api_key:
        raise ValueError("A variável de ambiente TOKENLAB_API_KEY não está definida.")

    url = "https://api.tokenlab.sh/v1/images/generations"
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    
    payload = {
        "model": "nano-banana",
        "prompt": prompt,
        "width": width,
        "height": height,
        "num_inference_steps": 30,
        "guidance_scale": 7.5,
        "response_format": "url"
    }

    response = requests.post(url, headers=headers, json=payload)
    
    if response.status_code == 200:
        data = response.json()
        return data["data"][0]["url"]
    else:
        raise Exception(f"Erro da API {response.status_code}: {response.text}")

# Exemplo de uso
if __name__ == "__main__":
    prompt_text = "Um retrato de estúdio minimalista de um vaso de cerâmica em uma mesa de madeira"
    try:
        image_url = generate_image(prompt_text)
        print(f"URL da Imagem Gerada: {image_url}")
    except Exception as e:
        print(f"A geração falhou: {e}")

Ao estruturar seus prompts, use substantivos descritivos e concretos. A API Nano Banana processa os pesos dos prompts sequencialmente, o que significa que os termos colocados no início do prompt exercem uma influência maior no resultado final do que os termos colocados no final.

Fluxos de Trabalho de Edição de Imagem e Inpainting

Além da geração padrão de texto para imagem, a API Nano Banana suporta modificações de imagem para imagem e inpainting localizado. Esses fluxos de trabalho exigem uma imagem de origem inicial e, no caso de inpainting, uma máscara em preto e branco indicando a região a ser modificada.

Para executar uma tarefa de imagem para imagem, você deve fornecer a imagem de origem como uma string codificada em base64 ou uma URL publicamente acessível. O parâmetro strength determina o quanto o modelo altera a imagem original. Um valor de força de 0.0 deixa a imagem original inalterada, enquanto um valor de 1.0 descarta completamente a estrutura original em favor do novo prompt.

# Estrutura de payload conceitual para edição de imagem para imagem
edit_payload = {
    "model": "nano-banana",
    "prompt": "Adicione um céu azul com nuvens brancas suaves",
    "image": "data:image/jpeg;base64,...", # Imagem de origem codificada em Base64
    "strength": 0.6,
    "guidance_scale": 8.0
}

Para tarefas de inpainting, a imagem da máscara deve corresponder às dimensões da imagem de origem. Pixels brancos na máscara representam as áreas a serem redesenhadas, enquanto pixels pretos permanecem bloqueados. Essa abordagem é altamente eficaz para aplicações de e-commerce, como alterar o fundo da foto de um produto mantendo o produto intacto.

Para começar a integrar este modelo à sua stack, Comece agora com o TokenLab hoje mesmo.

Comparando a Nano Banana com APIs Alternativas

A seleção do modelo certo depende dos requisitos específicos da sua aplicação em relação à latência, qualidade de saída e custo. A tabela abaixo compara a API Nano Banana com outros modelos proeminentes disponíveis na indústria.

Modelo / API	Caso de Uso Principal	Ponto Forte	Fonte de Referência de Preço
API Nano Banana	Geração e edição rápida de imagens	Baixa latência, estrutura de payload simples	Modelos TokenLab (observado em 07/07/2026)
Google Gemini (Imagen)	Tarefas multimodais e geração de alta resolução	Segurança corporativa, integração com ecossistema Google	Preços Google AI (observado em 07/07/2026)
Stable Diffusion	Geração altamente personalizável	Flexibilidade de código aberto, suporte a LoRA personalizado	Categoria de Imagem TokenLab

Para desenvolvedores que constroem sistemas complexos, comparar roteadores de API também é um passo crítico. Você pode ler nossa comparação do OpenRouter para entender como os gateways de API de múltiplos provedores gerenciam o roteamento e o failover.

Se sua aplicação requer recursos além de imagens estáticas, você pode querer revisar a melhor API de modelos de vídeo de IA em 2026 ou explorar os melhores modelos de IA para codificação em 2026 para apoiar seus fluxos de trabalho de desenvolvimento.

Compare modelos de imagem no TokenLab para encontrar o equilíbrio ideal de velocidade, custo e qualidade para sua aplicação.

Perguntas Frequentes

Qual é a resolução máxima suportada pela API Nano Banana?

A API Nano Banana suporta nativamente resoluções de até 1024x1024 pixels. Embora você possa solicitar proporções não quadradas, como 16:9 ou 4:3, manter a contagem total de pixels próxima à resolução nativa ajuda a evitar artefatos visuais, como assuntos duplicados.

Como o TokenLab lida com limites de taxa para a API Nano Banana?

O TokenLab gerencia os limites de taxa dinamicamente com base no nível da sua conta. Se sua aplicação exceder as solicitações permitidas por minuto, a API retornará um código de status 429 Too Many Requests. Recomenda-se implementar o backoff exponencial em seu cliente HTTP para lidar com esses limites de forma elegante.

Posso usar a Nano Banana para aplicações comerciais?

Sim, as imagens geradas através da API Nano Banana via TokenLab geralmente são liberadas para uso comercial. No entanto, os desenvolvedores devem garantir que seus prompts de entrada e imagens de origem não violem a propriedade intelectual de terceiros ou as políticas de uso aceitável da plataforma.