Migración a DeepSeek V4 ahora es una tarea de limpieza con fecha límite, no solo una actualización de modelo. La documentación oficial de la API de DeepSeek dice que los alias antiguos deepseek-chat y deepseek-reasoner se retirarán por completo y dejarán de ser accesibles después del 24 de julio de 2026 a las 15:59 UTC. Los IDs de modelo V4 compatibles son deepseek-v4-flash y deepseek-v4-pro.
La buena noticia es que esto debería ser un cambio de configuración controlado para muchos equipos. DeepSeek indica mantener el mismo base_url directo y actualizar el nombre del modelo. Si enrutas modelos a través de Flatkey, usa la misma idea: mantén tu app apuntando a https://router.flatkey.ai/v1, reemplaza el alias por una fila actual del modelo Flatkey DeepSeek V4 y verifica el comportamiento de respuesta, el modo de razonamiento, los registros de uso, los precios y la reversión antes de que el tráfico de producción se traslade.
Esta lista de verificación de migración a DeepSeek V4 te ofrece los pasos concretos: mapear los alias antiguos, elegir deepseek-v4-flash o deepseek-v4-pro, probar el comportamiento con y sin razonamiento, actualizar la configuración del SDK y evitar un cambio de modelo sin revisión cerca de la fecha límite.
Respuesta rápida: ¿qué cambia en una migración a DeepSeek V4?
El cambio urgente es la cadena del modelo. No dejes el código de producción, las variables de entorno, los routers de prompts, los trabajos de evaluación o las políticas de fallback fijados de forma rígida a deepseek-chat o deepseek-reasoner.
| Alias antiguo | Comportamiento oficial actual | Destino de migración a probar | Riesgo a verificar |
|---|---|---|---|
deepseek-chat |
Actualmente enruta al modo no pensante de deepseek-v4-flash |
deepseek-v4-flash con el pensamiento deshabilitado, a menos que elijas intencionalmente otro modo V4 |
Estilo de salida, latencia, coste, compatibilidad del parser y cualquier parámetro ignorado |
deepseek-reasoner |
Actualmente enruta al modo pensante de deepseek-v4-flash |
deepseek-v4-flash o deepseek-v4-pro con el pensamiento probado explícitamente |
reasoning_content, uso de tokens, manejo de múltiples turnos y compatibilidad del SDK |
| Nombres de modelos al estilo Claude en la API Anthropic de DeepSeek | DeepSeek asigna los nombres de Claude Opus a V4 Pro y los nombres de Claude Haiku/Sonnet a V4 Flash | Prefiere identificadores explícitos de modelos DeepSeek V4 donde tu capa de enrutamiento lo permita | Campos Anthropic no compatibles, soporte de contenido de imagen/documento y comportamiento de llamadas a herramientas |
Para una llamada directa a DeepSeek, la URL base oficial con formato OpenAI sigue siendo https://api.deepseek.com. Para Flatkey, la URL base del router sigue siendo https://router.flatkey.ai/v1. En cualquiera de las dos rutas, la migración a DeepSeek V4 debe probarse como un cambio de modelo y de comportamiento, no solo como una búsqueda y reemplazo.
Por qué importa la fecha límite de los alias
La página de vista previa de V4 de DeepSeek dice que la API ya está disponible; tanto deepseek-v4-pro como deepseek-v4-flash admiten contexto de 1M y tanto el modo de razonamiento como el no razonamiento, y los alias antiguos se retirarán después del 24 de julio de 2026 a las 15:59 UTC. Eso significa que un alias obsoleto puede pasar de “funciona hoy” a “fallo total” después de la ventana de retirada.
La tabla de inicio rápido de la página principal también enumera deepseek-chat y deepseek-reasoner como alias que quedarán obsoletos el 2026/07/24. Indica que, por compatibilidad, esos alias corresponden a los modos no razonamiento y razonamiento de deepseek-v4-flash.
Ese detalle de compatibilidad es útil, pero no es una razón para esperar. Una migración a DeepSeek V4 limpia te da tiempo para comparar resultados, actualizar runbooks, capacitar a los equipos de soporte y asegurarte de que los paneles de producción muestren los nuevos ID de modelo antes de la fecha límite.
DeepSeek Directo vs. Enrutamiento de Flatkey
Hay dos rutas de migración comunes.
| Decisión | API de DeepSeek Directa | DeepSeek a través de Flatkey |
|---|---|---|
| URL base | https://api.deepseek.com |
https://router.flatkey.ai/v1 |
| Clave API | Clave API de DeepSeek | Clave API de Flatkey |
| Selección de modelo | ID oficial del modelo de DeepSeek | Fila actual del modelo DeepSeek en Flatkey |
| Beneficio principal | Configuración directa con el proveedor | Una clave, un router, registros de uso compartidos y visibilidad de cuotas y facturación entre proveedores |
| Verificación de producción | Respuesta de DeepSeek, modo de pensamiento, precios y errores | Respuesta, estado de la ruta, fila de modelo seleccionada, registro de uso, unidad de precios, cuota y reversión |
El texto público del producto de Flatkey posiciona la plataforma en torno a una sola clave API, una URL base compatible con OpenAI, precios claros, facturación unificada y un panel único para claves, uso y enrutamiento. Para los equipos que ya están moviendo tráfico de GPT, Claude, Gemini, Qwen, MiniMax y DeepSeek a través de una sola puerta de enlace, una migración a DeepSeek V4 es un buen momento para estandarizar los IDs de modelo y el registro en toda la pila.
Comprobación del catálogo de Flatkey para DeepSeek V4
Para este artículo, comprobé la API pública de precios de Flatkey el 16 de junio de 2026. La instantánea devolvió 638 filas de modelos en total y 19 filas con el nombre DeepSeek. Enumeraba tanto deepseek-v4-pro como deepseek-v4-flash en el grupo Standard con compatibilidad de endpoint openai.
Toma eso como una prueba de catálogo con fecha, no como una promesa de que tu cuenta y tu ruta estén listas. En la misma instantánea, ambas filas de V4 tenían el estado de disponibilidad unknown_failure, lo que significa que la disponibilidad debe confirmarse en la vista o panel actual de precios de Flatkey antes de que el tráfico real dependa de la ruta. Una migración a DeepSeek V4 cuidadosa debe incluir una prueba rápida en vivo y una verificación del registro de uso el día en que cambies.
Lista de verificación para la migración a DeepSeek V4
Use esta lista de verificación antes de reemplazar alias en producción.
- Inventarie cada alias. Busque en el código de la aplicación, variables de entorno, reglas del enrutador de prompts, configuraciones de evaluación, trabajos en segundo plano, notebooks, documentación y manuales de soporte
deepseek-chatydeepseek-reasoner. - Clasifique cada carga de trabajo. Marque cada ruta como chat, razonamiento, uso de herramientas del agente, salida estructurada, contexto largo, evaluación por lotes o solo fallback. No asuma que cada ruta debe pasar al mismo modo V4.
- Elija el modelo de destino. Comience con
deepseek-v4-flashcuando quiera el reemplazo más cercano para los alias actuales. Evalúedeepseek-v4-procuando la carga de trabajo necesite mayor capacidad y pueda aceptar el perfil de costo y latencia después de probarlo. - Haga explícito el pensamiento. Para el comportamiento antiguo de
deepseek-chat, pruebe el modo sin pensamiento. Para el comportamiento antiguo dedeepseek-reasoner, pruebe el modo de pensamiento y confirme cómo maneja su SDKreasoning_content. - Mantenga los IDs de modelo en la configuración. Ponga el modelo de destino en una variable de entorno o en una tabla de enrutamiento, no incrustado en la lógica de la aplicación.
- Ejecute pruebas de salida por pares. Compare las respuestas del alias antiguo con las nuevas respuestas V4 en prompts representativos, analizadores, tareas en modo JSON, llamadas a herramientas y casos de rechazo/error.
- Verifique el streaming y la contabilidad de uso. Compruebe si el uso final aparece donde su código de facturación u observabilidad lo espera, especialmente para respuestas en streaming.
- Revise el costo y las cuotas. Confirme los precios del proveedor o los precios de Flatkey y luego establezca una cuota baja o un presupuesto de prueba antes de que aumente el tráfico de producción.
- Registre el nuevo ID de modelo. Asegúrese de que los trazos, alertas y exportaciones de facturación muestren
deepseek-v4-flashodeepseek-v4-pro, no solo una etiqueta genérica del proveedor. - Prepare la reversión. Mantenga configurado un proveedor anterior o un modelo de fallback hasta que la ruta V4 haya pasado pruebas reales de carga de trabajo.
- Elimine documentación obsoleta. Actualice las guías internas de configuración para que los nuevos desarrolladores no copien alias obsoletos de nuevo en producción.
Plantilla de configuración para Flatkey
Solo plantilla: ejecuta esto con una clave Flatkey válida y un ID de modelo Flatkey DeepSeek V4 confirmado del catálogo actual. La estructura es la habitual del SDK de OpenAI, pero la ruta, el estado del modelo, el comportamiento de razonamiento y el registro de uso aún deben probarse.
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-v4-flash"
# Keep the target easy to change during rollout.
# For direct DeepSeek comparison:
DEEPSEEK_BASE_URL="https://api.deepseek.com"import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ.get("FLATKEY_DEEPSEEK_MODEL", "deepseek-v4-flash"),
messages=[
{
"role": "user",
"content": "Reply with one sentence confirming the DeepSeek V4 route is configured.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)Para pruebas directas de DeepSeek, sigue los ejemplos oficiales del SDK de OpenAI de DeepSeek para el modo de pensamiento. La guía de pensamiento indica que el interruptor de pensamiento viene habilitado por defecto, que el parámetro de esfuerzo en formato OpenAI admite high y max, y que las etiquetas de menor esfuerzo se asignan hacia arriba por compatibilidad. Si tu app depende de respuestas sin pensamiento, haz esa elección explícita y pruébala en lugar de confiar en un alias.
Matriz de pruebas antes del corte
Una migración a DeepSeek V4 solo debe aceptarse después de probar el comportamiento que realmente usa su producto.
| Prueba | Qué comprobar | Señal de aprobación |
|---|---|---|
| Chat básico | Prompt simple, forma de la respuesta, comportamiento del parser | La app recibe el contenido esperado sin errores de esquema o de rol |
| Modo de pensamiento | thinking, reasoning_effort y reasoning_content |
La salida de razonamiento se maneja o se suprime intencionalmente según la política de su producto |
| Streaming | Formato de fragmentos, uso final, comportamiento de tiempo de espera | El parser del cliente y los ganchos de facturación siguen funcionando |
| Llamadas a herramientas | Esquema de la herramienta, argumentos, turnos de agente de varios pasos | Las llamadas a herramientas se generan y consumen sin JSON mal formado ni IDs faltantes |
| Salida estructurada | Prompts en modo JSON y validación | La tasa de aprobación del validador se mantiene dentro de su umbral de lanzamiento |
| Contexto largo | Prompts grandes, truncamiento, supuestos de caché | El manejo del contexto es predecible y el costo es aceptable |
| Observabilidad de Flatkey | Estado de la ruta, ID del modelo, uso de tokens, costo y registros de errores | Las entradas del panel coinciden con la solicitud que envió |
| Rollback | Proveedor anterior o modelo de respaldo | El tráfico puede volver mediante configuración sin un despliegue |
Errores comunes
- Tratar la migración de DeepSeek V4 como una búsqueda y reemplazo global sin evaluación de resultados.
- Reemplazar
deepseek-reasonerpero olvidar probarreasoning_contenten conversaciones de varios turnos. - Dejar alias en trabajos de evaluación, ejemplos de soporte o reglas de fallback mientras el código de producción usa IDs de V4.
- Asumir que el comportamiento directo de DeepSeek y el enroutado de Flatkey son idénticos sin comprobar el estado de la ruta y los registros de uso.
- Copiar un ID de modelo de un artículo antiguo en lugar de la página actual de precios de Flatkey o del panel de control.
- Omitir las comprobaciones de costos porque la primera prueba rápida devuelve una respuesta normal.
- Esperar hasta el 24 de julio de 2026 y luego descubrir que un trabajo programado o un proceso en segundo plano sigue usando un alias inaccesible.
Cómo encaja esto con otras guías de migración de Flatkey
Si aún no ha centralizado la configuración del proveedor, comience con la guía más amplia de migración de API compatible con OpenAI. Cubre cambios en la URL base, pruebas de humo y patrones de reversión que se aplican más allá de DeepSeek.
Si todavía está decidiendo si enrutar DeepSeek directamente o a través de una pasarela, compare esta página con la guía existente de acceso a la API de DeepSeek. Para la elaboración de presupuestos y las comprobaciones de filas del modelo, utilice el flujo de trabajo de comparación de precios de modelos de IA y la página actual de precios de Flatkey.
Preguntas frecuentes
¿Cuándo quedan obsoletos deepseek-chat y deepseek-reasoner?
La documentación oficial de DeepSeek indica el 24 de julio de 2026 a las 15:59 UTC como la hora de retirada a partir de la cual deepseek-chat y deepseek-reasoner no estarán accesibles. Planifica tu migración a DeepSeek V4 antes de esa fecha.
¿Qué debería reemplazar a deepseek-chat?
Para el comportamiento más مشابه, prueba deepseek-v4-flash con comportamiento no pensante. DeepSeek indica que deepseek-chat actualmente se enruta al modo no pensante de deepseek-v4-flash.
¿Qué debería reemplazar a deepseek-reasoner?
Prueba deepseek-v4-flash o deepseek-v4-pro con el modo de pensamiento habilitado, según tus necesidades de calidad, coste y latencia. DeepSeek indica que deepseek-reasoner actualmente se enruta al modo de pensamiento de deepseek-v4-flash.
¿Necesito cambiar la URL base de DeepSeek?
Para llamadas directas de DeepSeek con formato OpenAI, la URL base oficial sigue siendo https://api.deepseek.com. Para llamadas de Flatkey, usa https://router.flatkey.ai/v1 y una clave API de Flatkey.
¿Flatkey admite DeepSeek V4?
La instantánea de la API de precios de Flatkey del 16 de junio de 2026 enumeraba deepseek-v4-pro y deepseek-v4-flash con compatibilidad de endpoint openai. La misma instantánea mostraba el estado de disponibilidad unknown_failure para esas filas, así que verifica la página de precios actual, el estado de la ruta en el panel y una prueba rápida en vivo antes del tráfico de producción.
¿Debería elegir deepseek-v4-flash o deepseek-v4-pro?
Usa deepseek-v4-flash como el primer candidato de reemplazo para la compatibilidad con el alias antiguo. Prueba deepseek-v4-pro cuando la carga de trabajo necesite un razonamiento o capacidad de agente más sólidos y tus comprobaciones de latencia y coste sean satisfactorias.
Ver precios antes de cambiar el tráfico de producción
La migración a DeepSeek V4 es el momento adecuado para eliminar alias obsoletos, hacer explícito el comportamiento de razonamiento y poner la selección del modelo detrás de la configuración. Antes de implementar, confirme la fila actual del modelo Flatkey, el estado de la ruta, los registros de uso y los precios para deepseek-v4-flash o deepseek-v4-pro.
Ver precios para comprobar las filas actuales de Flatkey DeepSeek V4 antes de mover el tráfico de producción.
