Lista de verificación de migración de DeepSeek V4: sustituye de forma segura los alias obsoletos

La migración de DeepSeek V4 ya no es una tarea genérica de "actualizar a V4". A fecha de 16 de septiembre de 2026, el riesgo de migración es específico: DeepSeek indica que los nombres heredados deepseek-v4-flash y deepseek-v4-flash-vision-exp siguen aceptándose por compatibilidad, pero esos nombres de modelo retirados son atendidos por DeepSeek-V4.1-Flash y se facturan al precio de Flash. DeepSeek también indica que el servicio API para deepseek-v4-pro continúa después del 14 de septiembre de 2026, con el método de facturación existente salvo que DeepSeek dé un aviso posterior.

Eso significa que el camino seguro no es perseguir todos los alias históricos. El camino seguro es estandarizar el trabajo nuevo en deepseek-flash, documentar dónde deepseek-v4-pro sigue usándose de forma intencionada y verificar la ruta exacta que llama tu producto. Si enrutas a través de Flatkey, se aplica el mismo principio: mantén el cliente compatible con OpenAI apuntando a https://router.flatkey.ai/v1, elige la fila actual de DeepSeek del catálogo en vivo, ejecuta una prueba rápida y confirma los registros de uso antes de mover tráfico de producción.

Esta guía Lista de verificación de migración de DeepSeek V4: sustituye de forma segura los alias obsoletos ofrece a los indie hackers y a los equipos pequeños de productos de IA una puesta en producción práctica: auditar alias obsoletos, actualizar IDs de modelo, probar el modo de razonamiento, validar la API Responses y el comportamiento de las llamadas a herramientas, comprobar las unidades de precio y mantener la reversión simple.

Respuesta rápida: ¿qué debería cambiar?

Usa deepseek-flash como el nombre actual del modelo Flash. Trata deepseek-v4-flash y deepseek-v4-flash-vision-exp como alias de compatibilidad que deben eliminarse del código nuevo, las políticas de enrutamiento, la documentación y las hojas de evaluación. Mantén deepseek-v4-pro solo donde tengas un motivo para probar y supervisar directamente la ruta Pro.

La regla práctica de migración de DeepSeek V4 es simple: los alias pertenecen a un informe de auditoría, no a una nueva configuración de producción.

Por qué esta migración es diferente de la lista de verificación de junio

La versión original de este artículo se centraba en una retirada en julio de 2026 de deepseek-chat y deepseek-reasoner. Ese ya no es el marco más seguro para esta página. La documentación oficial actual de DeepSeek enfatiza el lanzamiento V4.1 Flash, el nombre de modelo deepseek-flash, los alias obsoletos de Flash y Flash Vision, y la nota continua de servicio de API para deepseek-v4-pro.

Para un equipo pequeño, esto cambia el plan de migración. No necesitas una reescritura frenética de cada mención relacionada con DeepSeek. Necesitas una limpieza controlada de alias con evidencia fechada:

• ¿Qué cadenas de modelo siguen existiendo en el código, variables de entorno, trabajos de evaluación y documentación?
• ¿Qué cadenas son alias de compatibilidad y qué cadenas son identificadores de modelo actuales?
• ¿Qué rutas son rutas directas de DeepSeek y qué rutas pasan por Flatkey u otra pasarela?
• ¿Qué cargas de trabajo dependen de visión, razonamiento, Responses API, llamadas a herramientas, salida estructurada, contexto largo o streaming?
• ¿Qué paneles demuestran que el nuevo identificador de modelo realmente está manejando tráfico?

Esa es la diferencia entre un reemplazo de alias y una migración de DeepSeek V4 fiable.

Datos de origen que debes fijar antes de editar el código

Antes de cambiar las cadenas de modelo, guarda una breve nota de migración con la fecha de origen y las páginas exactas que revisaste. Para esta actualización, los datos de origen son:

No pegue números de precios en la documentación de la aplicación sin una marca de tiempo. La página actual de precios de DeepSeek muestra los precios por 1M tokens, separa los tokens de entrada con acierto de caché, los tokens de entrada sin acierto de caché y los tokens de salida, y señala ventanas de pico y fuera de pico. Eso es motivo suficiente para comprobar los precios en vivo en el momento del despliegue en lugar de confiar en una estimación estática dentro del script de migración.

Enrutamiento directo de DeepSeek frente a Flatkey

Una migración de DeepSeek V4 puede ser directa, enrutada a través de Flatkey, o ambas durante las pruebas.

Flatkey es útil cuando el problema operativo es mayor que una sola ruta de DeepSeek: claves de proveedor dispersas, ediciones repetidas del SDK, coste por solicitud poco claro y decisiones de respaldo difíciles de auditar. Pero un gateway no elimina la necesidad de demostrar el ID del modelo. Pruebe siempre la fila exacta del modelo a la que llamará su cuenta.

