Различия параметров и протоколов DeepSeek

Узнайте об отличиях параметров и использовании DeepSeek с совместимыми протоколами.

Для DeepSeek настройте параметры по этой странице. Структуры: Chat Completions, Responses, Messages.

Модели

Модель	Область применения
deepseek-flash	Chat, Responses, Messages; изображения поддерживаются
deepseek-v4-pro	Chat, Responses, Messages; без изображений, Responses поддерживает серверный поиск

Отличия Chat Completions

Поле	Отличие
`thinking.type`	Обе по умолчанию рассуждают и принимают `enabled/disabled`
`reasoning_effort`	`none` выключает, `low/high/max` включает, по умолчанию `high`; `minimal` переходит в `low`, `medium/xhigh` в `high`, `ultra` в `max`
`temperature`	Диапазон `0～2`; при рассуждении значение игнорируется
`top_p`	Flash: при рассуждении диапазон `0.95～1`, ниже `0.95` становится `0.95`; без рассуждения фиксировано `1`. Pro: при рассуждении игнорирует ввод, с `tools` фиксировано `0.95`, иначе `1`; действует без рассуждения
`max_tokens`	DeepSeek сохраняет это поле, не устаревшее; диапазон `1～393216`. Умолчания: `8192` без рассуждения, `65536` с ним, `131072` при уровне `max`
`presence_penalty`, `frequency_penalty`	Официально устарело; без эффекта
`stop`	Строка либо массив строк; максимум `16` строк остановки
`response_format.type`	Поддерживается `text/json_object`; явно запросите JSON в промпте
`tools`, `tool_choice`	Только Function Tool; при рассуждении `required` или конкретная функция возвращает `400`. Сначала выключите рассуждение
История `reasoning_content`	При рассуждении с `tools` передавайте все мысли assistant, даже в турах без вызова; без `tools` старое рассуждение игнорируется
`stream_options.include_usage`	Только с `stream: true`. Последний блок всегда содержит полное usage, без отдельного `choices: []`. При включении `usage` предыдущих блоков равно `null`
`user_id`	Расширение DeepSeek: максимум `512` символов, буквы, цифры, подчёркивания, дефисы. Изоляция пользователей, кеша и планирования; без личных данных

Отличия Responses

Поле	Отличие
`input`, `instructions`	Минимум одно поле; `instructions` станет первым system, роль `developer` трактуется как `user`
`reasoning.effort`	По умолчанию `high`, поддерживается `none/low/high/max`, преобразования как выше; `none` выключает
`temperature`, `top_p`	Значения и поведение как в таблице; различайте Flash / Pro
`previous_response_id`, `conversation`, `store`	API без состояния; значения игнорируются. Повторяйте ввод/вывод; ответ фиксирован `previous_response_id: null`, `store: false`
`text.format`	Поддерживается `text/json_object/json_schema`; JSON Schema требует `name`, `schema`
`text.verbosity`, `reasoning.summary`	Первое без эффекта, второе без сводки; прошлый reasoning только открытый `content`, не `summary/encrypted_content`
`tools`	Function Tool поддерживается; Custom Tool только `apply_patch`, иначе `400`. `web_search` только Pro, Flash игнорирует; `file_search`, `code_interpreter`, `computer_use`, `mcp` игнорируются
`tool_choice`	Поддерживается `none/auto/required` и конкретная Function Tool
`parallel_tool_calls`, `max_tool_calls`	Значения игнорируются; параллельные вызовы всегда активны, ответ `parallel_tool_calls` фиксирован `true`
`truncation`	Игнорируется, без автосокращения; превышение контекста возвращает `400`
`background`, `metadata`, `include`, `prompt`	Значения игнорируются
`service_tier`, `safety_identifier`, `context_management`, `stream_options`	Значения игнорируются

Отличия Messages

Поле	Отличие
`anthropic-version`	DeepSeek игнорирует Header и не меняет правила по дате версии Anthropic
`thinking`, `output_config.effort`	Рассуждение включено; `thinking.type` принимает `enabled/disabled`, `budget_tokens` игнорируется. Уровни `low/high/max`, по умолчанию `high`, преобразования Chat; `output_config` только `effort`
`temperature`, `top_p`	Значения и поведение как Chat; `top_k` игнорируется
`tool_choice.type`	Поддерживается `none/auto/any/tool`; `disable_parallel_tool_use` игнорируется
`metadata`	Только `user_id`, остальные поля игнорируются
`container`, `mcp_servers`, `service_tier`	Значения игнорируются
Текст и результаты инструментов	`citations` текста и `is_error` результата игнорируются; метки см. в таблице кеша
Блоки содержимого	Не поддерживаются `document`, `search_result`, `redacted_thinking`, `code_execution_tool_result`, `mcp_tool_use`, `mcp_tool_result`, `container_upload`

Отличия кеша

Поле	Отличие
Автоматический кеш префиксов	Включено автоматически; нужен полный совпадающий сохранённый префикс, а не произвольный одинаковый фрагмент
`prompt_cache_key`, `prompt_cache_retention` в Responses	Значения игнорируются, кеш управляется автоматически
`cache_control` в Messages	Метки в блоках и определениях инструментов игнорируются
Использование кеша	Chat: `usage.prompt_cache_hit_tokens`, `usage.prompt_cache_miss_tokens`; Responses: `usage.input_tokens_details.cached_tokens`

Отличия мультимедийного ввода

Изображения принимает только deepseek-flash, не deepseek-v4-pro.

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat: `image_url.url` — публичный URL / Base64 Data URL
Изображение	`input_image`	Responses: `image_url` — URL / Base64 Data URL в user / developer или выводе инструмента; изображения в system / assistant дают `400`
Изображение	`image`	Messages: `url` при `source.type=url`; `media_type`, `data` при `source.type=base64`

Поле	Отличие
`detail`	Chat в `image_url`, Responses в блоке; поддерживается `low/high/original/auto`, `low` масштабирует до `512×512`, три других значения эквивалентны
Формат и размер изображений	JPEG, PNG, GIF, WebP; максимум `32 MiB` на URL / Base64 изображение, тело `48 MiB`, включая кодирование Base64
URL изображения	Максимум `8192` символов; загрузка за `60` секунд

Примеры запросов

Замените MODEL_ID полным ID и используйте свой API Key.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Объясните в трёх пунктах, как диагностировать тайм-аут API"}],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'