Перейти к содержанию
Вся документация

Справочник

POST /v1/chat/completions

Chat completions в формате OpenAI, по адресу https://nokeep.ai/v1/chat/completions. Отправьте ключ в заголовке и JSON-тело; получите chat completion целиком или поток фрагментов.

Проверено 27 октября 2026 г.

Поля запроса

ПолеОбязательноЧто делает
modelДаId модели из GET /v1/models, например deepseek-v4.1-flash-uncensored.
messagesДаОт 1 до 2 000 сообщений. Роли: system, developer, user, assistant, tool. Содержимое — строка или список частей text и image_url.
streamНетtrue для server-sent events. См. Потоковая передача.
stream_optionsНет{"include_usage": true} добавляет последний фрагмент с подсчётом.
max_tokens, max_completion_tokensНетСамый длинный ответ, рассуждения включены, но не больше самого длинного для модели. Если не задано: место, которое покрывают ваш лимит и баланс, до 8 192.
reasoning_effortНетНасколько усердно думает модель. См. Рассуждения.
tools, tool_choice, parallel_tool_callsНетСм. Вызовы инструментов.
response_formatНетСм. JSON-вывод.
temperature, top_p, top_k, min_pНетСэмплирование. См. Сэмплеры.
frequency_penalty, presence_penalty, repetition_penaltyНетКонтроль повторов.
stop, seedНетСтоп-строки и seed для более повторяемых ответов.
prompt_cache_keyНетЛюбая строка, одна и та же для одного разговора, чтобы его вызовы попадали на сервер, где начало уже в кэше. См. Кэшированный ввод.
nНетДолжно быть 1.

Какая модель что принимает

ПолеDeepSeekGLM
temperatureДаОтбрасывается
top_pДаОтбрасывается
stopДаОтбрасывается
seedДаОтбрасывается
frequency_penaltyДаОтбрасывается
presence_penaltyДаОтбрасывается
repetition_penaltyДаОтбрасывается
min_pДаОтбрасывается
top_kДаОтбрасывается
toolsДаДа
tool_choiceДаДа
parallel_tool_callsДаОтбрасывается
response_formatДаОтбрасывается
reasoning_effortДаДа
prompt_cache_keyДаОтбрасывается

Поле, которое модель не может принять, отбрасывается и называется в заголовке x-nokeep-ignored. Поле, которое не знает ни одна модель, отбрасывается так же.

Ответ

Response
{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "created": 1792972800,
  "model": "deepseek-v4.1-flash-uncensored",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "…" },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 412,
    "completion_tokens": 286,
    "total_tokens": 698,
    "nokeep_credits": 1
  }
}
  • id и model — наши. Ничего от хоста модели не передаётся.
  • message.reasoning_content содержит рассуждения, если они были.
  • message.tool_calls содержит вызовы инструментов, с finish_reason равным tool_calls.
  • usage.nokeep_credits — стоимость вызова в кредитах (1 000 — это $1).
  • usage.prompt_tokens_details.cached_tokens, если он есть, — сколько токенов промпта модель прочитала из кэша. Они тарифицируются по кэшированной цене; см. Кэшированный ввод.

Ограничения запроса

Не более 12 МБ, 2 000 сообщений и 10 изображений (только DeepSeek). Запросы, которые их превышают, отклоняются с кодом; см. Ошибки.