Lista de verificación de migración de DeepSeek V4

Use esta lista de verificación antes de sustituir alias en producción.

1. Congela la fecha de origen. Registra la fecha en que revisaste la documentación de DeepSeek, la documentación de Flatkey, el directorio de modelos de Flatkey, los precios y el estado de la ruta. Para esta actualización del artículo, esa fecha es el 16 de septiembre de 2026.
2. Busca en toda la pila. Busca deepseek-v4-flash, deepseek-v4-flash-vision-exp, deepseek-flash, deepseek-v4-pro y documentación antigua que indique a los desarrolladores copiar un valor obsoleto.
3. Clasifica cada coincidencia. Separa el código de producción, las configuraciones de staging, los trabajos de evaluación, las políticas del enrutador de prompts, la documentación para clientes, las macros de soporte, los notebooks, los fixtures de CI y los ejemplos.
4. Sustituye los alias de Flash obsoletos. Migra deepseek-v4-flash y deepseek-v4-flash-vision-exp a deepseek-flash solo después de tener una ruta de prueba y un plan de reversión.
5. Mantén Pro explícito. No migres silenciosamente las cargas de trabajo de deepseek-v4-pro a Flash. Si Pro sigue en uso, marca el propietario, el motivo, la fecha de revisión y el modelo de respaldo.
6. Haz explícito el modo de razonamiento. La documentación de DeepSeek indica que el modo de razonamiento está habilitado por defecto con esfuerzo predeterminado high. Si necesitas un comportamiento sin razonamiento, configúralo y pruébalo de forma deliberada.
7. Prueba la entrada de imágenes si usaste el alias de visión. Para las cargas de trabajo que usaron deepseek-v4-flash-vision-exp, ejecuta pruebas de entrada de imágenes a través de la ruta que realmente vas a publicar.
8. Prueba la API de Responses por separado. La compatibilidad de la API de Responses de DeepSeek incluye campos compatibles, parcialmente compatibles, ignorados y no compatibles. No infieras el comportamiento solo a partir de Chat Completions.
9. Ejecuta pruebas de llamadas a herramientas y de salida estructurada. Valida esquemas de herramientas, argumentos de funciones, análisis de JSON, reintentos y comportamiento en múltiples turnos.
10. Comprueba el streaming y el uso. Confirma la forma de los fragmentos, el manejo de timeouts, el uso final, los recuentos de tokens y los campos de facturación en los registros directos del proveedor o en los registros de uso de Flatkey.
11. Actualiza la documentación y los ejemplos. Elimina fragmentos obsoletos que volverían a introducir alias deprecados durante el siguiente onboarding o corrección de errores.
12. Despliega detrás de la configuración. Coloca el modelo de destino en una variable de entorno o en una tabla de enrutamiento. Evita literales codificados dentro de la lógica de negocio.
13. Vigila el primer segmento de producción. Empieza con tráfico de bajo riesgo, compara la tasa de salida aceptada y el coste por respuesta aceptada, y luego aumenta solo después de que los registros estén limpios.

Plantilla de auditoría de alias que se puede copiar

Usa esta plantilla como un registro breve de migración. Guárdala en tu repositorio, en el sistema de seguimiento de incidencias o en el runbook para que futuras correcciones sepan por qué cambió el alias.

deepseek_v4_migration:
  checked_at_utc: "2026-09-16T00:00:00Z"
  source_pages:
    - "https://api-docs.deepseek.com/"
    - "https://api-docs.deepseek.com/quick_start/pricing"
    - "https://api-docs.deepseek.com/news/news260910"
    - "https://api-docs.deepseek.com/guides/thinking_mode"
    - "https://api-docs.deepseek.com/guides/responses_api"
    - "https://docs.flatkey.ai/quickstart.md"
    - "https://docs.flatkey.ai/guides/openai-sdk.md"
  replacements:
    - from: "deepseek-v4-flash"
      to: "deepseek-flash"
      reason: "alias legado de Flash; la ruta la sirve V4.1 Flash por compatibilidad"
      owner: "engineering"
      status: "test_before_merge"
    - from: "deepseek-v4-flash-vision-exp"
      to: "deepseek-flash"
      reason: "alias legado del experimento de visión; verifica el comportamiento de entrada de imágenes"
      owner: "engineering"
      status: "test_before_merge"
  intentionally_kept:
    - model: "deepseek-v4-pro"
      reason: "La ruta Pro sigue evaluándose de forma intencionada"
      next_review_date: "2026-09-30"
  required_tests:
    - plain_chat
    - thinking_enabled
    - thinking_disabled_if_used
    - responses_api
    - image_input_if_used
    - tool_calls
    - json_output
    - streaming
    - usage_log_readback
    - rollback

