Документация DeepSeek API на русском
Справочник по официальному API DeepSeek: адреса и авторизация, модели, параметры запроса, режим рассуждений, цены, стриминг и лимиты. Всё сверено с api-docs.deepseek.com 9 октября 2026 года — без устаревших названий моделей и без пересказа маркетинга.
Начните с раздела «Быстрый старт»: там три шага от ключа до разобранного ответа. Если нужно понять, за что именно списываются деньги, откройте «Цены и расчёт».
Что нужно знать до первого запроса
- В API два актуальных имени модели:
deepseek-flashиdeepseek-v4-pro. Имена устаревших моделейdeepseek-chatиdeepseek-reasonerотключены 24 июля 2026 года. - Режим рассуждений (thinking) включён по умолчанию,
reasoning_effortпо умолчаниюhigh. Отключается параметром{"thinking": {"type": "disabled"}}. - Контекстный кэш работает всегда и включать его не нужно: повторяющееся начало запроса тарифицируется в десятки раз дешевле.
- Формат запросов совместим с OpenAI Chat Completions, поэтому существующий код переносится заменой
base_urlи имени модели.
Адреса и авторизация
| Назначение | Адрес |
|---|---|
| OpenAI-совместимый base URL | https://api.deepseek.com |
| Chat Completions | POST https://api.deepseek.com/chat/completions |
| Anthropic-совместимый API | https://api.deepseek.com/anthropic, сообщения — POST /anthropic/v1/messages |
| Responses API | POST https://api.deepseek.com/responses |
| Beta-функции: FIM, prefix completion, strict tools | base URL https://api.deepseek.com/beta |
| Служебные эндпоинты | GET /models, GET /user/balance, POST /files, GET /files, GET /files/{id}, DELETE /files/{id} |
Авторизация — заголовок Authorization: Bearer ${DEEPSEEK_API_KEY}. В Anthropic-формате ключ можно передавать и через x-api-key.
POST /chat/completions HTTP/1.1
Host: api.deepseek.com
Content-Type: application/json
Authorization: Bearer ${DEEPSEEK_API_KEY}
{
"model": "deepseek-flash",
"messages": [
{"role": "user", "content": "Привет!"}
]
}Нужен API-ключ сегодня
Регистрация по email или Telegram занимает пару минут, оплата идёт в рублях, VPN не нужен. Один ключ работает и с DeepSeek, и с другими моделями.
Разделы справочника
Быстрый старт
Ключ, первый запрос через cURL и Python, разбор полей ответа и три ошибки, которые случаются чаще всего: 401, 402 и 422.
Открыть раздел →Модели и параметры
Две модели, контекст 1M токенов, вывод до 384K, поддерживаемые возможности и полная таблица параметров Chat Completions.
Открыть раздел →Цены и расчёт
Прайс за 1M токенов, часы пик и вне пика, кэш ввода и три примера расчёта стоимости с арифметикой.
Открыть раздел →Режим рассуждений
Как работает thinking, чем управляет reasoning_effort, где искать reasoning_content и что ломается при включённых рассуждениях.
JSON и инструменты
Режим json_object, описание функций, tool_choice и правило возврата reasoning_content в историю диалога.
Стриминг и токены
Потоковая выдача через SSE, stream_options.include_usage, ориентиры по токенам и офлайн-токенизатор.
Ошибки и лимиты
Коды 400, 401, 402, 422, 429, 500 и 503, лимиты одновременных запросов, keep-alive и лимиты Vision и Files API.
Открыть раздел →Примеры кода
Готовые скрипты на Python, cURL, PHP и Go, а также вариант подключения через агрегатор с оплатой в рублях.
Перейти к примерам →Страница цен и changelog публикуют для deepseek-v4-pro отдельные цены и лимиты, но новость от 10 сентября 2026 года сообщает о поэтапном выводе модели и маршрутизации запросов на Flash. Источники расходятся — уточняйте на странице цен DeepSeek.
Внешние источники
- Официальная документация DeepSeek API — первоисточник по эндпоинтам и параметрам.
- Страница цен DeepSeek — актуальный прайс и правила тарификации.
- Token & Token Usage — ориентиры по токенам и калькулятор.
Нужен API-ключ сегодня
Регистрация по email или Telegram занимает пару минут, оплата идёт в рублях, VPN не нужен. Один ключ работает и с DeepSeek, и с другими моделями.
Читайте также
- Быстрый старт Три шага до первого ответа модели: ключ, запрос, разбор JSON.
- Модели и параметры Какие модели доступны, чем отличаются и какие поля понимает Chat Completions.
- Цены и расчёт стоимости Прайс за 1M токенов, часы пик, кэш ввода и примеры расчёта.
- Пример на Python Рабочий код с библиотекой openai: запрос, стриминг, отключение рассуждений.