Назад в блог

API и SDKИнструкция

API DeepSeek-V4-Flash: быстрый старт, длинные ответы

Первый запрос к DeepSeek-V4-Flash через OpenAI SDK, max_tokens для длинных ответов, потоковая выдача и оценка стоимости.

Автор: CheapTokens TeamОпубликовано Обновлено 3 мин чтения

Обложка: быстрый старт API DeepSeek-V4-Flash, длинные ответы и стриминг
Содержание
  1. О какой «DeepSeek Flash» речь?
  2. Шаг 1. Получите ключ
  3. Шаг 2. Отправьте первый запрос
  4. Шаг 3. Попросите длинный ответ
  5. Шаг 4. Включите стриминг
  6. Шаг 5. Оцените стоимость
  7. Когда эта модель подходит, а когда лучше другая
  8. Краткий чек-лист

Этот гайд проведёт вас от нуля до рабочего запроса к DeepSeek-V4-Flash, затем покажет, как просить длинные ответы, получать их потоком и оценивать стоимость своей нагрузки. Займёт около десяти минут.

О какой «DeepSeek Flash» речь?#

Сейчас версии легко перепутать. DeepSeek перевёл свой официальный алиас deepseek-flash на DeepSeek-V4.1-Flash-1017; способ вызова не изменился (источник: документация DeepSeek API, проверено 21 октября 2026). Этот релиз мы разбирали в статье DeepSeek-V4.1-Flash-1017 вышла.

Здесь речь о другой, конкретной модели: DeepSeek-V4-Flash, выпуск 0731, она доступна в CheapTokens под gateway id deepseek-ai/DeepSeek-V4-Flash-0731. Это не V4.1-Flash, и ничто из того, что относится к V4.1-Flash-1017 (поведение, бенчмарки, лимиты), на неё не переносится. Используйте id ровно так, как написано ниже.

Что вы получаете в CheapTokens с этой моделью:

  • контекст 380K;
  • до 32 768 токенов в одном ответе — самый длинный ответ в нашей линейке;
  • API, совместимый с OpenAI Chat Completions и Anthropic Messages;
  • один баланс на все модели, фиксированные цены по моделям и никаких пиковых часов.

Шаг 1. Получите ключ#

Создайте аккаунт, пополните баланс и создайте API-ключ в личном кабинете. Если нужна общая инструкция, начните со статьи Первый запрос к API CheapTokens.

Base URL: https://api.cheaptokens.dev/v1. Храните ключ в переменной окружения, а не в коде:

bash
export CHEAPTOKENS_API_KEY="your-key-here"

Шаг 2. Отправьте первый запрос#

Через curl:

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]
  }'

Через официальный OpenAI Python SDK меняются только base_url и ключ:

python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Explain what a token is in two sentences."}],
)

print(resp.choices[0].message.content)
print(resp.usage)

Поле usage показывает, сколько входных и выходных токенов потратил вызов — оно понадобится для оценки стоимости. Незнакомый термин? Читайте Что такое токен в ИИ.

Шаг 3. Попросите длинный ответ#

Если ответ обрывается на полуслове, обычно причина в лимите вывода, а не в том, что модель «сдалась». Задайте max_tokens явно и проверяйте finish_reason. Подробности — в статье Почему ответ ИИ обрывается на полуслове.

Потолок для этой модели — 32 768 токенов ответа:

python
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Write a detailed migration guide from REST to gRPC, with code samples."}],
    max_tokens=32768,
)

choice = resp.choices[0]
print(choice.message.content)

if choice.finish_reason == "length":
    print("Cut off by max_tokens - raise the limit or ask for the next part.")

finish_reason == "stop" — модель закончила сама; "length" — упёрлась в лимит. Помните: max_tokens лишь ограничивает ответ, платите вы за реально сгенерированные токены, а промпт вместе с ответом должен помещаться в контекст 380K.

Большой лимит полезен для длинного кода, документов, отчётов и переводов. Для коротких реплик небольшой max_tokens убережёт от сюрпризов.

Шаг 4. Включите стриминг#

С stream=True текст приходит кусками по мере генерации, так что длинный ответ появляется сразу, а не после долгого ожидания:

python
stream = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Write a long README for a small CLI tool."}],
    max_tokens=32768,
    stream=True,
)

for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Здесь используются стандартные параметры стриминга OpenAI. Про обработку ошибок и чтение итогового finish_reason из потока — в статье Потоковые ответы в Python.

Шаг 5. Оцените стоимость#

Оплата — по мере использования с предоплаченного баланса, цена за 1M токенов отдельно для входа и выхода. Текущие цены MiniMax-M2.7 (формат запроса тот же, id MiniMaxAI/MiniMax-M2.7): $0.05 за 1M входных токенов и $0.15 за 1M выходных.

Пример расчёта: запрос с 2 000 входных и 8 000 выходных токенов на MiniMax-M2.7 стоит $0.0013. В таблице ниже — 1 000 таких запросов по разным моделям, с колонкой для сравнения с OpenRouter:

Модель За запрос 1 000 запросов OpenRouter, 1 000 запросов
GLM-5.3-Flash $0.00036 $0.36 $0.689
DeepSeek-V4-Flash $0.00083 $0.83 $1.35
MiniMax-M2.7 $0.0013 $1.30 $10.20

2 000 входных и 8 000 выходных токенов на запрос. Цены за 1M токенов актуальны и меняются вместе с нашими тарифами; столбец OpenRouter показывает справочные цены для той же нагрузки.

Для своей нагрузки возьмите типичные usage.prompt_tokens и usage.completion_tokens из нескольких реальных вызовов и умножьте на число запросов в сутки. Шире о планировании расходов — в статье Цены DeepSeek API в 2026 году.

Когда эта модель подходит, а когда лучше другая#

DeepSeek-V4-Flash хороша, когда ответы длинные: генерация кода, отчёты, документация, переводы. В CheapTokens её выход дешевле референсной цены OpenRouter, и смешанная цена (3 входа : 1 выход) тоже ниже.

Если ответы короткие (классификация, извлечение данных, короткие ответы), присмотритесь к GLM-5.3-Flash: у неё контекст 390K и ответ до 8 192 токенов; цены обеих моделей сравните в таблице выше. Переключиться просто: замените id модели на zai-org/GLM-5.3-Flash, а баланс остаётся один на обе модели. Не уверены, что выбрать? Смотрите GLM vs DeepSeek vs MiniMax.

Краткий чек-лист#

  • Base URL: https://api.cheaptokens.dev/v1; модель: deepseek-ai/DeepSeek-V4-Flash-0731.
  • Задайте max_tokens (до 32 768) и проверяйте finish_reason.
  • Для длинных ответов включайте stream=True.
  • Читайте usage и прикидывайте стоимость по таблице, прежде чем масштабироваться.

Готовы попробовать? Получите ключ, пополните баланс и запустите первый пример выше.