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).

platform.openai.com · sk-… · GPT

Em resumo

  1. 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).
  2. 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.
  3. 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.
  4. 04A OpenAI mostra uma chave secreta nova só uma vez, então cole-a logo no Chaterimo, em Configurações da Conta.
  5. 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
  1. Passo a passo
  2. Como verificar se funciona
  3. Solução de problemas
  4. Próximo passo
  5. Perguntas frequentes

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

  1. 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.
  2. 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.
  3. 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.


  1. 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 ↑

  2. 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 ↑

  3. OpenAI, “Spend limits”, acesso em 19 de outubro de 2026, https://developers.openai.com/api/docs/guides/spend-limits ↑

  4. OpenAI, “Assign API key permissions”, acesso em 19 de outubro de 2026, https://help.openai.com/en/articles/8867743-assign-api-key-permissions ↑

TemasIntegrações e APIModelos LLM no atendimento ao cliente

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

  1. Reescrito conforme a versão atual da OpenAI Platform e das configurações do Chaterimo, com solução de problemas.
  2. Publicado.

Copyright © Chaterimo

about-icon