Как вызвать API DeepSeek V4.1 Flash: Python и curl

Для прямого вызова DeepSeek V4.1 Flash используйте model="deepseek-flash" и базовый адрес https://api.deepseek.com. Название продукта и идентификатор запроса — разные строки. У стороннего шлюза могут быть собственные ID и требования к ключам.

Примеры сверены с официальным быстрым стартом и журналом выпуска от 10 сентября 2026 года. Это проверка конфигурации по документации, а не платный сквозной тест. Выполнение запроса на генерацию может расходовать баланс.

Сначала проверьте аккаунт и модель

Получите ключ у того поставщика, к которому будете обращаться. Ключ прямого DeepSeek API используйте с адресом DeepSeek, ключ Ofox — с документированным маршрутом Ofox. Не соединяйте адрес одного поставщика с ключом другого.

Для примеров сохраните ключ в локальной переменной окружения DEEPSEEK_API_KEY. Не добавляйте его в репозиторий и не печатайте в журнал. В обзоре выпуска deepseek-flash объясняется, почему старые имена Flash могут приниматься даже после смены обслуживающей модели.

Python: начните с одного текстового ответа

Установите официальный пакет OpenAI Python в окружении проекта командой python -m pip install openai, затем используйте совместимый клиент:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Reply with one short greeting."}],
    max_tokens=128,
    extra_body={"thinking": {"type": "disabled"}},
)
print(response.choices[0].message.content)
print(response.usage)

В первом диагностическом запросе намеренно отключены рассуждения и инструменты. Он не показывает стоимость или поведение агента с рассуждениями. Когда базовый вызов заработает, добавляйте нужные возможности по одной, проверяя их параметры в документации.

curl: сравните HTTP-запрос

curl --fail-with-body https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"deepseek-flash","messages":[{"role":"user","content":"Reply with one short greeting."}],"max_tokens":128,"thinking":{"type":"disabled"}}'

JSON задаёт ту же короткую текстовую задачу. Если команда завершится ошибкой, сохраните тело ответа без секретных данных: один статус может скрывать неверный маршрут или аккаунт. Не отправляйте в поддержку подробную трассировку с заголовком авторизации.

В JavaScript соответствующая настройка OpenAI SDK называется baseURL; имя модели и поля JSON остаются теми же. Следуйте интерфейсу установленной версии SDK, не перенося имена аргументов Python механически.

Сопоставьте клиент и протокол

Полные требования описаны в руководствах по Codex и Claude Code. Один текстовый ответ не подтверждает корректность цикла инструментов, визуального ввода или обработки потока.

Модель не найдена или запрос завершился ошибкой

Сначала проверьте адрес назначения, затем точный идентификатор. В устаревшем каталоге клиента может не быть deepseek-flash; шлюз может использовать другое имя. Временная конфигурация expires-on-0910 не является контрактом официальной модели. Сохраните реальный ответ, не предполагая одинаковый код ошибки неизвестной модели у всех поставщиков.

Справочник ошибок DeepSeek различает 401 — аутентификация, 402 — недостаточный баланс, 400 — формат запроса, 422 — параметры и 429 — ограничение частоты. Пополнение помогает при подтверждённой нехватке средств, но не исправляет неверное тело запроса или неподдерживаемое имя. Повторяйте временно неудачные запросы с контролем частоты и числа попыток.

До пополнения для пакетной нагрузки используйте расчёт цен и бюджета. Выбирая Ofox, проверьте каталог моделей и руководство по аутентификации; регистрируйтесь, понимая нужный маршрут и условия оплаты. Пример прямого API не означает, что настройки шлюза полностью совпадают.

Прежде чем пополнять баланс у поставщика, проверьте модель, протокол и условия оплаты по списку проверок перед покупкой API.