Crie sua chave da API da OpenAI e entenda o custo.

O que é uma chave de API e por que ela é secreta

Uma chave de API é uma credencial de texto que substitui login e senha em comunicação entre programas. Quando seu código envia uma requisição para a OpenAI, ele coloca a chave em um cabeçalho HTTP. O servidor lê a chave, reconhece a conta e cobra o consumo dessa conta.

O ponto importante é que a chave sozinha basta. Não existe segundo fator, confirmação por e-mail nem aprovação manual na hora da chamada. Quem tiver a chave em mãos consegue gastar o seu saldo, de qualquer computador do mundo, até você revogá-la.

Por isso a chave é tratada como senha de produção, não como configuração comum. Guardar em arquivo de código, colar em chat, mandar por e-mail ou exibir em print são formas de perder o controle sobre ela.

• A chave vai no cabeçalho Authorization, no formato Bearer.
• Quem tem a chave gasta o seu crédito, sem passar por mais nenhuma verificação.
• Uma chave revogada para de funcionar na hora, então revogar é a primeira reação a qualquer suspeita de vazamento.

Passo a passo para criar a chave na plataforma da OpenAI

A criação acontece em platform.openai.com, que é a área de desenvolvedores da OpenAI. É um site separado do chatgpt.com, mesmo que o login seja o mesmo. Muita gente procura a chave dentro do ChatGPT e não encontra por isso.

O fluxo tem poucas etapas, mas uma delas não tem volta: a chave completa aparece uma única vez, no momento em que é criada. Depois disso a plataforma mostra apenas os últimos caracteres, para você identificar qual chave é qual.

Antes de a chave funcionar de verdade, a conta precisa ter crédito. A criação da chave é gratuita; a chamada é que consome saldo.

• Acesse platform.openai.com e entre com sua conta OpenAI, ou crie uma. Pode ser pedida confirmação de e-mail e de telefone.
• Abra as configurações da conta e vá até a seção de API keys.
• Crie uma nova secret key e dê um nome que identifique o projeto e o ambiente, por exemplo app-producao ou teste-local.
• Se sua conta usa projetos, escolha em qual projeto a chave será criada — o consumo fica separado por projeto.
• Copie a chave imediatamente e cole em um gerenciador de senhas ou no cofre de segredos do seu projeto. Ela não reaparece.
• Na área de billing, adicione um meio de pagamento e compre créditos. Sem saldo, a chave existe mas as chamadas são recusadas.
• Se você perder a chave, não há recuperação: crie outra e revogue a anterior.

Como testar a chave da OpenAI com uma chamada

O caminho mais curto é o terminal, com curl. Primeiro exporte a chave como variável de ambiente da sessão, para ela não ficar escrita no comando e no histórico. Depois faça duas chamadas: uma que apenas confirma que a credencial é válida e outra que realmente conversa com um modelo.

A primeira chamada lista os modelos que a sua conta pode usar. Ela é útil por dois motivos: valida a chave e mostra os identificadores exatos que você pode colocar no campo model. Use um id dessa lista na segunda chamada, em vez de chutar um nome de modelo.

Se a resposta vier com erro 401, a chave está errada, incompleta ou já foi revogada. Se a mensagem falar em cota ou saldo insuficiente, a chave está certa e o que falta é crédito na conta.

export OPENAI_API_KEY="sk-cole-sua-chave-aqui"

# 1. a chave é válida? lista os modelos liberados na sua conta
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# 2. uma conversa de verdade, com um id que apareceu na lista acima
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "COLE_AQUI_UM_ID_DA_LISTA",
    "messages": [{"role":"user","content":"Responda apenas: chave funcionando"}]
  }'

Onde guardar a chave e o que nunca fazer com ela

Variável de ambiente é o padrão porque separa o segredo do código. O programa lê a chave do ambiente em que está rodando; o repositório guarda só o nome da variável. Em desenvolvimento, isso costuma virar um arquivo .env local, que precisa estar no .gitignore. Em produção, a chave vai no gerenciador de segredos do seu servidor ou da sua hospedagem.

Nunca envie a chave para o front-end. Qualquer código que roda no navegador — JavaScript de página, aplicativo distribuído, extensão — é legível por quem usa. A chave fica exposta mesmo que esteja em uma variável ou minificada. A chamada precisa sair do seu backend, e o front-end conversa com o seu backend.

Commitar a chave tem o mesmo peso. Apagar em um commit seguinte não resolve, porque o histórico do Git continua com o valor. Se aconteceu, considere a chave comprometida: revogue, crie outra e siga.

• Nunca escreva a chave direto no código, nem em comentário.
• Nunca envie a chave para o navegador, aplicativo distribuído ou automação compartilhada.
• Nunca cole a chave em print, log, issue, ticket ou grupo de mensagem.
• Use uma chave por projeto e outra por ambiente, para revogar uma sem derrubar todas.
• Revise o .gitignore antes do primeiro commit de qualquer projeto novo.

