# API DeepSeek v4 Referencia completa de API para modelos LLM DeepSeek v4 impulsados por DeepSeek. ## Actualizaciones del modelo ### DeepSeek v4 Pro 0813 - Flaq AI ha actualizado DeepSeek v4 Pro a la versión oficial `deepseek-v4-pro-0813` de DeepSeek. - Usa los ID de modelo `0813` que aparecen a continuación para acceder a la versión oficial. - Los ID originales de los modelos Pro no están disponibles. | Variante | ID del modelo 0813 | ID del modelo no disponible | |----------|--------------------|------------------------------| | Texto a texto | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Búsqueda web | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI ha actualizado DeepSeek v4 Flash a la versión oficial de DeepSeek `deepseek-v4-flash-0731`. - Usa los ID de modelo `0731` que aparecen a continuación para acceder a la versión actualizada. - Los ID originales de los modelos Flash no están disponibles. | Variante | ID del modelo 0731 | ID del modelo no disponible | |----------|--------------------|------------------------------| | Texto a texto | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Búsqueda web | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Variantes de modelo Esta API admite cuatro variantes del modelo DeepSeek v4: | Modelo | ID | Descripción | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Razonamiento y escritura de texto de alta calidad | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Generación de texto más rápida y asequible | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Respuestas conscientes de la web con razonamiento DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Respuestas conscientes de la web más rápidas con DeepSeek v4 Flash | ## Comparación rápida | Función | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Entrada de texto | Obligatoria ✅ | Obligatoria ✅ | Obligatoria ✅ | Obligatoria ✅ | | Entrada de imagen | No admitida ❌ | No admitida ❌ | No admitida ❌ | No admitida ❌ | | Entrada de archivo | No admitida ❌ | No admitida ❌ | No admitida ❌ | No admitida ❌ | | Búsqueda web | No admitida ❌ | No admitida ❌ | Activada ✅ | Activada ✅ | | Respuesta en streaming | SSE | SSE | SSE | SSE | | `max_tokens` | Opcional | Opcional | Opcional | Opcional | | `top_p` | Opcional | Opcional | Opcional | Opcional | | `top_k` | Opcional | Opcional | Opcional | Opcional | ## DeepSeek v4 Pro Text to Text ### Punto de conexión ```http POST /api/v1/chat/completions ``` ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model` | string | Debe ser `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Mensajes ordenados solo de texto. Admite roles `system`, `user` y `assistant`. Consulta la API LLM para la estructura del mensaje. | | `stream` | boolean | `true` para SSE, `false` para una única respuesta JSON. | #### Compatibilidad de mensajes | Campo | Texto | Archivo | Imagen | |-------|------|------|-------| | `messages` | Obligatorio ✅ | No admitido ❌ | No admitido ❌ | #### Opcionales | Parámetro | Tipo | Rango | Descripción | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens máximos de salida. | | `top_p` | number | `0.0` - `1.0` | Limita la masa de probabilidad acumulada para tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita el número de tokens candidatos. | ### Solicitud de ejemplo ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-text-to-text-0813', messages: [ { role: 'user', content: 'Hello' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Text to Text ### Punto de conexión ```http POST /api/v1/chat/completions ``` ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model` | string | Debe ser `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Mensajes ordenados solo de texto. Admite roles `system`, `user` y `assistant`. Consulta la API LLM para la estructura del mensaje. | | `stream` | boolean | `true` para SSE, `false` para una única respuesta JSON. | #### Compatibilidad de mensajes | Campo | Texto | Archivo | Imagen | |-------|------|------|-------| | `messages` | Obligatorio ✅ | No admitido ❌ | No admitido ❌ | #### Opcionales | Parámetro | Tipo | Rango | Descripción | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens máximos de salida. | | `top_p` | number | `0.0` - `1.0` | Limita la masa de probabilidad acumulada para tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita el número de tokens candidatos. | ### Solicitud de ejemplo ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-text-to-text-0731', messages: [ { role: 'user', content: 'Write a four-line modern poem about a programmer drinking coffee.' } ], stream: false, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Pro Web Search ### Punto de conexión ```http POST /api/v1/chat/completions ``` ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model` | string | Debe ser `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Mensajes ordenados solo de texto. Admite roles `system`, `user` y `assistant`. Consulta la API LLM para la estructura del mensaje. | | `stream` | boolean | `true` para SSE, `false` para una única respuesta JSON. | #### Compatibilidad de mensajes | Campo | Texto | Archivo | Imagen | |-------|------|------|-------| | `messages` | Obligatorio ✅ | No admitido ❌ | No admitido ❌ | #### Opcionales | Parámetro | Tipo | Rango | Descripción | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens máximos de salida. | | `top_p` | number | `0.0` - `1.0` | Limita la masa de probabilidad acumulada para tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita el número de tokens candidatos. | ### Solicitud de ejemplo ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-pro-web-search-0813', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## DeepSeek v4 Flash Web Search ### Punto de conexión ```http POST /api/v1/chat/completions ``` ### Parámetros de solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model` | string | Debe ser `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Mensajes ordenados solo de texto. Admite roles `system`, `user` y `assistant`. Consulta la API LLM para la estructura del mensaje. | | `stream` | boolean | `true` para SSE, `false` para una única respuesta JSON. | #### Compatibilidad de mensajes | Campo | Texto | Archivo | Imagen | |-------|------|------|-------| | `messages` | Obligatorio ✅ | No admitido ❌ | No admitido ❌ | #### Opcionales | Parámetro | Tipo | Rango | Descripción | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Tokens máximos de salida. | | `top_p` | number | `0.0` - `1.0` | Limita la masa de probabilidad acumulada para tokens candidatos. | | `top_k` | integer | `0` - `100` | Limita el número de tokens candidatos. | ### Solicitud de ejemplo ```javascript const response = await fetch('https://api.flaq.ai/api/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Accept': 'text/event-stream', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'deepseek-v4-flash-web-search-0731', messages: [ { role: 'user', content: 'What date is it today?' } ], stream: true, max_tokens: 500, top_p: 0.5, top_k: 1 }) }); ``` ## Formato de respuesta Los modelos LLM DeepSeek V4 devuelven respuestas de finalización compatibles con OpenAI. Con `stream: true`, la respuesta se transmite mediante eventos enviados por el servidor (SSE); con `stream: false`, se devuelve como un único objeto JSON. ### Respuesta de error ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Buenas prácticas 1. **Elige la variante adecuada:** Usa modelos Pro para razonamiento de mayor calidad y modelos Flash para cargas de menor latencia y menor coste. 2. **Usa Web Search para eventos actuales:** Elige Pro o Flash Web Search cuando la respuesta dependa de información online actualizada. 3. **Ajusta cuidadosamente los parámetros de muestreo:** `top_p` y `top_k` se admiten en todas las variantes DeepSeek v4 y pueden cambiar la diversidad de salida. 4. **Envía solo entradas admitidas:** No envíes partes de archivo o imagen a ninguna ruta DeepSeek v4. 5. **Haz coincidir Accept con el modo stream:** Usa `Accept: text/event-stream` para solicitudes en streaming y `Accept: application/json` para solicitudes sin streaming.