DeepSeek como provedor de modelo do Robô

Visão geral

O DeepSeek é um provedor de modelos de linguagem que o Robô pode usar como modelo principal ou como modelo de fallback, no mesmo lugar em que você escolhe OpenAI, Anthropic, Google, Groq e os demais.

O acesso é nativo: a plataforma fala direto com api.deepseek.com. Isso é diferente de usar o mesmo modelo através do OpenRouter — no acesso nativo o consumo é cobrado na sua conta DeepSeek, com a sua chave, sem intermediário.

Pré-requisitos

• Maestro habilitado e um Robô configurado.
• Uma chave de API do DeepSeek (crie em platform.deepseek.com/api_keys).
• Permissão de administrador para configurar chaves.

Passo a passo

Escolha um dos três lugares para a chave — o Robô procura nessa ordem:

1. Só neste Robô — na configuração do Robô, seção Chaves de API (por provedor), linha DeepSeek: cole a chave e clique em Testar para confirmar antes de salvar.
2. Para a conta inteira — em Configurações → Integrações → DeepSeek, informe a chave. Todos os Robôs da conta passam a poder usá-la (desde que o Robô esteja com o uso da chave da conta ligado).
3. Para a instalação — o operador define a chave no painel de super admin. Vale como último recurso para todas as contas.

Depois de salvar a chave:

4. Volte à configuração do Robô e abra o seletor de Modelo.
5. Escolha DeepSeek V4 Pro ou DeepSeek V4 Flash como modelo principal, ou adicione um deles à cadeia de fallback.
6. Salve.

Configurações & opções

A ordem de busca da chave

A chave do Robô sempre vence. As duas globais só entram se a instalação permitir e o Robô estiver com essa opção ligada — a mesma regra dos demais provedores.

Lista de modelos ao vivo

Com a chave configurada, a plataforma consulta a lista de modelos direto no DeepSeek, então um modelo novo aparece sem precisar de atualização. A listagem exige a chave — não existe consulta anônima. Se a consulta falhar, o seletor cai na lista curada acima, e nunca fica vazio.

Nativo × via OpenRouter

O mesmo modelo pode aparecer duas vezes no seletor:

• deepseek:… — acesso nativo, cobrado na sua conta DeepSeek.
• openrouter:deepseek/… — o mesmo modelo através do OpenRouter, cobrado na sua conta OpenRouter.

Não é duplicidade: são caminhos e faturas diferentes. Escolha o nativo se você tem conta DeepSeek.

Casos de uso

• Custo por volume — DeepSeek V4 Flash em Robôs de alto volume e respostas curtas.
• Raciocínio mais pesado — DeepSeek V4 Pro em Robôs que analisam ou decidem.
• Fallback de outro provedor — colocar um modelo DeepSeek na cadeia para o atendimento não parar quando o provedor principal ficar indisponível ou sem crédito.

Dicas, limites e boas práticas

• Teste a chave no próprio formulário antes de salvar. Chave inválida aparece na hora.
• Ao montar a cadeia de fallback, evite repetir o mesmo provedor em sequência: se a queda for de conta (crédito acabou), o segundo tenta a mesma porta fechada. Alterne provedores.
• O consumo é cobrado na sua conta DeepSeek — acompanhe o saldo por lá.
• A chave é somente escrita: depois de salva, a interface mostra apenas que existe, nunca o valor.
• Trocar de modelo não apaga nenhuma outra configuração do Robô.

Solução de problemas

• "O DeepSeek não aparece no seletor de modelo" — não há chave em nenhum dos três níveis, ou o Robô está com o uso das chaves globais desligado.
• "A chave foi recusada no teste" — gere outra em platform.deepseek.com/api_keys e confira se não veio com espaço no começo ou no fim.
• "A lista de modelos veio vazia" — a consulta ao DeepSeek falhou; o seletor mostra a lista curada e você pode escolher normalmente.
• "O Robô caiu para o fallback o tempo todo" — verifique o saldo da conta DeepSeek.
• "Escolhi DeepSeek e a cobrança apareceu no OpenRouter" — você selecionou a variante openrouter:deepseek/…; troque pela que começa com deepseek:.

Veja também

• O que é o Maestro IA e o Cérebro da Conta
• Modelos portáveis: salvar, duplicar, compartilhar e migrar um Robô
• Ferramentas do Maestro por módulo
• Onde cada Robô é usado