# API DeepSeek v4 Полная справка API для LLM-моделей DeepSeek v4 на базе DeepSeek. ## Обновления модели ### DeepSeek v4 Pro 0813 - Flaq AI обновила DeepSeek v4 Pro до официального релиза DeepSeek `deepseek-v4-pro-0813`. - Используйте указанные ниже идентификаторы моделей `0813`, чтобы получить доступ к официальной версии. - Исходные идентификаторы моделей Pro недоступны. | Вариант | ID модели 0813 | Недоступный ID модели | |---------|---------------|----------------------| | Текст в текст | `deepseek-v4-pro-text-to-text-0813` | `deepseek-v4-pro-text-to-text` | | Веб-поиск | `deepseek-v4-pro-web-search-0813` | `deepseek-v4-pro-web-search` | ### DeepSeek v4 Flash 0731 - Flaq AI обновила DeepSeek v4 Flash до официального релиза DeepSeek `deepseek-v4-flash-0731`. - Используйте указанные ниже идентификаторы моделей `0731`, чтобы получить доступ к обновленной версии. - Исходные идентификаторы моделей Flash недоступны. | Вариант | ID модели 0731 | Недоступный ID модели | |---------|---------------|-------------------| | Текст в текст | `deepseek-v4-flash-text-to-text-0731` | `deepseek-v4-flash-text-to-text` | | Веб-поиск | `deepseek-v4-flash-web-search-0731` | `deepseek-v4-flash-web-search` | ## Варианты моделей Этот API поддерживает четыре варианта модели DeepSeek v4: | Модель | ID | Описание | |-------|----|-------------| | **DeepSeek v4 Pro Text to Text** | `deepseek-v4-pro-text-to-text-0813` | Высококачественное текстовое рассуждение и письмо | | **DeepSeek v4 Flash Text to Text** | `deepseek-v4-flash-text-to-text-0731` | Более быстрая и доступная генерация текста | | **DeepSeek v4 Pro Web Search** | `deepseek-v4-pro-web-search-0813` | Ответы с учетом веба и рассуждением DeepSeek v4 Pro | | **DeepSeek v4 Flash Web Search** | `deepseek-v4-flash-web-search-0731` | Более быстрые ответы с учетом веба на DeepSeek v4 Flash | ## Краткое сравнение | Функция | Pro Text to Text | Flash Text to Text | Pro Web Search | Flash Web Search | |---------|------------------|------------|----------------|------------------| | Текстовый ввод | Обязателен ✅ | Обязателен ✅ | Обязателен ✅ | Обязателен ✅ | | Ввод изображения | Не поддерживается ❌ | Не поддерживается ❌ | Не поддерживается ❌ | Не поддерживается ❌ | | Ввод файла | Не поддерживается ❌ | Не поддерживается ❌ | Не поддерживается ❌ | Не поддерживается ❌ | | Web search | Не поддерживается ❌ | Не поддерживается ❌ | Включен ✅ | Включен ✅ | | Streaming-ответ | SSE | SSE | SSE | SSE | | `max_tokens` | Необязательно | Необязательно | Необязательно | Необязательно | | `top_p` | Необязательно | Необязательно | Необязательно | Необязательно | | `top_k` | Необязательно | Необязательно | Необязательно | Необязательно | ## DeepSeek v4 Pro Text to Text ### Конечная точка ```http POST /api/v1/chat/completions ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model` | string | Должно быть `"deepseek-v4-pro-text-to-text-0813"` | | `messages` | array | Упорядоченные сообщения только с текстом. Поддерживает роли `system`, `user` и `assistant`. См. LLM API для структуры сообщения. | | `stream` | boolean | `true` для SSE, `false` для одного JSON-ответа. | #### Поддержка сообщений | Поле | Текст | Файл | Изображение | |-------|------|------|-------| | `messages` | Обязательно ✅ | Не поддерживается ❌ | Не поддерживается ❌ | #### Необязательные | Параметр | Тип | Диапазон | Описание | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Максимальное число выходных токенов. | | `top_p` | number | `0.0` - `1.0` | Ограничивает накопленную массу вероятности для candidate tokens. | | `top_k` | integer | `0` - `100` | Ограничивает количество candidate tokens. | ### Пример запроса ```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 ### Конечная точка ```http POST /api/v1/chat/completions ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model` | string | Должно быть `"deepseek-v4-flash-text-to-text-0731"` | | `messages` | array | Упорядоченные сообщения только с текстом. Поддерживает роли `system`, `user` и `assistant`. См. LLM API для структуры сообщения. | | `stream` | boolean | `true` для SSE, `false` для одного JSON-ответа. | #### Поддержка сообщений | Поле | Текст | Файл | Изображение | |-------|------|------|-------| | `messages` | Обязательно ✅ | Не поддерживается ❌ | Не поддерживается ❌ | #### Необязательные | Параметр | Тип | Диапазон | Описание | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Максимальное число выходных токенов. | | `top_p` | number | `0.0` - `1.0` | Ограничивает накопленную массу вероятности для candidate tokens. | | `top_k` | integer | `0` - `100` | Ограничивает количество candidate tokens. | ### Пример запроса ```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 ### Конечная точка ```http POST /api/v1/chat/completions ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model` | string | Должно быть `"deepseek-v4-pro-web-search-0813"` | | `messages` | array | Упорядоченные сообщения только с текстом. Поддерживает роли `system`, `user` и `assistant`. См. LLM API для структуры сообщения. | | `stream` | boolean | `true` для SSE, `false` для одного JSON-ответа. | #### Поддержка сообщений | Поле | Текст | Файл | Изображение | |-------|------|------|-------| | `messages` | Обязательно ✅ | Не поддерживается ❌ | Не поддерживается ❌ | #### Необязательные | Параметр | Тип | Диапазон | Описание | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Максимальное число выходных токенов. | | `top_p` | number | `0.0` - `1.0` | Ограничивает накопленную массу вероятности для candidate tokens. | | `top_k` | integer | `0` - `100` | Ограничивает количество candidate tokens. | ### Пример запроса ```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 ### Конечная точка ```http POST /api/v1/chat/completions ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model` | string | Должно быть `"deepseek-v4-flash-web-search-0731"` | | `messages` | array | Упорядоченные сообщения только с текстом. Поддерживает роли `system`, `user` и `assistant`. См. LLM API для структуры сообщения. | | `stream` | boolean | `true` для SSE, `false` для одного JSON-ответа. | #### Поддержка сообщений | Поле | Текст | Файл | Изображение | |-------|------|------|-------| | `messages` | Обязательно ✅ | Не поддерживается ❌ | Не поддерживается ❌ | #### Необязательные | Параметр | Тип | Диапазон | Описание | |-----------|------|-------|-------------| | `max_tokens` | integer | `> 0` | Максимальное число выходных токенов. | | `top_p` | number | `0.0` - `1.0` | Ограничивает накопленную массу вероятности для candidate tokens. | | `top_k` | integer | `0` - `100` | Ограничивает количество candidate tokens. | ### Пример запроса ```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 }) }); ``` ## Формат ответа Модели DeepSeek V4 LLM возвращают ответы completion, совместимые с OpenAI. При `stream: true` ответ передаётся в формате Server-Sent Events; при `stream: false` ответ представляет собой один JSON-объект. ### Ответ с ошибкой ```json { "error": { "code": "1001", "param": null, "message": "Authorization is empty", "type": "invalid_request_error" } } ``` ## Лучшие практики 1. **Выберите правильный вариант:** Используйте модели Pro для более качественного рассуждения и модели Flash для workloads с меньшей задержкой и меньшей стоимостью. 2. **Используйте Web Search для текущих событий:** Выбирайте Pro или Flash Web Search, когда ответ зависит от актуальной онлайн-информации. 3. **Осторожно настраивайте параметры sampling:** `top_p` и `top_k` поддерживаются во всех вариантах DeepSeek v4 и могут менять разнообразие вывода. 4. **Отправляйте только поддерживаемые входные данные:** Не отправляйте части файлов или изображений ни в один маршрут DeepSeek v4. 5. **Сопоставляйте Accept с режимом stream:** Используйте `Accept: text/event-stream` для streaming-запросов и `Accept: application/json` для non-streaming запросов.