Patrón de configuración de Flatkey

La configuración más segura de Flatkey mantiene la selección del modelo específica del proveedor en la configuración, mientras que la superficie del cliente compatible con OpenAI permanece estable.

FLATKEY_API_KEY="sk-your-flatkey-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_DEEPSEEK_MODEL="deepseek-flash"

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-flash"),
    messages=[
        {
            "role": "user",
            "content": "Devuelve una sola frase confirmando que la ruta de DeepSeek está activa.",
        }
    ],
    stream=False,
)

print(response.choices[0].message.content)
print(response.usage)

Después de la solicitud, abre los registros de uso de Flatkey y verifica el nombre del modelo, los recuentos de tokens, la latencia, el coste, la clave, la marca temporal y el estado del error. Si el registro no coincide con la solicitud que enviaste, la migración no está completa.

Matriz de pruebas antes del cambio

Errores comunes

• Tratar la migración de DeepSeek V4 como un reemplazo ciego de texto sin revisar la documentación actual de DeepSeek.
• Reemplazar deepseek-v4-flash-vision-exp por deepseek-flash pero nunca probar la entrada de imágenes.
• Asumir que deepseek-v4-pro se desactivó después del 14 de septiembre de 2026 cuando la documentación actual dice que el servicio continúa.
• Actualizar el código de la aplicación pero dejar alias obsoletos en trabajos de evaluación, notebooks, fragmentos de clientes o políticas de fallback.
• Comparar solo los precios de tokens en titulares en lugar del coste por respuesta aceptada.
• Asumir que el comportamiento directo de DeepSeek y el comportamiento enrutado por Flatkey son idénticos sin comprobar la ruta en vivo y los registros.
• Permitir que parámetros no compatibles de la API de Responses cambien silenciosamente el comportamiento del producto.

Enlaces internos para el siguiente paso

Si todavía estás eligiendo rutas de DeepSeek, combina esta lista de verificación con DeepSeek V4 Pro vs Flash y comprobaciones de enrutamiento de API de DeepSeek vs Qwen. Si el proyecto más amplio es la estandarización de la puerta de enlace, lee la guía de inicio rápido de la API de Flatkey, la guía del catálogo de modelos de IA y métricas de API de enrutamiento de IA. Para decisiones de proveedores sensibles a la región, usa enrutamiento regional de proveedores de LLM.

Preguntas frecuentes

¿Cuál es el nombre actual del modelo DeepSeek Flash?

El nombre actual del modelo Flash en la documentación de DeepSeek es deepseek-flash. Una migración segura de DeepSeek V4 debería mover los alias obsoletos de Flash hacia esa cadena de modelo después de probar la ruta.

¿deepseek-v4-flash y deepseek-v4-flash-vision-exp están rotos?

DeepSeek dice que esos nombres heredados todavía se aceptan, pero sus modelos correspondientes ya se han retirado y las solicitudes se atienden mediante DeepSeek-V4.1-Flash. Esa compatibilidad es útil durante la migración, pero el nuevo código debería evitar depender de alias retirados.

¿deepseek-v4-pro dejó de funcionar después del 14 de septiembre de 2026?

No. La documentación actual de DeepSeek dice que el servicio de API para deepseek-v4-pro continúa después del 14 de septiembre de 2026, con el método de facturación sin cambios salvo que DeepSeek proporcione un aviso adicional. Mantenlo explícito y monitorizado si lo usas.

¿Necesito cambiar la URL base de DeepSeek?

No para una llamada directa de DeepSeek con formato OpenAI. DeepSeek documenta https://api.deepseek.com como la URL base con formato OpenAI. Para Flatkey, usa https://router.flatkey.ai/v1 con una clave de API de Flatkey.

¿Flatkey reemplaza las pruebas de rutas específicas del proveedor?

No. Flatkey puede centralizar la clave, la URL base, el catálogo y la revisión de uso, pero tu equipo aún necesita verificar la fila exacta del modelo, el comportamiento de las funciones, los campos de coste, el estado de la ruta y el plan de respaldo.

¿Debería cada carga de trabajo pasar a deepseek-flash?

No. deepseek-flash es el objetivo actual de Flash, pero las cargas de trabajo que usan intencionalmente deepseek-v4-pro deben probarse y rastrearse por separado. Elige por carga de trabajo, no por una regla global de reemplazo.

Consejo final para el despliegue

Lista de verificación de migración de DeepSeek V4: sustituye de forma segura los alias obsoletos debe terminar con evidencia, no solo con un diff fusionado. Sustituye los alias obsoletos de Flash, mantén intencionales las rutas Pro, prueba las funciones que realmente usa tu producto y verifica la solicitud en los registros. Luego consulta el actual directorio de modelos de Flatkey y la página de precios de Flatkey antes de mover el tráfico de producción.