Configurando o modelo de IA — Conectando o "cérebro" do funcionário

Os funcionários de IA do DoDone utilizam modelos de empresas como OpenAI (GPT), Google (Gemini) e Anthropic (Claude). Para usar esses modelos, você precisa de uma chave de API emitida por essas empresas. Nesta página, explicamos o que é uma chave de API, por que ela é necessária e como inseri-la, pensando em quem está começando agora.

O que é uma chave de API? Por que eu preciso inserir manualmente?

• Chave de API é uma senha longa que a empresa de IA fornece para autorizar o uso do seu serviço. Com essa chave, o programa pode acessar a IA da empresa.
• O DoDone não revende IA. Você faz contrato direto com a empresa de IA e paga apenas pelo que usar, diretamente para ela. Não há margem intermediária e você escolhe qual modelo usar.
• A chave é armazenada criptografada no cofre de senhas do sistema operacional do seu computador e aparece oculta na tela. Ela não é enviada para o servidor do DoDone.

Qual empresa escolher?

Basta ter uma. Se você cadastrar mais de uma, quando uma estiver fora do ar, o sistema troca automaticamente para outra.

Empresa	Pontos fortes	Geração de imagem	Onde emitir a chave
OpenAI (GPT)	Escrita, análise geral, geração de imagens	Sim	platform.openai.com/api-keys
Google (Gemini)	Processamento de textos longos, imagem, voz, música, tradução simultânea	Sim	aistudio.google.com/apikey
Anthropic (Claude)	Textos longos, documentos detalhados	Não (imagens são geradas por outra empresa automaticamente)	console.anthropic.com/settings/keys

Se for sua primeira vez, recomendamos começar com uma chave do Google (Gemini). Texto, imagem, voz e tradução podem ser usados com uma única chave, e há uma cota gratuita.

Como emitir a chave (passos comuns)

1. Acesse o endereço da tabela acima e faça login (com conta Google, etc.).
2. Clique em um botão como "Create API key" e aparecerá uma sequência longa como sk-…, AIza…. Copie imediatamente, pois pode não ser possível ver novamente depois de sair da tela.
3. Para OpenAI e Anthropic, é necessário cadastrar um método de pagamento e adicionar um saldo. No Google, você pode começar com a cota gratuita.

Inserindo a chave no app

No Menu (≡) > Configurações > Modelos, cole a chave no cartão da empresa correspondente e clique em [Salvar]. Você pode verificar se a chave está ativa clicando em [Testar conexão].

Modelos por uso — Qual modelo usar para cada tarefa

Cada empresa oferece vários modelos (alguns rápidos e baratos, outros mais lentos e inteligentes). O DoDone permite usar modelos diferentes para cada tipo de tarefa, dividindo em três categorias.

Categoria	Para que serve	Recomendação
Texto	Respostas, pesquisas, redação, resumos	Modelos rápidos e econômicos (linha flash, mini)
Saída estruturada	Resultados que exigem estrutura precisa, como documentos, tabelas, slides, planejamento	Modelos um pouco mais avançados
Imagem	Ilustrações, pôsteres, páginas detalhadas, avatares	Modelos específicos para imagem

Ao salvar a chave, o sistema busca automaticamente a lista de modelos disponíveis dessa empresa e preenche o menu suspenso. Os modelos mais recentes aparecem no topo. Você pode atualizar a lista com o botão ↻ e, se o nome não estiver na lista, usar [Inserir manualmente…].

Provedor padrão da empresa e padrão por tipo

• Provedor padrão: Quando há chaves de várias empresas, define qual será usada normalmente.
• Padrão por tipo: Você pode definir separadamente qual empresa usar para texto, imagem e áudio. Exemplo: texto com Claude, imagem com OpenAI, voz/música com Gemini.

Essa configuração é o padrão para todos os funcionários. Se quiser que um funcionário use um modelo diferente, configure em detalhes do funcionário em Modelos por funcionário.

Quanto custa?

• Uma tarefa de texto geralmente custa alguns centavos a algumas dezenas de centavos. Uma imagem custa de dezenas a centenas de centavos, e um relatório longo ou 20 slides, algumas centenas de centavos.
• Em Menu > Uso de tokens, você pode ver o uso e o custo estimado por empresa e por funcionário.
• Em Configurações > Execução > Limite mensal de custo, você pode definir um teto de gastos. Quando o limite é atingido, novas tarefas não são aceitas. Recomendamos definir um limite no início. Para mais detalhes, veja Gestão de custos.

Avisaremos quando um novo modelo for lançado

A lista de modelos da empresa com a chave cadastrada é verificada uma vez por dia automaticamente. Se aparecer um modelo novo que não estava antes, um banner verde aparece no topo avisando: "Foram adicionados 2 novos modelos no OpenAI: gpt-6-astra, …". Ao clicar em [Configurações > Modelos], você verá o novo modelo marcado com 🆕 na lista. Basta selecionar e clicar em [Verificar] para começar a usar imediatamente.

• Na primeira verificação após a instalação, apenas um ponto de referência é criado e não há notificação.
• Se você fechar o banner, esses modelos não serão notificados novamente. Um novo banner só aparecerá quando surgirem outros modelos novos.
• Pode ser que a empresa tenha listado o modelo, mas sua chave ainda não permita o uso. Se [Verificar] falhar, tente novamente em alguns instantes.

FAQ

P: Coloquei a chave, mas aparece "Nenhum modelo foi configurado".

Isso acontece quando, após salvar a chave, os campos de texto, estrutura ou imagem ficam sem modelo selecionado. Escolha um modelo de cada categoria na lista automática e clique em [Salvar].

P: Tenho assinatura paga do ChatGPT, mas não funciona?

A assinatura do ChatGPT (Plus, etc.) e a chave da API são produtos diferentes. A API deve ser recarregada separadamente em platform.openai.com. Usar apps de terceiros com a conta de assinatura não é um método oficialmente permitido pela OpenAI, então o DoDone não oferece suporte para isso.

P: O que faço se minha chave vazar?

Basta excluir (revogar) a chave no site onde foi emitida e criar uma nova. Depois, insira a nova chave no DoDone.