Cadastre sua própria chave da Anthropic (Claude) ou OpenAI (ChatGPT) e use as funcionalidades de IA pagando direto no provedor.

API de IA 🔑

A OctoSolve funciona no modelo "traga sua chave" (BYOK, do inglês "bring your own key"). Você usa a sua própria conta no provedor de IA (Anthropic ou OpenAI) e cadastra a chave uma única vez em Configurações → API de IA. A partir daí, sempre que uma funcionalidade de IA roda, é a sua chave que é consumida, não a da OctoSolve.

Você cadastra a chave uma vez só. Depois disso, ela fica guardada de forma encriptada e é usada automaticamente toda vez que uma função de IA precisa rodar. Pode trocar ou remover a qualquer momento.

O que é "traga sua chave" (BYOK)

Em vez de a OctoSolve embutir um custo de IA na mensalidade, você conecta a sua própria conta no provedor. Isso te dá controle total: você vê o gasto direto no painel da Anthropic ou da OpenAI, define os seus limites e não fica preso a um pacote fixo de uso.

A mensalidade do seu plano OctoSolve continua sendo paga normalmente. O custo da IA é uma coisa separada, que cai direto na sua conta do provedor.

Quais provedores a OctoSolve aceita

São dois, e eles trabalham juntos:

Provedor	Papel	Onde criar a chave	Formato da chave
Anthropic (Claude)	Principal	console.anthropic.com → Settings → API Keys → Create Key	começa com `sk-ant-api03-...`
OpenAI (ChatGPT)	Reserva (fallback)	platform.openai.com → API keys → Create new secret key	começa com `sk-proj-...`

A Anthropic é a principal: é ela que roda o agente do dia a dia. A OpenAI é a reserva: se a chave da Anthropic falhar (por exemplo, acabou o saldo dela), o sistema migra sozinho pra OpenAI, desde que você tenha cadastrado as duas.

Pro agente de atendimento, só a Anthropic já faz tudo funcionar, e a OpenAI vira o plano B automático. Mas algumas funções do Criador de Posts (gerar a imagem e a legenda por IA) rodam na OpenAI: pra usar essas, você precisa ter a chave da OpenAI cadastrada. Veja o detalhe de cada função na seção "Quais funcionalidades usam a sua chave".

Passo 1: criar a chave no provedor

Escolha o provedor (recomendamos começar pela Anthropic) e crie uma chave de API:

Anthropic (Claude):

Acesse console.anthropic.com e faça login (ou crie a conta)
Vá em Settings → API Keys
Clique em Create Key, dê um nome (ex: "OctoSolve") e copie a chave gerada
A chave começa com sk-ant-api03-

OpenAI (ChatGPT), se quiser a reserva:

Acesse platform.openai.com e faça login
Vá em API keys
Clique em Create new secret key e copie a chave gerada
A chave começa com sk-proj-

Trate a chave como uma senha. Ela dá acesso à sua conta no provedor. Copie assim que gerar, porque alguns provedores só mostram a chave uma vez. Na OctoSolve ela fica guardada de forma encriptada, ninguém da equipe consegue ver em texto claro.

Passo 2: cadastrar na OctoSolve

No menu lateral, vá em Configurações → API de IA
Você vê dois cartões, um para cada provedor: Anthropic (Claude) e OpenAI (ChatGPT). Cada cartão mostra um status no topo: Não configurada, Conectada ou Inválida
No cartão do provedor que você quer usar, cole a chave no campo de texto (use o ícone de olho ao lado pra conferir se colou certo)
Clique em Testar. Em alguns segundos aparece "✓ Key válida e ativa" se estiver tudo certo, ou uma mensagem de erro se a chave estiver errada
Clique em Salvar

Pronto. O status do cartão muda para Conectada e mostra a data da validação. A partir daí a sua chave passa a ser usada nas funcionalidades de IA.

O botão Testar faz uma chamada mínima pra confirmar que a chave funciona, com custo praticamente zero (menos de um centavo). É só pra você ter certeza antes de salvar.

Quais funcionalidades usam a sua chave

As funcionalidades abaixo usam a sua chave sob demanda, ou seja, só quando elas realmente rodam. Sem uso, não há custo. Repare que cada função usa um provedor específico:

