PT ▾

API de texto sem censura para seu pipeline

Preço da API Nano Banana: custos por token explicados

Resposta curta: este serviço cobra $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, a partir de crédito pré-pago sem assinatura. É uma API de texto, não um gerador de imagens, então os preços abaixo são apenas para texto.

Atualizado

Ilustração isométrica de uma balança pesando moedas contra fluxos de tokens, representando o preço da API por token

Pontos-chave

  • A entrada é $0,15 por 1M de tokens e a saída é $0,50 por 1M de tokens.
  • Recarregue qualquer valor inteiro de $20 a $500, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200.
  • Requisições falhas ou recusadas não são cobradas e o crédito nunca expira.
  • Um crédito de teste de $0,50 pode ser obtido com um clique após o cadastro, válido por 7 dias.

A lista de preços em uma tabela

Pessoas que buscam preço da API Nano Banana frequentemente comparam custos de geração de imagens, geralmente cotados por imagem. Este site é diferente. Ele vende acesso a um modelo de linguagem de texto através de um endpoint compatível com OpenAI, e o texto é cobrado por token. Se você precisa de imagens, este não é o produto certo, mas ele se encaixa bem ao lado de uma ferramenta de imagem para escrever prompts, legendas e roteiros.

ItemPreço ou regra
Tokens de entrada$0,15 por 1M
Tokens de saída$0,50 por 1M
AssinaturaNenhum, pagamento por uso
Recarga mínima$20 (valores inteiros até $500)
Requisições falhas ou recusadasNão cobrado
ValidadeNunca
Teste$0,50, um clique, 7 dias, sem cartão

Os valores atuais estão na página de preços, e você obtém uma chave na página da chave de API.

O que é um token, em termos monetários

Um token é um trecho de texto, muitas vezes uma palavra curta ou parte de uma mais longa. Como regra prática para o inglês, 1.000 tokens equivalem a pouco menos de 800 palavras, embora isso varie conforme o texto. Você é cobrado por duas contagens em cada chamada: os tokens que você envia (o prompt, incluindo qualquer mensagem de sistema e o histórico da conversa) e os tokens que o modelo escreve de volta.

A saída custa mais que a entrada, cerca de 3,3 vezes mais por token ($0,50 dividido por $0,15). Isso tem uma consequência prática. Uma chamada que envia um documento longo e pede uma resposta de uma linha é barata. Uma chamada que envia uma frase e pede uma história longa custa mais por palavra de texto do que o inverso. Ao planejar um orçamento, estime primeiro o tamanho da saída.

A fórmula é simples:

cost = (input_tokens x 0.15 + output_tokens x 0.50) / 1,000,000

Cada resposta inclui um objeto de uso com as contagens exatas, e o cabeçalho de resposta X-Balance-USD relata seu crédito restante, para que você possa verificar os cálculos contra chamadas reais.

Exemplos práticos

Esses números são calculados diretamente pelos dois preços.

Uma mensagem de chat

2.000 tokens de entrada e 500 tokens de saída. Entrada: 2.000 x $0,15 / 1M = $0,0003. Saída: 500 x $0,50 / 1M = $0,00025. Total: $0,00055. O crédito de teste de $0,50 cobre cerca de 909 mensagens assim, já que 0,50 / 0,00055 é 909.

Um lote de escrita de prompt para um fluxo de trabalho de imagem

500 requisições, cada uma com 400 tokens de entrada e 600 tokens de saída. Entrada: 200.000 tokens x $0,15 / 1M = $0,03. Saída: 300.000 tokens x $0,50 / 1M = $0,15. Total: $0,18.

Uma história longa com um contexto grande

Uma requisição com 6.000 tokens de notas e uma resposta de 1.500 tokens. Entrada: $0,0009. Saída: $0,00075. Total: $0,00165. Mil desses custam $1,65.

O pior caso para uma chamada

A janela de contexto é de 100.000 tokens, prompt e completção juntos. Preencha 96.000 com entrada e deixe o modelo escrever 4.000: entrada é 96.000 x $0,15 / 1M = $0,0144 e saída é 4.000 x $0,50 / 1M = $0,002, para $0,0164. Mesmo uma requisição no máximo custa menos de dois centavos.

Um loop de agente

Um agente faz 50 chamadas, cada uma reenviando 20.000 tokens de histórico e escrevendo 1.000 tokens. Entrada: 1.000.000 tokens = $0,15. Saída: 50.000 tokens = $0,025. Total: $0,175. Este é o caso que surpreende as pessoas, porque o histórico é faturado novamente em cada chamada. Remova mensagens antigas ou resuma-as para manter a contagem de entrada baixa.

Recargas, bônus e como pagar

O crédito é pré-pago. Você escolhe qualquer valor inteiro de dólar de $20 a $500. Recargas maiores adicionam um bônus adicional:

RecargaBônusCrédito recebido
$20nenhum$20.00
$50+5%$52.50
$100+10%$110.00
$200+15%$230.00
$500+15%$575.00

O pagamento é por cripto (USDT na TRC20, USDC na Base). Como o crédito nunca expira, uma recarga maior é simplesmente uma taxa melhor, sem prazo limite pressionando você a gastá-lo. Uma recarga de $20 no tamanho de mensagem de chat acima compra aproximadamente 36.000 mensagens.

Crédito de teste e limites de requisições

Para experimentar o serviço primeiro, cadastre-se com Google ou com e-mail e senha, depois pressione o botão de resgate na página da chave. Você recebe $0,50 de crédito de teste, um por pessoa, válido por 7 dias, sem necessidade de cartão. Uma chave de teste permite 2 requisições simultâneas e 60 requisições por minuto.

Uma chave completa, ou seja, uma com crédito pago, permite 8 requisições simultâneas e 300 requisições por minuto. Estes são limites de velocidade, não de gasto. Se você excedê-los, receberá HTTP 429 com o código rate_limited ou concurrency, e uma sobrecarga temporária retorna 429 com Retry-After: 5. Como requisições falhas não são cobradas, um 429 nunca custa dinheiro; significa apenas que você deve esperar.

Use o teste para algo que se assemelhe ao seu tráfego real, não um prompt hello-world, para que os números de uso que você mede digam algo sobre a conta.

Estimando sua própria conta

Você pode obter uma estimativa decente em poucos minutos com um script curto que executa uma amostra dos seus prompts reais e soma o uso.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.nanobananaapis.com/v1",
    api_key=os.environ["NANOBANANA_KEY"],
)

IN_PRICE, OUT_PRICE = 0.15, 0.50   # dollars per 1M tokens
prompts = ["Write an image prompt for a desert market at noon.", "Write a caption for a paper boat photo."]

total = 0.0
for p in prompts:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": p}],
        max_tokens=300,
    )
    u = r.usage
    cost = (u.prompt_tokens * IN_PRICE + u.completion_tokens * OUT_PRICE) / 1_000_000
    total += cost
    print(u.prompt_tokens, u.completion_tokens, round(cost, 6))

print("sample total:", round(total, 6))

Multiplique a média pela contagem mensal esperada de chamadas, depois adicione uma margem de 20 a 30 por cento para retentativas e saídas mais longas do que o esperado. Defina max_tokens se quiser um limite rígido no tamanho da saída, embora seja opcional. Para os detalhes de configuração por trás deste snippet, consulte a página de documentação.

Finalmente, duas coisas que não estão na conta: não há cobrança por chamadas falhas ou recusadas, e os prompts não são usados para treinamento. Para uma etapa de texto em um pipeline de imagem, como a descrita no artigo do gerador de prompts, o custo por prompt gerado geralmente é uma pequena fração de um centavo.

Formas de manter a conta baixa

Como a unidade é o token, a maioria das economias vem de enviar e receber menos deles. Essas mudanças ajudam aproximadamente nesta ordem.

  1. Limite o histórico. Em um chat ou agente, rodadas antigas são cobradas novamente a cada nova chamada. Mantenha as últimas algumas rodadas e substitua o restante por um resumo curto.
  2. Encurte a mensagem do sistema. Um conjunto de 1.500 tokens de instruções enviado 100.000 vezes gera 150M de tokens de entrada, o que equivale a $22,50 a $0,15 por 1M. Se metade disso for preenchimento, você está pagando por preenchimento.
  3. Peça o tamanho que você precisa. A saída é o lado caro. Diga "duas frases" ou "um objeto JSON com três campos" em vez de deixar o modelo divagar, e defina max_tokens como um teto.
  4. Agrupe perguntas relacionadas. Uma requisição que pede cinco itens curtos geralmente custa menos do que cinco requisições separadas que repetem o mesmo contexto.
  5. Não tente novamente cegamente. Um erro 429 é gratuito, mas um loop de nova tentativa sem atraso apenas consome tempo. Aguarde cinco segundos e tente novamente.
  6. Teste em uma pequena amostra. Execute 20 requisições reais, leia os números de uso e só então execute o conjunto completo.

Nada disso precisa de ferramentas especiais. O objeto de uso em cada resposta é suficiente para encontrar qual prompt é o pesado.

Perguntas a fazer antes de comparar preços

Comparar preços por token entre serviços só é justo quando os produtos são semelhantes. Antes de colocar dois números lado a lado, verifique estes pontos e confira a tabela de preços atual de cada provedor por conta própria, em vez de confiar em tabelas de terceiros.

  • Mesmo tipo de saída? Tokens de texto e preços por imagem não são unidades comparáveis. Este serviço é apenas de texto.
  • Mesmo comportamento de recusa? Uma resposta recusada ou filtrada que você ainda paga é mais cara do que o preço de lista sugere. Aqui, as requisições recusadas e com falha não são cobradas.
  • Crédito pré-pago ou assinatura? Uma mensalidade é um custo fixo, independentemente de você usar o serviço ou não. Crédito pré-pago que nunca expira não tem esse custo fixo.
  • Quais são os limites? Um preço de token barato com requisições paralelas limitadas pode custar tempo de espera. Aqui, são 8 requisições simultâneas e 300 por minuto em uma chave de API.
  • A janela de contexto é grande o suficiente? Uma janela de 100.000 tokens cobre documentos longos e conversas longas em uma única chamada.

Quando seus números parecerem corretos, crie uma chave, gaste o crédito de teste nos seus prompts reais e compare o custo medido por tarefa com seu orçamento.

Perguntas e respostas

Quanto custa a API por token?

Tokens de entrada custam $0,15 por 1M e tokens de saída custam $0,50 por 1M. Não há assinatura nem gasto mensal mínimo.

Existe um teste gratuito?

Novos usuários podem resgatar $0,50 de crédito de teste com um clique na página da chave de API após o cadastro. Não precisa de cartão, é válido por 7 dias e limitado a um por pessoa.

O crédito expira?

Não. O crédito pré-pago nunca expira e você pode recarregar qualquer valor inteiro de $20 a $500.

Isso é cobrado por imagem?

Não. Esta é uma API apenas de texto cobrada por token. Ela não gera imagens, áudio ou vídeo.

É cobrado quando uma requisição falha?

Não. Requisições falhas ou recusadas não são cobradas.

Sua chave está a um formulário de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API