# .env do projeto — e o .env precisa estar no .gitignore
OPENAI_API_KEY=sk-cole-sua-chave-aqui

# ou, apenas para a sessão atual do terminal
export OPENAI_API_KEY="sk-cole-sua-chave-aqui"

# no código, leia sempre do ambiente
# Python: os.environ["OPENAI_API_KEY"]
# Node:   process.env.OPENAI_API_KEY

Como funciona a cobrança da API da OpenAI

A API da OpenAI é pré-paga em dólar. Você adiciona créditos com cartão e cada chamada desconta do saldo conforme o uso. O preço é por token e varia por modelo, com valores diferentes para o texto que entra e para o texto que sai. Modelos de raciocínio consomem mais tokens de saída do que aparenta a resposta visível. Os valores atuais ficam na página de preços da própria OpenAI, e mudam com o tempo — confira lá antes de estimar orçamento.

Quando o saldo acaba, as chamadas param com erro de cota. Existe recarga automática, que dispara uma nova compra quando o crédito cai abaixo de um limite, e existe limite de gasto por período. Configure os dois no começo: um protege a aplicação de parar, o outro protege a sua fatura.

Para quem paga do Brasil, três coisas mudam. O cartão precisa ser habilitado para compras internacionais. O valor em dólar é convertido pelo emissor do cartão no câmbio do dia, então o custo em Real de uma mesma recarga varia de mês para mês. E incide IOF de compra internacional, que aparece na fatura junto com a conversão.

Há ainda a diferença fiscal: o comprovante é emitido no exterior, em nome de uma empresa estrangeira. Não é NFS-e. Para pessoa física isso é indiferente; para empresa que precisa lançar a despesa, apropriar crédito ou prestar contas, o documento de fora costuma dar trabalho ao contador. Confirme com o seu antes de escalar o gasto.

O que fazer quando a chave não funciona

Quase todo problema aqui está escrito no próprio texto do erro. Leia a mensagem inteira antes de criar uma chave nova: na maioria das vezes o problema não é a chave.

Um detalhe que engana bastante: espaço em branco ou quebra de linha copiada junto com a chave. Isso produz um erro de autenticação idêntico ao de uma chave errada. Cole a chave em um editor simples e confirme que ela está em uma linha só, sem espaço no fim.

• Erro 401: chave incorreta, incompleta, revogada ou de outra conta. Confira também espaços extras.
• Erro sobre cota ou saldo: a chave está certa, falta crédito ou o limite de gasto foi atingido.
• Erro sobre modelo não encontrado: o id não existe ou não está liberado para sua conta. Compare com a lista retornada pelo endpoint de modelos.
• Erro 429 sem menção a saldo: você passou do limite de requisições por minuto. Reduza a frequência e tente de novo com intervalo.
• Erro 400: o corpo JSON está malformado ou falta um campo obrigatório. Valide o JSON antes de investigar a chave.

A alternativa: mesmo formato de API, com pagamento em Real

Se o que incomoda no caminho acima não é a parte técnica, mas a parte financeira — dólar, cartão internacional, IOF, câmbio variável e recibo estrangeiro —, existe a opção de acessar modelos por um gateway brasileiro. A Roteia é uma API compatível com o formato da OpenAI: mesma estrutura de chamada, mesmo formato de resposta, e o saldo é pré-pago em Real, com recarga por Pix, boleto ou cartão conforme a disponibilidade no painel. NFS-e é emitida mediante solicitação, e o suporte é em português.

Na prática, o que muda no seu código é a URL base, a chave e o identificador do modelo. Quem já usa o SDK da OpenAI aponta base_url para https://api.roteia.ai/v1 e segue com o mesmo cliente. O passo a passo está em /docs/primeira-chamada/.

Sendo direto sobre os limites: a Roteia é independente e não pertence nem representa OpenAI, Anthropic, Google, DeepSeek ou OpenRouter. Quais modelos estão disponíveis e por qual preço em Real é o que estiver publicado em /modelos/ e /precos/ — não presuma que um modelo está liberado só porque ele existe no laboratório de origem. Se a sua aplicação depende de um recurso específico da OpenAI, confirme no catálogo antes de mover qualquer coisa.

Vale dizer o óbvio: se você só usa modelos da OpenAI, tem cartão internacional e o comprovante de fora não é problema para a sua contabilidade, ir direto na fonte é razoável. A alternativa existe para quem tem atrito com essa parte, não para todo mundo. Você pode criar uma conta em https://app.roteia.ai, fazer uma chamada de teste e comparar o custo registrado com o que paga hoje.