Funcionalidade	Provedor que usa	Chave necessária
Agente de atendimento (responde o WhatsApp)	Anthropic, com OpenAI de reserva	Anthropic (ou OpenAI)
Variações de resposta de comentário (Ímã de Comentário)	Anthropic, com OpenAI de reserva	Anthropic (ou OpenAI)
Imagem do post (Criador de Posts)	OpenAI	OpenAI
Descrição do post (legenda por IA)	OpenAI	OpenAI

Agente de atendimento: toda vez que o agente responde uma conversa no WhatsApp, ele usa a sua chave da Anthropic pra entender a mensagem e gerar a resposta. Se a Anthropic falhar e você tiver a OpenAI cadastrada, ele migra sozinho.
Variações de resposta de comentário (Ímã de Comentário): quando você pede frases alternativas a partir da sua primeira frase, a IA gera essas variações com a sua chave da Anthropic (ou da OpenAI, se só essa estiver cadastrada).
Imagem do post (Criador de Posts): quando você gera a imagem de um post, a imagem é criada com a sua chave da OpenAI. Sem a chave da OpenAI cadastrada, essa função não roda.
Descrição do post: a legenda sugerida por IA no Criador de Posts também roda com a sua chave da OpenAI.

Não tem nada pra ligar ou desligar nessas funcionalidades. Elas usam a sua chave automaticamente quando você as aciona. Novas funcionalidades de IA virão e também usarão a sua chave.

Quem paga pela geração

O custo da geração de IA cai direto na sua conta do provedor (Anthropic ou OpenAI). A OctoSolve não cobra pela geração em si: a plataforma só usa a sua chave pra fazer o trabalho acontecer. O que você paga pra OctoSolve é a mensalidade do plano, que é separada do custo de IA.

Como o plano B (fallback) funciona

Se você cadastrar as duas chaves (Anthropic e OpenAI), ganha um plano B automático:

O agente sempre tenta primeiro a Anthropic (principal)
Se a chave da Anthropic falhar (saldo zerado, chave revogada, instabilidade), o sistema migra sozinho pra OpenAI
Se as duas falharem, você vê um alerta na tela de API de IA. A OctoSolve nunca usa a chave dela no seu lugar

Por isso vale a pena cadastrar a OpenAI mesmo usando a Anthropic como principal: é a sua garantia de que o agente não para de atender se a chave principal tiver algum problema.

Como pôr um limite de gasto (recomendado)

Como a cobrança da IA é feita direto no provedor, vale a pena definir um teto mensal pra não ter surpresa na fatura. Os dois provedores deixam você configurar um limite:

Anthropic: no painel de billing, em Spend limit, você define o teto mensal de gasto.
OpenAI: no painel de billing, em Limits / Usage limits, você define o valor máximo que pode ser gasto no mês.

Comece com um teto baixo, entre R$50 e R$100 por mês, e vá subindo conforme acompanha o uso real. Assim você testa a plataforma com tranquilidade, sem risco de estourar a fatura.

Trocar ou remover a chave

Trocar: na tela de API de IA, cole a chave nova no campo (o texto sugere "Cole pra substituir a key atual"), clique em Testar e depois em Salvar. A nova substitui a antiga.
Remover: clique em Remover no canto do cartão e confirme. Atenção: se você remover a única chave cadastrada, o agente pode ficar offline (sem chave, ele não consegue gerar respostas).

Solução de problemas

"Key muito curta": você colou um texto com menos de 10 caracteres. Confira se copiou a chave inteira do provedor.

A chave aparece como "Inválida": a chave foi revogada no provedor, está com erro de digitação ou a conta está sem saldo. Gere uma chave nova no painel do provedor e cadastre de novo.

O agente parou de responder: confira na tela de API de IA se a chave principal (Anthropic) está Conectada. Se estiver Inválida, regenere e salve. Cadastrar a OpenAI como reserva evita que isso derrube o agente.

Quero ver quanto estou gastando: o gasto fica no painel do provedor, não na OctoSolve. Anthropic: console.anthropic.com → Usage / Billing. OpenAI: platform.openai.com → Usage.

Pronto para configurar?

Cadastre ou troque a sua chave a qualquer momento em Configurações → API de IA.

API de IA (traga sua chave)