## 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.

| Modelo | Perfil |
|---|---|
| **DeepSeek V4 Pro** | O mais capaz da família — para raciocínio e tarefas complexas. |
| **DeepSeek V4 Flash** | O mais rápido e econômico — para volume e respostas curtas. |

## 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

| Ordem | Origem | Quando usar |
|---|---|---|
| 1º | **Chave do próprio Robô** | Um Robô específico com custo separado. |
| 2º | **Chave da conta** (Integrações) | O padrão para a maioria das operações. |
| 3º | **Chave da instalação** | Definida pelo operador; vale para quem não tem chave própria. |

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](/hc/ajuda/articles/maestro-brain-overview-pt-br)
- [Modelos portáveis: salvar, duplicar, compartilhar e migrar um Robô](/hc/ajuda/articles/maestro-brain-modelos-portateis-pt-br)
- [Ferramentas do Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-pt-br)
- [Onde cada Robô é usado](/hc/ajuda/articles/maestro-brain-onde-cada-robo-e-usado-pt-br)