Como pagar a API do Claude com Pix — passo a passo, sem cartão internacional

Para quem programa no Brasil, o obstáculo para usar a API do Claude, do GPT ou do Gemini quase nunca é o código — é o pagamento. O caminho direto cobra em dólar e pede cartão de crédito internacional habilitado para compras no exterior, coisa que nem todo mundo tem e que nem todo cartão corporativo libera. Este guia percorre a alternativa, do cadastro à primeira resposta do modelo: pagar com Pix, em reais, sem cartão.

O que você precisa antes de começar

Três coisas, e nenhuma delas é um cartão: um e-mail, o app do seu banco e $10 — a recarga mínima, convertida em reais na hora do pagamento. A carteira é pré-paga: não há assinatura, não há mensalidade e o saldo não expira. Se você só quer testar um modelo antes de decidir, esses $10 rendem bastante — a Claude Haiku 4.5 custa $0.40 por 1M de tokens de entrada, então uma rodada de testes de verdade consome centavos.

Passo a passo

1. Crie a conta

Cadastre-se com e-mail ou com a conta Google. Não é pedido cartão no cadastro, e você chega ao painel sem ter pago nada.

2. Abra a página de recarga e escolha o valor

No painel, vá em Billing e escolha uma faixa de recarga. O valor é definido em dólar porque as tarifas por token são em dólar — a conversão para reais acontece no passo seguinte, e você vê o número antes de confirmar qualquer coisa.

3. No checkout do Stripe, escolha Pix

O botão leva ao checkout hospedado pelo Stripe. Para quem está pagando do Brasil, o Pix aparece na lista de formas de pagamento junto com cartão e Link — e, no Safari ou no iPhone, também o Apple Pay. O valor é exibido em reais, já convertido, antes de você confirmar. É esse número que vai sair da sua conta; não há surpresa depois, nem fatura em dólar para conferir no fim do mês.

4. Pague no app do banco

O Stripe gera um QR code e um código copia e cola. Abra o app do banco, use a opção Pix, aponte a câmera ou cole o código, confira o valor e confirme. Se estiver pagando pelo celular, copiar o código costuma ser mais rápido que fotografar a própria tela.

5. O saldo entra na hora

A compensação do Pix é imediata: o Stripe confirma o pagamento, um webhook credita a carteira e o novo saldo aparece em Billing em segundos. Se demorar mais do que isso, atualize a página antes de pagar de novo — a recarga é registrada uma única vez, então um segundo Pix vira saldo extra, não correção.

6. Crie a chave e faça a primeira chamada

Com saldo, gere uma chave em /app/keys. Ela começa com sk-kn- e aparece uma única vez — copie antes de fechar. Depois é um curl:

# Depois que o saldo entrar, a primeira chamada é esta.
curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Responda em uma linha: deu certo?"}]
  }'

Se você já tem código escrito para a OpenAI, a migração é uma linha: a API é compatível com o formato OpenAI, então o mesmo SDK funciona trocando a base_url.

# O mesmo SDK da OpenAI, apontando para outra base_url.
from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",                    # crie em kunavo.com/app/keys
    base_url="https://api.kunavo.com/v1",   # a única linha que muda
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Olá!"}],
)
print(resp.choices[0].message.content)

Quanto sai em reais, na prática

As tarifas por token são definidas em dólar e o Stripe converte no momento do pagamento — a cotação usada é a que está na tela do checkout, e ela já inclui o spread da conversão. A diferença relevante em relação ao cartão está nos impostos: transações em cartão de crédito internacional sofrem IOF de 3,5% (confira a alíquota vigente) mais a tarifa de transação internacional que o emissor cobrar. O Pix não tem IOF, porque é uma transação doméstica em reais. Na mesma recarga, é a rota mais barata partindo do Brasil.

Para dimensionar o consumo: a Claude Sonnet 4.6 sai a $1.20 por 1M de tokens de entrada e $6.00 por 1M de saída. Uma recarga de $10 cobre bem mais do que a maioria dos projetos gasta enquanto ainda está em desenvolvimento. Os valores por modelo estão todos no guia de preço da API do Claude e na tabela de preços.

Se o Pix não aparecer

O Pix é oferecido a quem está pagando do Brasil, e o Stripe determina isso quando a página de pagamento carrega. Duas causas cobrem quase todos os casos:

• VPN ou proxy apontando para fora do país. Desligue e abra o checkout de novo — é a explicação mais comum.
• Você abriu o link em outro dispositivo ou rede. Refaça o caminho a partir de Billing na conexão de onde vai pagar.

Em qualquer país, cartão (Visa, Mastercard, American Express), Apple Pay e Link continuam disponíveis como alternativa — o Pix é o caminho mais confortável para quem paga do Brasil, não o único.

Recibo, nota fiscal e reembolso

Todo pagamento gera um recibo do Stripe por e-mail, e o histórico de recargas fica em Billing. Para empresas que precisam de nota fiscal em BRL emitida no Brasil, a observação está no guia da API do Claude no Brasil, junto com o que muda em LGPD e latência de São Paulo. Reembolso de saldo não usado segue a política de billing.

Perguntas frequentes