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.
| Item | Preço ou regra |
|---|---|
| Tokens de entrada | $0,15 por 1M |
| Tokens de saída | $0,50 por 1M |
| Assinatura | Nenhum, pagamento por uso |
| Recarga mínima | $20 (valores inteiros até $500) |
| Requisições falhas ou recusadas | Não cobrado |
| Validade | Nunca |
| 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:
| Recarga | Bônus | Crédito recebido |
|---|---|---|
| $20 | nenhum | $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.
- 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.
- 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.
- 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_tokenscomo um teto. - 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.
- 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.
- 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.
