Introducción
DeepSeek V4 Pro es la mitad deliberada de la pareja DeepSeek V4, disponible aquí como un endpoint compatible con OpenAI en /v1/chat/completions. Lee hasta 1.048.576 tokens, razona en high por defecto y puede escribir una sola respuesta de hasta 384.000 tokens.
El esfuerzo low está para borradores rápidos. El contenido de los mensajes es solo texto, hasta 256 mensajes por solicitud; tienes hasta 128 tools, salida JSON mediante response_format y streaming SSE, y la entrada, la entrada en caché y la salida se miden por separado.
Funciones y aspectos destacados
high como punto de partida
En revisión, migraciones y seguridad es donde el razonamiento extra rinde, así que este endpoint arranca en high y deja low para los borradores. El esfuerzo se gasta como tokens de salida: cae en la misma factura y cuenta contra el mismo max_tokens que fijas, no en una tarifa aparte.
Especificación, código y tests en una solicitud
Con 1.048.576 tokens, el documento de diseño, la implementación y la batería de tests viajan juntos, y el modelo los compara en lugar de fiarse de tu resumen. Pon las restricciones invariantes en el mensaje de sistema y el material debajo, del más antiguo al más reciente, para que cada divergencia quede anclada a algo que el modelo pueda citar.
Espacio para escribir la respuesta completa
Una respuesta puede llegar a 384.000 tokens: un plan ordenado, el SQL de cada paso y las consultas que lo verifican caben en una sola respuesta. El valor por defecto de 32.768 corta sin avisar, así que dimensiona max_tokens según el entregable.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
messages | Sí | 256 turnos ordenados como máximo, solo contenido de texto. Reenvía |
reasoning_effort | No | none, low o high, high por defecto. |
stop | No | Hasta 4 secuencias, como cadena o como arreglo. La respuesta termina en cuanto el modelo escribe una de ellas, y el texto que coincide no se devuelve. mínimo 1 caracteres · mínimo 1 elementos · máximo 4 elementos |
max_tokens | No | Limita la respuesta a 384.000. El valor por defecto de 32 768 recorta un plan de migración sin devolver error. |
tools | No | Hasta 128 definiciones de funciones por solicitud. máximo 128 elementos |
parallel_tool_calls | No | true o false, true por defecto: el modelo puede pedir varias llamadas a herramientas en un mismo turno. Valor predeterminado: |
tool_choice | No | auto, none, required, o un objeto que nombre la función a llamar. |
response_format | No | Pide un objeto JSON cuando la respuesta la consume código. |
Precios
Entrada $1.32 / Salida $3.96 por 1 millón de tokens
Casos de uso
Auditoría de especificación frente a implementación
Envía en una sola solicitud el documento de diseño y el código que dice implementarlo, y pide cada divergencia ordenada por alcance del daño. Ninguna de las dos partes tiene que resumirse, así que una invariante que falta se detecta por comparación y no de memoria.
Pasadas de seguridad en high
Apunta el esfuerzo high a un flujo de autenticación o de movimiento de fondos y pide secuencias explotables, no notas de estilo. El esfuerzo extra cuesta tokens de salida; pasar por alto una escalada de privilegios cuesta mucho más.
Planificación de migraciones sobre todo un esquema
Dale al modelo todos los archivos de migración y las definiciones de tablas actuales, y pide un plan ordenado con la reversión de cada paso. El plan, el SQL y las consultas de verificación pueden volver juntos en una sola respuesta.
Guía de prompts y consejos prácticos
Escribe la prueba de aceptación en el mensaje de sistema
El esfuerzo high se desperdicia con un encargo vago. Indica qué debe contener una respuesta correcta —divergencias con referencias a archivos, una lista priorizada, una reversión por paso— antes de pegar el material, para que el modelo compruebe contra algo.
Una llamada con el esfuerzo que la tarea merece
POST https://api.spicyapi.ai/v1/chat/completions con {"model": "deepseek/v4-pro", "messages": [{"role": "system", "content": "Compare the specification against the implementation. List every divergence with file references, then rank by blast radius."}, {"role": "user", "content": "<spec>\n\n<implementation>"}], "reasoning_effort": "high", "max_tokens": 32000}. Verifica tú mismo el hallazgo mejor clasificado antes de actuar: high es más minucioso, no infalible.
Formas de solicitud que fallan
El esquema rechaza las partes image_url y de archivo, así que un cuerpo copiado de un modelo multimodal falla antes de cotizarse. Un max_tokens mayor que 384.000 no es válido, y la ventana de 1.048.576 tokens incluye el prompt de sistema y cada resultado de tool anterior.
Inicio rápido de la API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "deepseek/v4-pro/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
