Como obter um Chave API OpenAI (passo a passo e perguntas frequentes)

A API da OpenAI oferece aos programadores uma porta de entrada para inteligência artificial de ponta, permitindo a integração de IA numa vasta gama de aplicações. Quer esteja a desenvolver chatbots, a aprimorar a análise de dados ou a criar novas ferramentas impulsionadas por IA, obter uma chave API da OpenAI é um passo inicial crucial. Este guia abrangente irá orientá-lo ao longo do processo de obtenção de uma chave API da OpenAI, explicar como funciona a respetiva faturação e responder às perguntas mais frequentes.

Vídeo: Como obter a sua chave API da OpenAI?

Como obter um Chave API OpenAI

Para obter um Chave API OpenAI, siga os passos abaixo:

Passo 1: Criar uma conta OpenAI

Se pretende obter uma chave OpenAI, comece por criar uma conta OpenAI — este passo irá guiá-lo nesse processo. Caso já tenha uma conta OpenAI, avance diretamente para o passo 2.

1. Navegue até ao site da OpenAI. Depois, verá o botão «Iniciar sessão» no canto superior direito do site — clique nele.

   

2. Depois, na nova página aberta, clique em «Inscrever-se» e siga as instruções do site para concluir o registo.

   

3. Assim que concluir o registo, a OpenAI enviar-lhe-á um e-mail de confirmação. Para verificar a sua conta, abra esse e-mail e clique na ligação de verificação incluída. Concluir este passo é essencial para proteger a sua conta.

   

4. Com a sua conta agora verificada, regresse ao site da OpenAI e selecione a opção «Iniciar sessão». Utilize o nome de utilizador e a palavra-passe que definiu no registo para aceder à sua conta.

   

Passo 2: Criar um novo Chave de API

1. Após iniciar sessão na sua conta OpenAI, navegue até ao lado esquerdo da página web e clique na secção “Chave de API”, identificada pelo ícone de um cadeado.

   

2. Agora, na secção Chave de API, clique no botão «Criar nova Chave Secreta» para gerar uma nova chave de API.

   

3. É apresentada uma caixa de diálogo para atribuir um nome a esta Chave de API secreta; introduza um nome específico e clique no botão Criar Chave Secreta.

   Dica: Se pretender utilizar múltiplas chaves de API secretas para diferentes aplicações ou organizações, atribua a cada uma um nome descritivo. Esta prática permite distinguir rapidamente as chaves quando precisar de utilizar uma específica.

   

4. Ao clicar no botão **“Criar Chave Secreta”**, será gerada a sua nova chave de API secreta. Certifique-se de usar o botão **“Copiar”** para copiá-la e colá-la imediatamente na aplicação pretendida — pois esta chave deixará de ser visível assim que fechar esta caixa de diálogo.
   Nota importante: Guarde esta chave num local seguro, pois, por motivos de segurança, não será possível recuperá-la posteriormente. Esta chave é essencial para autenticar as suas aplicações nos serviços da OpenAI.
   

5. Clique em «Concluído» para fechar a caixa. Agora, poderá ver que a Chave de API foi gerada e está visível na secção Chave de API.

   

Compreender a faturação do Chave API OpenAI

Além de saber como gerar uma chave API da OpenAI, é essencial compreender os custos associados. Esta secção do tutorial explica a estrutura de preços e orienta-o na configuração da faturação e dos limites de utilização da sua chave API. Continue a ler para obter informações mais detalhadas.

A chave API da OpenAI é gratuita?

Criar uma chave API OpenAI é inicialmente gratuito. Aos novos utilizadores em período experimental são atribuídos 5 USD em créditos, válidos durante três meses. Após esgotar estes créditos ou findo o prazo, terá de fornecer dados de faturação para manter o acesso à API escolhida. Note que, sem informações de cobrança, a sua sessão permanecerá ativa, mas não poderá efetuar pedidos adicionais à API.

Estrutura de custos do Chave API OpenAI

A OpenAI disponibiliza diversos modelos, cada um com capacidades únicas e custos associados, calculados por 1.000 tokens. Os tokens podem ser vistos como fragmentos de palavras — aproximadamente, 1.000 tokens correspondem a cerca de 750 palavras. Para ter uma ideia, este parágrafo contém 45 tokens.

Se procura informações detalhadas sobre os custos de modelos específicos de IA, como GPT-4 ou gpt-3,5-turbo, utilizados no ChatGPT, recomendamos que visite a página de preços dos modelos de IA da OpenAI. Lá encontrará todos os detalhes e opções de preços específicos dos modelos que lhe interessam.

Esta estrutura de preços permite aos utilizadores escolher o plano que melhor se ajusta às suas necessidades e orçamento, assegurando uma abordagem flexível e escalável para tirar partido das capacidades avançadas de IA da OpenAI.

