Guia · Chave de API da OpenAI
Como obter uma chave de API da OpenAI para o Chaterimo
Crie uma conta na OpenAI Platform, adicione créditos pré-pagos, crie uma chave secreta de API e conecte-a ao Chaterimo como sua chave própria (BYOK).
Em resumo
- 01Uma chave de API da OpenAI permite que o seu chatbot do Chaterimo responda com modelos GPT, e a OpenAI cobra diretamente de você o que o chatbot usa (BYOK).
- 02Você cria a chave na OpenAI Platform (platform.openai.com), não no ChatGPT; uma assinatura do ChatGPT não inclui o uso da API.
- 03A OpenAI cobra a API com créditos pré-pagos: quando o saldo chega a zero, o chatbot para de responder até você adicionar créditos.
- 04A OpenAI mostra uma chave secreta nova só uma vez, então cole-a logo no Chaterimo, em Configurações da Conta.
- 05O Chaterimo verifica quais modelos GPT a sua chave pode usar e marca os outros como não disponíveis.
O que você precisa
- Um plano do Chaterimo que usa a sua chave de API própria (BYOK). O teste grátis e os planos com chaves de API do Chaterimo não precisam de chave.
- Um endereço de e-mail, ou uma conta Google, Microsoft ou Apple, para se cadastrar na OpenAI.
- Um cartão de pagamento para os créditos pré-pagos da OpenAI.
Conteúdo 5
Para obter uma chave de API da OpenAI, cadastre-se na OpenAI Platform (platform.openai.com), adicione créditos pré-pagos e crie uma chave secreta na página API keys. Depois, cole a chave no Chaterimo em Configurações da Conta e escolha um modelo GPT para o seu chatbot. Este guia é para lojas virtuais cujo plano do Chaterimo usa uma chave de API própria (BYOK: você usa a sua própria chave e paga diretamente à OpenAI pelo que o chatbot usa).
Passo a passo
1Crie uma conta na OpenAI Platform
Acesse platform.openai.com e selecione Sign up (cadastrar-se) ou, se você já tem uma conta da OpenAI, Log in (entrar). Você pode se cadastrar com um endereço de e-mail ou com uma conta Google, Microsoft ou Apple. Entre sempre com o mesmo método que usou no cadastro.
A OpenAI Platform não é o ChatGPT. O ChatGPT (chatgpt.com) é o aplicativo de chat da OpenAI; a Platform é onde ficam as chaves de API e a cobrança da API. Uma assinatura do ChatGPT Plus não inclui o uso da API, e a OpenAI cobra os dois separadamente.1
2Adicione créditos pré-pagos
A OpenAI cobra o uso da API antecipadamente. Abra a página Billing da OpenAI Platform, adicione um cartão de pagamento e compre créditos. Quando o saldo chega a zero, a OpenAI interrompe as solicitações à API e o seu chatbot não consegue responder até você adicionar créditos. A recarga automática completa o saldo quando ele fica abaixo de um valor que você escolhe; deixe-a ativada para que o chatbot não pare à noite ou no fim de semana.2
Dica
Para limitar o gasto mensal, abra a página Limits e selecione Edit spend limit em Spend. Um alerta de gastos só envia um e-mail para você. Um limite de gastos fixo (Enforce a hard limit) interrompe as solicitações à API quando é atingido, e então o seu chatbot também para de responder.3
3Crie a chave de API da OpenAI
Abra a página API keys e selecione Create new secret key. Preencha a caixa de diálogo:
- Name
- Um nome que você vai reconhecer depois, por exemplo “Chaterimo”.
- Project
- O projeto ao qual os custos pertencem. O projeto padrão funciona; um projeto separado mostra os custos do chatbot à parte.
- Permissions
- Mantenha All, o padrão. Uma chave restrita pode bloquear solicitações de que o Chaterimo precisa, por exemplo a lista de modelos que ele verifica no passo 5.4
Selecione Create secret key e copie a chave. A OpenAI mostra a chave completa só uma vez. Se você a perder, crie uma chave nova.
Atenção
Trate a chave como uma senha. Nunca a envie por e-mail ou chat e nunca a coloque no código da sua loja. Qualquer pessoa que tenha a chave pode usar a API às suas custas. Se uma chave vazar, crie uma nova, cole-a no Chaterimo e depois exclua a antiga na página API keys.
4Cole a chave no Chaterimo
No Chaterimo, abra Configurações da Conta no menu. Na seção Chaves dos provedores de IA, cole a chave em Chave de API da OpenAI e selecione Salvar. O campo passa a mostrar Chave salva. O Chaterimo guarda a chave criptografada e a usa apenas para solicitações à OpenAI. Uma única chave atende a todos os chatbots da sua organização.
Se você não vê a seção Chaves dos provedores de IA, o seu plano não precisa de chave própria: no teste grátis e nos planos com chaves de API do Chaterimo, o Chaterimo usa as chaves dele. Os planos estão na página de preços.
5Escolha um modelo GPT para o seu chatbot
Abra Configurações do Chat & Incorporação. Em Configurações gerais do chatbot, escolha um modelo GPT em Tipo de modelo de IA e selecione Salvar alterações. O Chaterimo pergunta à OpenAI quais modelos a sua chave pode usar e marca os outros com “Não disponível para sua chave de API”. Alguns modelos exigem antes uma organização verificada na OpenAI (veja Solução de problemas).
O modelo certo para a sua loja depende das perguntas dos seus clientes e do seu orçamento. O nosso benchmark de IA compara modelos com perguntas reais de atendimento ao cliente.
Como verificar se funciona
- Abra Testar chatbot e faça uma pergunta que os seus clientes fazem com frequência. Se o chatbot responder, a chave e o modelo funcionam.
- Em Configurações do Chat & Incorporação, a nota “A disponibilidade dos modelos foi verificada com sua chave de API da OpenAI.” abaixo da lista de modelos significa que o Chaterimo conseguiu ler os modelos da sua chave.
- A página Usage da OpenAI Platform mostra as solicitações do seu chatbot.
Solução de problemas
- “Você ainda não salvou uma chave de API de um provedor de IA”
- O seu plano usa chave própria, mas o Chaterimo não tem nenhuma. Cole a chave em Configurações da Conta (passo 4).
- “A sua chave de API para OpenAI é inválida ou foi revogada”
- A chave foi excluída na OpenAI, copiada de forma incompleta ou pertence a uma organização que você não usa mais. Crie uma chave nova (passo 3) e cole-a no Chaterimo. O Chaterimo também envia esse aviso por e-mail ao proprietário da conta, no máximo uma vez por dia.
- “Seu provedor de IA (OpenAI) informa que os créditos da sua conta acabaram ou que um limite de gastos foi atingido”
- O saldo pré-pago chegou a zero ou um limite de gastos fixo foi atingido (o Chaterimo mostra o mesmo aviso nos dois casos). Adicione créditos em Billing (passo 2) e ative a recarga automática, ou aumente o limite em Limits.
- Um modelo GPT aparece com “Não disponível para sua chave de API”
- A OpenAI disponibiliza alguns modelos apenas para organizações verificadas. Verifique a sua organização nas configurações da organização na OpenAI Platform. O Chaterimo consulta os modelos de uma chave no máximo uma vez por hora, então o modelo pode continuar marcado por até uma hora.
- Você não encontra API keys nem Billing
- Provavelmente você está no ChatGPT (chatgpt.com) em vez da OpenAI Platform, ou em outra organização. Abra platform.openai.com, entre com o método que usou no cadastro e confira se a organização certa está selecionada.
Próximo passo
Compare os modelos que a sua chave pode usar no benchmark de IA e escolha o que combina com as perguntas dos seus clientes. Para experimentar também os modelos Claude ou Gemini, siga os guias da chave de API da Anthropic e da chave de API do Gemini. Depois, teste o chatbot com as suas próprias perguntas em Testar chatbot antes de exibi-lo na sua loja.
-
OpenAI, “Managing billing for ChatGPT and the API platform”, acesso em 19 de outubro de 2026, https://help.openai.com/en/articles/9039756-managing-billing-for-chatgpt-and-the-api-platform ↑
-
OpenAI, “Setting up and managing prepaid API billing”, acesso em 19 de outubro de 2026, https://help.openai.com/en/articles/8264644-setting-up-and-managing-prepaid-api-billing ↑
-
OpenAI, “Spend limits”, acesso em 19 de outubro de 2026, https://developers.openai.com/api/docs/guides/spend-limits ↑
-
OpenAI, “Assign API key permissions”, acesso em 19 de outubro de 2026, https://help.openai.com/en/articles/8867743-assign-api-key-permissions ↑
Perguntas frequentes
Uma chave de API da OpenAI é o mesmo que o ChatGPT Plus?
Não. O ChatGPT Plus é uma assinatura do aplicativo de chat da OpenAI. A chave de API vem da OpenAI Platform, e a OpenAI cobra o uso da API separadamente, com créditos pré-pagos.
Preciso adicionar créditos para usar a API da OpenAI?
Sim. A OpenAI cobra a API antecipadamente, com créditos pré-pagos. Sem créditos, as solicitações falham e o chatbot não consegue responder.
Posso usar uma única chave da OpenAI para vários chatbots no Chaterimo?
Sim. A chave fica salva em Configurações da Conta e atende a todos os chatbots da sua organização. Cada chatbot pode usar um modelo GPT diferente.
Quanto custa a API da OpenAI para um chatbot?
Depende do modelo e do número de conversas. A OpenAI publica os preços na página de preços da API da OpenAI. O plano do Chaterimo é cobrado separadamente; veja a página de preços do Chaterimo.
Histórico de alterações
- Reescrito conforme a versão atual da OpenAI Platform e das configurações do Chaterimo, com solução de problemas.
- Publicado.