Pular para conteúdo

Como criar uma chave de API da OpenAI

Passo a passo para gerar sua chave da OpenAI e usar a inteligência artificial na sua loja online.

Para usar a IA da FitVitrine com a OpenAI (geração e edição de imagens e escrita do conteúdo do produto), você precisa de uma chave da OpenAI. O custo das operações fica na sua conta da OpenAI; a FitVitrine só faz o pedido em seu nome e não cobra nada a mais por isso.

Passo 1: Criar conta na OpenAI

  1. Acesse platform.openai.com.
  2. Crie uma conta usando seu e-mail ou login Google/Microsoft.
  3. Confirme o e-mail cadastrado.

Passo 2: Verificar a organização

A OpenAI exige uma verificação extra da organização para liberar o modelo de imagem mais novo (gpt-image-2). Sem isso, a geração de imagem falha.

  1. Nas configurações da organização, na OpenAI, procure a opção de verificação (Verify Organization).
  2. Siga o fluxo pedido e aguarde a confirmação, que pode levar de minutos a horas.

Passo 3: Cadastrar forma de pagamento

  1. Na área de cobrança (Billing) da OpenAI, cadastre um cartão.
  2. Configure um limite mensal de gastos (Usage Limits). Comece por um valor baixo e vá ajustando conforme o uso.

Passo 4: Gerar a chave

  1. Acesse platform.openai.com/api-keys.
  2. Clique em Create new secret key.
  3. Dê um nome que ajude você a reconhecer depois, por exemplo "FitVitrine".
  4. Copie o valor (ele começa com sk-). A OpenAI mostra esse valor uma única vez.

Passo 5: Cadastrar na FitVitrine

  1. No painel, abra Configurações e vá na aba Integrações.
  2. No bloco Integrações com IA, abra o card OpenAI.
  3. Cole a chave no campo API Key e clique em Salvar e validar.
  4. Se a chave estiver certa, o card passa a mostrar o selo de conectado e um resumo da chave (só os primeiros e últimos caracteres).

Depois de salvar, aparece também o seletor Modelo de texto, onde você escolhe qual modelo da OpenAI escreve as descrições. A troca é salva na hora.

Aviso

A aba Integrações mostra o bloco de chaves de IA apenas para o administrador principal da loja.

Quanto custa

Cada geração é cobrada pela OpenAI, não pela FitVitrine. Gerar imagem custa bem mais que gerar texto, e a qualidade e o tamanho escolhidos no gerador mudam o valor. Os preços atuais ficam em openai.com/api/pricing, e o que você já gastou aparece em platform.openai.com/usage.

Dentro da FitVitrine, o gasto estimado do mês aparece em Uso e custo estimado de IA.

Em caso de erro

  • Chave inválida: confira se copiou o valor inteiro. Se ainda falhar, gere uma nova chave na OpenAI.
  • Organização precisa de verificação: volte ao passo 2 e conclua a verificação.
  • Cota ou limite excedido: aumente o limite mensal na área de cobrança da OpenAI, ou espere a virada do mês.

Para usar o Google Gemini em vez da OpenAI, veja Como criar minha API Key do Google Gemini. Para entender como a chave é guardada, veja Como protegemos sua API Key.