## Visión general

**DeepSeek** es un proveedor de modelos de lenguaje que tu bot puede usar como **modelo principal** o
como **modelo de respaldo**, en el mismo lugar donde eliges OpenAI, Anthropic, Google, Groq y los
demás.

El acceso es **nativo**: la plataforma habla directo con `api.deepseek.com`. Eso es distinto de usar
el mismo modelo **a través de OpenRouter** — en el acceso nativo el consumo se cobra en **tu cuenta
DeepSeek**, con tu clave, sin intermediario.

| Modelo | Perfil |
|---|---|
| **DeepSeek V4 Pro** | El más capaz de la familia — para razonamiento y tareas complejas. |
| **DeepSeek V4 Flash** | El más rápido y económico — para volumen y respuestas cortas. |

## Requisitos previos

- **Maestro habilitado** y un bot configurado.
- Una **clave de API de DeepSeek** (créala en `platform.deepseek.com/api_keys`).
- Permiso de **administrador** para configurar claves.

## Paso a paso

Elige **uno** de los tres lugares para la clave — el bot los busca en este orden:

1. **Solo en este bot** — en la configuración del bot, sección **Claves de API (por proveedor)**, fila
   **DeepSeek**: pega la clave y pulsa **Probar** para confirmar antes de guardar.
2. **Para toda la cuenta** — en **Configuración → Integraciones → DeepSeek**, ingresa la clave. Todos
   los bots de la cuenta pueden usarla (siempre que ese bot tenga activado el uso de la clave de la
   cuenta).
3. **Para la instalación** — el operador define la clave en el panel de super admin. Vale como último
   recurso para todas las cuentas.

Una vez guardada la clave:

4. Vuelve a la configuración del bot y abre el selector de **Modelo**.
5. Elige **DeepSeek V4 Pro** o **DeepSeek V4 Flash** como modelo principal, o agrega uno de ellos a la
   **cadena de respaldo**.
6. **Guarda.**

## Configuración y opciones

### El orden de búsqueda de la clave

| Orden | Origen | Cuándo usarlo |
|---|---|---|
| 1.º | **Clave del propio bot** | Un bot específico con costo separado. |
| 2.º | **Clave de la cuenta** (Integraciones) | Lo predeterminado para la mayoría de las operaciones. |
| 3.º | **Clave de la instalación** | Definida por el operador; cubre a quien no tiene clave propia. |

La clave del bot **siempre gana**. Las dos globales solo entran si la instalación lo permite y el bot
tiene esa opción activada — la misma regla que los demás proveedores.

### Lista de modelos en vivo

Con la clave configurada, la plataforma consulta la lista de modelos directo en DeepSeek, así que un
modelo nuevo aparece sin necesidad de actualización. El listado **exige la clave** — no existe
consulta anónima. Si la consulta falla, el selector cae en la lista curada de arriba y **nunca queda
vacío**.

### Nativo frente a vía OpenRouter

El mismo modelo puede aparecer dos veces en el selector:

- **`deepseek:…`** — acceso **nativo**, cobrado en tu cuenta DeepSeek.
- **`openrouter:deepseek/…`** — el mismo modelo **a través de OpenRouter**, cobrado en tu cuenta
  OpenRouter.

No es duplicidad: son rutas y facturas distintas. Elige el nativo si tienes cuenta DeepSeek.

## Casos de uso

- **Costo por volumen** — DeepSeek V4 Flash en bots de alto volumen y respuestas cortas.
- **Razonamiento más pesado** — DeepSeek V4 Pro en bots que analizan o deciden.
- **Respaldo de otro proveedor** — poner un modelo DeepSeek en la cadena para que la atención no se
  detenga cuando el proveedor principal quede sin servicio o sin crédito.

## Consejos, límites y buenas prácticas

- **Prueba la clave** en el propio formulario antes de guardar. Una clave inválida aparece al momento.
- Al armar la **cadena de respaldo**, evita repetir el **mismo proveedor** en secuencia: si la caída
  es de cuenta (se acabó el crédito), el segundo intento golpea la misma puerta cerrada. Alterna
  proveedores.
- El consumo se cobra **en tu cuenta DeepSeek** — vigila el saldo allí.
- La clave es de **solo escritura**: una vez guardada, la interfaz solo muestra que existe, nunca su
  valor.
- Cambiar de modelo **no** borra ninguna otra configuración del bot.

## Solución de problemas

- **«DeepSeek no aparece en el selector de modelo»** — no hay clave en ninguno de los tres niveles, o
  el bot tiene desactivado el uso de las claves globales.
- **«La clave fue rechazada en la prueba»** — genera otra en `platform.deepseek.com/api_keys` y
  revisa que no tenga un espacio al inicio o al final.
- **«La lista de modelos vino vacía»** — la consulta a DeepSeek falló; el selector muestra la lista
  curada y puedes elegir normalmente.
- **«El bot cayó al respaldo todo el tiempo»** — revisa el saldo de la cuenta DeepSeek.
- **«Elegí DeepSeek y el cobro apareció en OpenRouter»** — seleccionaste la variante
  `openrouter:deepseek/…`; cámbiala por la que empieza con `deepseek:`.

## Ver también

- [Qué son Maestro IA y el Cerebro de la Cuenta](/hc/ajuda/articles/maestro-brain-overview-es)
- [Plantillas portables: guardar, duplicar, compartir y migrar un bot](/hc/ajuda/articles/maestro-brain-modelos-portateis-es)
- [Herramientas de Maestro por módulo](/hc/ajuda/articles/maestro-brain-ferramentas-maestro-por-modulo-es)
- [Dónde se usa cada bot](/hc/ajuda/articles/maestro-brain-onde-cada-robo-e-usado-es)