Obter uma chave da OpenAI, passo a passo
- Inicie sessão na OpenAI Platform em platform.openai.com, o site da OpenAI para programadores. A subscrição do ChatGPT não se aplica a esta plataforma.
- Abra a página de chaves de API de um projeto: Definições → Chaves de API. Cada projeto tem as suas próprias chaves, pelo que uma chave criada num projeto só dá acesso a esse projeto.
- Clique em Criar nova chave secreta. Dê-lhe um nome, escolha se pertence a si ou a uma conta de serviço (mais adequada para servidores e CI) e selecione as permissões: Todas, a opção predefinida, Restritas aos âmbitos que escolher, ou Só de leitura.
- Copie-a agora. A OpenAI só mostra a chave completa no momento da criação. Guarde-a num gestor de palavras-passe ou de segredos; se a perder, crie outra.
- Adicione crédito. As novas contas da API são pré-pagas: na página de faturação, compre crédito a partir de $5 (o valor predefinido é $10). O carregamento automático está ativo por predefinição durante a configuração, o crédito comprado expira ao fim de um ano e não é reembolsável.
Testar a chave
Os SDKs da OpenAI leem a chave a partir de OPENAI_API_KEY. Um pedido à Responses API:
export OPENAI_API_KEY="your-key"curl https://api.openai.com/v1/responses \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6-astra", "input": "Say hello"}'No Windows, defina a variável com setx OPENAI_API_KEY "your-key" e abra um novo terminal.
Quanto custa uma chave da API OpenAI
A chave é gratuita; cada pedido é cobrado por token. Preços de tabela por 1M tokens:
| Modelo | Entrada | Saída | Na Zurelay (entrada / saída) |
|---|---|---|---|
| GPT-6 Astra | $10.00 | $50.00 | $2.50 / $12.50 |
| GPT-6.1 Sol | $2.00 | $10.00 | $0.50 / $2.50 |
| GPT-6.1 Terra | $1.00 | $5.00 | $0.25 / $1.25 |
| GPT-6 Luna | $0.10 | $0.50 | $0.025 / $0.125 |
O montante que pode gastar depende do seu nível de utilização, definido pelo total que já pagou:
| Escalão | Requisitos | Limite mensal de utilização |
|---|---|---|
| Grátis | Residir num país suportado | $100 |
| Desenvolver | $5 de crédito comprado | $500 |
| Launch | $100 em compras | $5,000 |
| Grow | $500 em compras | $200,000 |
Estes níveis substituíram os níveis 1 a 5 em 2026. Os limites de pedidos por modelo aumentam a cada nível.
O ChatGPT Plus inclui acesso à API?
Não. A OpenAI fatura a utilização da API separadamente do ChatGPT, pelo que os planos Plus e Pro não incluem crédito para a API nem uma chave.
O Codex, o agente de programação da OpenAI, funciona das duas formas: inicie sessão com o ChatGPT para usar o seu plano, ou com uma chave de API para pagar por token. O Codex na nuvem exige que inicie sessão com o ChatGPT.
Existe uma chave gratuita da API OpenAI?
As contas começam no nível Free, e o guia de início rápido da OpenAI apresenta o primeiro pedido como um pedido de teste gratuito, mas a utilização real exige crédito. Evite sites que distribuem chaves partilhadas: acabam por ser revogadas e qualquer outra pessoa que use a chave pode ver o tráfego.
Mantenha a chave segura
- Guarde-a no servidor. Uma chave no código de front-end, numa aplicação móvel ou num repositório público fica visível para qualquer pessoa.
- Atribua a cada aplicação um projeto e uma chave próprios, com permissões restritas se só precisar de alguns endpoints.
- Use uma chave de conta de serviço para servidores, em vez de uma chave pessoal.
- Se uma chave for exposta, elimine-a na página de chaves de API e crie uma nova.
Outra opção: uma chave para GPT, Claude e os restantes modelos
Uma chave Zurelay funciona com os SDKs da OpenAI através de Chat Completions e custa menos por token (75% abaixo do preço de tabela da OpenAI para o GPT-6.1 Terra). O crédito começa nos $10, e a mesma chave dá acesso a Claude, Gemini e DeepSeek. Altere o URL base e a chave:
from openai import OpenAIclient = OpenAI( base_url="https://api.zurelay.com/v1", api_key="YOUR_ZURELAY_KEY",)reply = client.chat.completions.create( model="gpt-6.1-terra", messages=[{"role": "user", "content": "Say hello"}],)print(reply.choices[0].message.content)A Zurelay disponibiliza Chat Completions, mas não as APIs Responses, Realtime, embeddings, fine-tuning ou Batch; se usa essas APIs, mantenha uma chave OpenAI. A página Alternativa à API da OpenAI compara as duas opções.
Os passos, a faturação e os níveis baseiam-se nas páginas faturação pré-paga, projects, limites de pedidos e faturação do ChatGPT e da API da OpenAI, consultadas em 28 de outubro de 2026.