É importante destacar que as cobranças são calculadas com base na utilização mensal.

Para saber quantos tokens utilizou, aceda ao painel esquerdo do site e clique no botão «Utilização»; na secção Utilização, pode consultar os custos diários e a fatura mensal.

Configuração de faturação e métodos de pagamento

A OpenAI cobra pela utilização da sua API com base no consumo, pelo que, se ainda não configurou um método de pagamento para faturação, terá de o fazer. Caso contrário, a sua Chave de API deixará de funcionar assim que esgotar o crédito gratuito ou findar o prazo.

Para configurar a faturação, siga os passos abaixo:

Passo 1: Aceder à secção Faturação

Clique no botão «Definições» no menu esquerdo e, de seguida, em «Faturação» para aceder à secção «Definições de Faturação».

Passo 2: Adicionar o seu método de pagamento

1. Na secção Definições de Faturação, se ainda não tiver adicionado um método de pagamento para utilizar a API, clique no botão «Adicionar detalhes de pagamento».

   

2. Depois, selecione «Individual» ou «Empresa», conforme necessário, adicione o seu cartão de crédito e preencha os respetivos detalhes.

   

Para adicionar um novo método de pagamento ou atualizar um existente, aceda à secção «Definições de Faturação» e clique no botão «Métodos de Pagamento». Depois, siga as instruções indicadas no site para concluir a adição ou atualização dos seus dados de pagamento.

Gestão dos limites de utilização

Se receia incorrer acidentalmente em despesas mensais significativas com a sua Chave de API, pode definir limites de utilização. Esta funcionalidade permite-lhe controlar os seus gastos ao estabelecer um limite máximo para a utilização mensal da API, evitando encargos elevados e inesperados.

1. Clique no botão «Definições» no menu esquerdo e, de seguida, em «Limites».

   

2. Desloque-se até à secção «Limites de utilização», defina um orçamento mensal e um limiar para envio de notificação por e-mail caso seja excedido e, em seguida, clique no botão «Guardar».

   

Compreensão dos Limites de Taxa na API OpenAI

Os limites de taxa na API da OpenAI referem-se ao número máximo de vezes que um utilizador ou cliente pode aceder aos serviços num determinado período. Essenciais para evitar a sobrecarga dos recursos, esses limites asseguram a estabilidade e disponibilidade da API para todos os utilizadores.

Implementação a nível organizacional:

Ao contrário de alguns sistemas em que os limites de taxa se aplicam ao nível individual do utilizador, a OpenAI implementa essas restrições a nível organizacional. Essa abordagem significa que os limites são partilhados entre todos os utilizadores da mesma organização, tornando essencial que as organizações geram estrategicamente a sua utilização da API.

Variabilidade entre modelos:

É importante notar que os limites de taxa podem variar conforme o modelo utilizado na API da OpenAI, já que diferentes modelos apresentam limiares distintos de acesso, refletindo os seus requisitos computacionais e complexidade.

Limites de despesa mensal:

Além dos limites de taxa, as organizações estão sujeitas a limites máximos de despesa mensal com a API. Estes, frequentemente designados por “limites de utilização”, têm como objetivo prevenir encargos elevados e inesperados, promovendo uma utilização responsável dos serviços da OpenAI.

Para quem pretende aprofundar os detalhes dos limites de taxa — incluindo os valores exatos e o respetivo impacto na utilização —, a OpenAI disponibiliza informações detalhadas no seu site oficial. Este recurso é inestimável para organizações que estão a planear a sua estratégia e orçamento relativos à API.

Perguntas Frequentes sobre Chave API OpenAI

Onde posso encontrar a minha Chave de API?

Inicie sessão na sua conta OpenAI, clique no botão «Chave de API» no painel esquerdo para aceder à secção respetiva e aí encontrará a sua chave de API.

Posso partilhar a minha Chave de API com outras pessoas?

Não é recomendado partilhar, pois a chave está associada à sua conta e ao seu uso.

Como corrigir o erro «Chave de API Incorreto Fornecido»

Para resolver o erro “Chave de API Incorreto Fornecido”, siga estes passos:

Verifique o Chave de API:

Verifique novamente a chave de API introduzida. Certifique-se de que não há erros ortográficos nem espaços extra. Copie e cole diretamente da fonte para evitar erros.

Verifique o estado do Chave de API:

Certifique-se de que a Chave de API está ativa e não foi recriada, eliminada nem armazenada em cache.

Utilização correta do Chave de API:

Certifique-se de que não está a utilizar a chave de API de outra organização ou projeto de IA.

Se já tentou todos os passos acima e continuar a encontrar o erro, contacte a equipa de apoio da OpenAI para obter assistência.

Lembre-se de que manter a sua Chave de API segura e garantir a sua correta implementação é essencial para o bom funcionamento das suas aplicações com os serviços da OpenAI.