Si necesitas acceso a la API de DeepSeek dentro de un producto que ya usa SDKs estilo OpenAI, la ruta de migración más limpia normalmente no es una reescritura completa del cliente. Es una decisión de base URL, clave API e ID de modelo.
La documentación oficial de la API de DeepSeek dice que la API usa formatos compatibles con OpenAI y Anthropic. A fecha de 11 de junio de 2026, los nombres de modelo actuales de DeepSeek en el quickstart oficial son deepseek-v4-flash y deepseek-v4-pro. Los alias anteriores deepseek-chat y deepseek-reasoner todavía están documentados, pero DeepSeek marca ambos para su desuso el 24 de julio de 2026 a las 15:59 UTC.
Ese detalle del nombre del modelo importa. Muchas guías de acceso a la API de DeepSeek todavía muestran alias antiguos o se centran solo en una clave de proveedor directa. Esta guía muestra cómo evaluar el acceso directo a DeepSeek y cómo añadir DeepSeek mediante un router compatible con OpenAI como Flatkey, donde el mismo patrón de aplicación puede convivir con GPT, Claude, Gemini, Qwen, Seedance y modelos de imagen.
Respuesta rápida: acceso directo a la API de DeepSeek vs acceso mediante router
La mejor vía de acceso a la API de DeepSeek depende de qué quieras controlar.
| Vía de acceso | Cuándo usarla | Qué cambia en el código | Qué comprobar |
|---|---|---|---|
| API directa de DeepSeek | Quieres una cuenta directa de DeepSeek, precios directos de DeepSeek y la documentación nativa de DeepSeek como fuente de verdad. | Configura la URL base del SDK de OpenAI en https://api.deepseek.com y usa una clave API de DeepSeek. |
Los nombres de modelo actuales, notas de depreciación, precios, límites de tokens y límites de tasa en la documentación de DeepSeek. |
| Router compatible con OpenAI de Flatkey | Quieres DeepSeek junto con otras familias de modelos mediante una sola clave API, facturación unificada y un panel para claves, uso y enrutamiento. | Configura la URL base en https://router.flatkey.ai/v1, usa una clave de Flatkey y elige un ID de modelo DeepSeek listado por Flatkey. |
La disponibilidad del catálogo de modelos de Flatkey, la ortografía del ID del modelo, la página de precios y los registros de uso después de la primera llamada. |
| Proxy autogestionado | Necesitas operar tu propia pasarela, capa de políticas o infraestructura privada de enrutamiento. | Tu aplicación apunta al endpoint de tu proxy, y tu equipo de plataforma conecta ese proxy con las cuentas del proveedor. | Implementación, secretos, observabilidad, respuesta a incidentes y propiedad de la cuenta del proveedor. |
Si tu equipo solo necesita una carga de trabajo de DeepSeek y quiere una relación comercial directa, la configuración directa con el proveedor es sencilla. Si tu equipo está añadiendo DeepSeek a una pila existente de varios modelos, el acceso a la API de DeepSeek basado en router puede reducir la dispersión de cuentas y mantener la migración cerca del patrón de cliente compatible con OpenAI que ya usas.
Los hechos actuales de DeepSeek que hay que verificar primero
Antes de publicar acceso a la API de DeepSeek, verifica los nombres de los modelos el día en que publiques o despliegues. La documentación oficial de DeepSeek muestra actualmente esta base:
| Campo | Detalle oficial actual |
|---|---|
| URL base con formato OpenAI | https://api.deepseek.com |
| URL base con formato Anthropic | https://api.deepseek.com/anthropic |
| IDs de modelos actuales | deepseek-v4-flash y deepseek-v4-pro |
| Alias obsoletos | deepseek-chat y deepseek-reasoner están documentados como obsoletos después del 24 de julio de 2026 a las 15:59 UTC. |
| Contexto y salida | La página de precios de DeepSeek indica 1M de longitud de contexto y una salida máxima de 384K para los modelos V4 actuales. |
| Base de precios | La página de precios de DeepSeek indica precios por 1M de tokens y recomienda consultar la página para ver los precios actuales. |
Por eso, una guía moderna de acceso a la API de DeepSeek no debería codificar de forma fija deepseek-chat como modelo predeterminado. Si usas ese alias hoy, crea un plan de migración a deepseek-v4-flash o deepseek-v4-pro. Si usas un router, comprueba si el catálogo de tu router expone los IDs actuales de los modelos de DeepSeek, los alias de compatibilidad anteriores, o ambos.
Acceso directo a la API de DeepSeek con el SDK de OpenAI
Para el acceso directo a la API de DeepSeek, la configuración resulta familiar si tu aplicación ya usa el SDK de OpenAI. Creas un cliente, cambias la URL base, usas una clave de API de DeepSeek y llamas a un modelo de DeepSeek.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro",
messages: [
{ role: "system", content: "Eres un asistente técnico conciso." },
{ role: "user", content: "Resume este plan de migración." }
],
stream: false
});
console.log(response.choices[0].message.content);Usa esta ruta cuando la propia cuenta de DeepSeek forme parte del requisito. El acceso directo a la API de DeepSeek mantiene la documentación, los precios, los límites de tasa y la ruta de soporte de DeepSeek como el modelo operativo principal.
La configuración directa también te da la menor ambigüedad en torno a los parámetros específicos de DeepSeek. Los ejemplos actuales de DeepSeek incluyen campos relacionados con el razonamiento para los modelos V4. Si esos parámetros importan para tu carga de trabajo, pruébalos primero directamente contra DeepSeek y luego confirma si tu enrutador pasa los mismos campos antes de usarlos en producción a través de una puerta de enlace.
Acceso a la API de DeepSeek a través de Flatkey
Flatkey es útil cuando el acceso a la API de DeepSeek es un requisito de una familia de modelos dentro de un stack más amplio. El texto público del producto de Flatkey dice que los desarrolladores pueden acceder a Claude, GPT, Gemini, DeepSeek, Qwen, Seedance 2.0, GPT Image y más con una sola clave de API, sin gestionar cuentas separadas de proveedores. También describe precios claros, facturación unificada, un único panel para claves, uso y enrutamiento, además de conmutación automática y balanceo de carga.
El patrón de migración del router es intencionalmente pequeño:
- Crea o usa una clave de API de Flatkey.
- Apunta tu cliente compatible con OpenAI a
https://router.flatkey.ai/v1. - Selecciona un ID de modelo DeepSeek mostrado en tu página de precios o panel de Flatkey.
- Ejecuta una solicitud no crítica.
- Confirma la respuesta, la ruta del modelo, el registro de uso y la línea de coste en el panel.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1"
});
const response = await client.chat.completions.create({
model: "deepseek-v4-pro", // Confirma el ID actual del modelo de Flatkey antes del despliegue.
messages: [
{ role: "system", content: "You are a concise technical assistant." },
{ role: "user", content: "Draft a release note for this feature." }
]
});
console.log(response.choices[0].message.content);El 11 de junio de 2026, el endpoint público de precios de Flatkey devolvió 653 filas de modelos e incluyó filas de DeepSeek como deepseek-v4-flash, deepseek-v4-pro, deepseek-v3.2, deepseek-v3.2-thinking, deepseek-chat y deepseek-reasoner. Considera eso como una instantánea fechada del catálogo, no como una garantía permanente. Para el acceso a la API de DeepSeek en producción, revisa la página de precios activa de Flatkey y el selector de modelos de tu cuenta antes de elegir un ID de modelo.
Cuándo un router ayuda más que una clave directa
Un router no es automáticamente mejor que el acceso directo a la API de DeepSeek. Es mejor cuando la capa de acceso que lo rodea es la parte difícil.
El acceso a la API de DeepSeek basado en router es una buena opción cuando:
- Tu aplicación ya llama a completions de chat compatibles con OpenAI.
- Quieres añadir DeepSeek sin añadir otro flujo de trabajo de cuenta de proveedor para cada desarrollador.
- Estás comparando DeepSeek con GPT, Claude, Gemini o Qwen en la misma función del producto.
- Necesitas una sola superficie de revisión de facturación y uso para un equipo.
- Quieres hábitos de cuota antes de que crezca el tráfico.
- Quieres una ruta de migración más limpia si cambia un nombre de modelo, una regla del proveedor o el precio.
El acceso directo a la API de DeepSeek es una mejor opción cuando:
- Necesitas un contrato directo de DeepSeek o una relación con el proveedor.
- Estás probando parámetros de solicitud específicos de DeepSeek que quizá aún no se transmitan a través del router.
- Tu área de compras o política de datos requiere términos directos del proveedor.
- Quieres aislar una carga de trabajo exclusiva de DeepSeek sin requisito de enrutamiento multimodelo.
Lista de verificación de migración para aplicaciones existentes compatibles con OpenAI
Use esta lista de verificación antes de trasladar el acceso a la API de DeepSeek a una ruta de producción.
| Paso | Qué hacer | Por qué es importante |
|---|---|---|
| 1 | Enumere la carga de trabajo exacta: chat, razonamiento, salida JSON, llamadas a herramientas o asistencia de código. | La elección del modelo DeepSeek V4 y el modo de pensamiento deben coincidir con la carga de trabajo. |
| 2 | Elija un ID de modelo actual, preferiblemente deepseek-v4-flash o deepseek-v4-pro cuando estén disponibles. |
Los alias anteriores tienen un aviso de desaprobación fechado en la documentación oficial de DeepSeek. |
| 3 | Cambie la URL base y la clave API en un entorno de no producción. | Esto confirma que la migración es realmente un cambio de configuración, no una reescritura. |
| 4 | Envíe una pequeña solicitud de prueba e inspeccione la forma de la respuesta, el uso de tokens y los errores. | Que sea compatible con OpenAI no elimina la necesidad de validar el comportamiento del modelo. |
| 5 | Revise la facturación y los registros de uso en DeepSeek o Flatkey, según la ruta de acceso. | La visibilidad de costos es parte de la decisión de acceso, no una reflexión de último momento. |
| 6 | Pruebe el comportamiento de respaldo para un error ascendente, un tiempo de espera o una condición de cuota. | Los usuarios del router necesitan saber qué sucede cuando falla una ruta del modelo. |
| 7 | Fije los ID de modelo en la configuración y programe una revisión del nombre del modelo antes del 24 de julio de 2026. | Esto evita depender de alias obsoletos después de la fecha anunciada por DeepSeek. |
Acerca del acceso gratuito a la API de DeepSeek
Algunas búsquedas sobre este tema usan términos como acceso gratis con clave API de DeepSeek, acceso gratuito a la API de DeepSeek R1 o límites de acceso gratuito a la API de DeepSeek. No construyas un plan de producción basándote en esas frases a menos que el proveedor actual o la página del router documenten explícitamente la oferta.
La página de precios oficial de DeepSeek es la fuente adecuada para conocer los precios directos del proveedor. La página de precios de Flatkey es la fuente adecuada para el uso enrutado por Flatkey. Este artículo no afirma un límite de acceso gratuito a la API de DeepSeek porque las condiciones gratuitas pueden cambiar rápidamente y deben verificarse en la fuente el día en que te registres.
Configuración recomendada
Para la mayoría de los equipos de producto que añaden DeepSeek a una aplicación existente compatible con OpenAI, empiecen con una pequeña prueba del router:
- Abre la página de precios de Flatkey y confirma los IDs actuales de los modelos de DeepSeek.
- Crea una clave de Flatkey y establece
baseURLenhttps://router.flatkey.ai/v1. - Ejecuta una solicitud de bajo riesgo con
deepseek-v4-flashodeepseek-v4-prosolo si el modelo aparece listado para tu cuenta. - Revisa el registro de uso y facturación.
- Compara la misma carga de trabajo con GPT, Claude, Gemini o Qwen si tu producto necesita enrutamiento multmodelo.
Esa ruta mantiene práctico el acceso a la API de DeepSeek. Sigues respetando los nombres oficiales de los modelos de DeepSeek y las notas de obsolescencia, pero evalúas DeepSeek dentro del mismo flujo de trabajo de router, facturación y uso que tu equipo puede utilizar para el resto de su pila de modelos.
Ver precios para consultar el catálogo actual de modelos de DeepSeek de Flatkey y comparar el uso enrutado antes de migrar el tráfico de producción.
FAQ
¿Cuál es la URL base actual de la API de DeepSeek?
Para el acceso directo a la API de DeepSeek en formato OpenAI, la documentación oficial de DeepSeek indica https://api.deepseek.com. Para el acceso en formato Anthropic, la documentación indica https://api.deepseek.com/anthropic. A través de Flatkey, la URL base del router compatible con OpenAI es https://router.flatkey.ai/v1.
¿Qué modelo de DeepSeek debo usar ahora?
La guía rápida oficial actual de DeepSeek indica deepseek-v4-flash y deepseek-v4-pro. La documentación dice que deepseek-chat y deepseek-reasoner quedarán obsoletos el 24 de julio de 2026 a las 15:59 UTC, por lo que los nuevos trabajos de acceso a la API de DeepSeek deben evitar tratar esos alias como el valor predeterminado a largo plazo.
¿Puedo usar el SDK de OpenAI para DeepSeek?
Sí. La documentación de DeepSeek indica que su formato de API es compatible con OpenAI y Anthropic. Con el SDK de OpenAI, el acceso directo a DeepSeek usa la URL base y la clave de DeepSeek. Con Flatkey, el acceso a la API de DeepSeek basado en router usa la URL base y la clave de Flatkey.
¿Flatkey ofrece acceso gratuito a la API de DeepSeek?
Esta guía no afirma que el acceso a la API de DeepSeek sea gratuito. Consulta la página de precios actual de Flatkey para el uso enrutado y la página oficial de precios de DeepSeek para los precios del proveedor directo.
¿Por qué usar Flatkey en lugar de una clave directa de DeepSeek?
Usa Flatkey cuando DeepSeek forme parte de una pila multimodelo y quieras una sola clave de API, facturación unificada, visibilidad de uso y un router compatible con OpenAI. Usa el acceso directo a la API de DeepSeek cuando necesites una cuenta de proveedor directa, una ruta de soporte directa de DeepSeek o un comportamiento de solicitud específico del proveedor.
