DeepSeek V4 es la nueva generación de modelos de DeepSeek, centrada en chino, código y una buena relación entre precio y rendimiento. Muchos equipos la usan para atención al cliente, contenido, código y análisis de datos.

Esta guía explica cómo obtener y llamar a la API de DeepSeek V4, y qué vigilar durante la migración desde un modelo anterior.

Nota: DeepSeek es una marca registrada de su propietario. Este artículo refleja las versiones comunes a octubre de 2026; los nombres de modelo y los precios siguen la página de precios de modelos.

1. Para qué sirve DeepSeek V4

  • Preguntas y respuestas, atención al cliente y bases de conocimiento en chino.
  • Generación, explicación y revisión de código.
  • Resúmenes de documentos largos y extracción estructurada.
  • Nodos de razonamiento dentro de agentes y flujos de trabajo.
  • Procesamiento de contenido por lotes.

La familia de modelos es una buena opción por defecto para equipos que necesitan una salida sólida en chino y asistencia de código a un precio predecible. Como con cualquier modelo, la elección correcta depende de la tarea: una solicitud corta de clasificación y una cadena de razonamiento larga imponen exigencias muy distintas al modelo.

Las variantes dentro de una familia suelen diferir en longitud de contexto, velocidad y precio. Ajusta la variante al trabajo. Un modelo rápido y más económico suele bastar para clasificación de alto volumen, respuestas cortas y extracción, mientras que la variante más grande es mejor para razonamiento de varios pasos, revisión de código y documentos largos. Esta sola decisión suele afectar el costo más que la microoptimización de prompts.

2. Cómo obtener una clave

DeepSeek oficial

Regístrate en la plataforma abierta de DeepSeek, crea una clave y recarga. Esta ruta conviene a equipos que pueden usar la plataforma oficial directamente.

ZSQH AI Gateway

  1. Regístrate en ZSQH AI Gateway.
  2. Crea una clave y fija una cuota.
  3. Recarga la cuenta.
  4. Llama a la API con el SDK de OpenAI.

Usar un gateway mantiene la integración estable cuando añades otros modelos más adelante. La misma clave puede servir a varias familias de modelos y el uso aparece en una sola vista de facturación.

3. Base URL y nombres de modelo

La dirección compatible con OpenAI del gateway es:

https://ai.zhongshangqihang.com/v1

Los nombres de modelo siguen la página de precios. Las formas comunes incluyen deepseek-v4 y deepseek-chat. No copies nombres de modelo de una guía antigua sin comprobarlos, porque un nombre retirado puede devolver un 404 incluso cuando el resto de la solicitud es correcto.

4. Prueba con curl

export DEEPSEEK_API_KEY="sk-your-key"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4",
    "messages": [{"role": "user", "content": "Reply with OK only"}]
  }'

Ejecuta esto antes de escribir el código de la aplicación. Separa los problemas de autenticación, endpoint y nombre de modelo de los de tu propia lógica.

5. Llamada en Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "Write a Python example that reads a CSV file"}],
)
print(resp.choices[0].message.content)

Mantén la Base URL y el nombre del modelo en un único archivo de configuración, y defínelos por entorno en lugar de codificarlos en todo el código base. Así una migración de modelo se convierte en un cambio de configuración y no en una búsqueda y reemplazo, y evitas que una clave de pruebas llegue accidentalmente a producción.

6. Migrar desde una versión anterior

  1. Confirma el nombre del nuevo modelo y la longitud de contexto.
  2. Compara la calidad de salida con un conjunto de pruebas fijo.
  3. Comprueba si la llamada a herramientas y la salida JSON siguen siendo compatibles.
  4. Despliega de forma gradual durante 3 a 7 días.
  5. Mantén el modelo anterior disponible como respaldo.

No cambies todo de una vez. Una actualización de modelo puede modificar el estilo de salida y el soporte de parámetros, y esas diferencias pueden importar más que las puntuaciones de los benchmarks. Crea un conjunto de regresión a partir de prompts reales, incluidos los casos límite que tu equipo ya ha corregido, y puntúa el modelo antiguo y el nuevo con las mismas entradas. Durante el periodo canario, vigila la latencia, la tasa de errores, el uso de tokens por solicitud y la proporción de respuestas que requieren corrección humana. Vuelve atrás si alguna de esas métricas empeora.

7. Costo y límites de tasa

  • Los precios de tokens de entrada y salida siguen la página de precios.
  • El contexto largo amplifica el costo rápidamente.
  • En horas punta pueden limitarse las solicitudes; producción necesita reintentos y un modelo de respaldo.
  • Los trabajos por lotes deben ejecutarse de forma asíncrona o mediante una cola.

Registra el nombre del modelo con cada solicitud. Cuando una factura cambia de forma inesperada, la primera pregunta suele ser qué modelo y qué prompt produjeron el aumento, y esa respuesta es difícil de recuperar sin metadatos por solicitud. Fija un presupuesto diario por clave como red de seguridad y activa alertas ante cambios repentinos en el volumen de tokens en lugar de esperar la factura mensual.

Preguntas frecuentes

¿Cuál es la diferencia entre DeepSeek V4 y V3?

La versión, el contexto, las capacidades y el precio pueden variar. Consulta la documentación oficial del modelo y la página de precios para conocer los detalles vigentes.

¿Puede una misma clave llamar también a Claude?

En un gateway, una clave puede llamar a varios modelos habilitados. Una clave oficial de DeepSeek solo puede llamar a modelos DeepSeek.

¿Por qué recibo un 404?

Las causas más comunes son un nombre de modelo obsoleto o una Base URL incorrecta. Comprueba primero los nombres de modelo en la página de precios.

Próximos pasos

Si necesitas acceso estable desde China continental o un punto de entrada unificado para varios modelos, puedes registrarte en ZSQH AI Gateway, ejecutar una prueba pequeña y luego migrar. Los nombres de modelo y los precios aparecen en la página de precios de modelos.

Lecturas relacionadas: