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

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

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

Модели

Модель	Область применения
qwen3.8-max-0902, qwen3.8-flash, qwen3.8-max	Все поддерживают Chat, Responses, Messages; общие правила объединены, медиа см. ниже

Отличия Chat Completions

Поле	Отличие
`enable_thinking`, `reasoning_effort`	Рассуждение включено; уровни `low/medium/xhigh`, по умолчанию `xhigh`; `minimal` переходит в `low`, `high/max` в `xhigh`, `none` выключает
`thinking_budget`	Несовместимо с `reasoning_effort`, иначе ошибка; уровни `low/medium/xhigh` отдельно соответствуют бюджетам `4096/16384/262144`
`max_tokens`, `max_completion_tokens`	`max_tokens` ограничивает только ответ, запланирован к устареванию; новые интеграции — `max_completion_tokens` для общего бюджета
`temperature`	Диапазон `[0,2)`; при рассуждении текст по умолчанию `1.0`, визуальный ввод `0.6`; ниже `0.6` становится `0.6`. Без рассуждения `0.7`
`top_p`, `top_k`	`top_p`: диапазон `(0,1]`, умолчания с/без рассуждения `0.95/0.8`. Расширение `top_k` — неотрицательное целое, умолчание `20`; `null` или больше `100` выключает Top-K
`repetition_penalty`	Расширение Qwen, больше `0`, по умолчанию `1.0`; не два штрафа OpenAI
`preserve_thinking`	Включено; передавайте мысли полностью в `reasoning_content` assistant, не в `content`. Отсутствие само по себе не вызывает ошибку
`tool_choice`	Поддерживается `auto/none`; при рассуждении нельзя `required` и конкретную функцию. Без рассуждения функция разрешена, но `required` не гарантирует вызова
`tool_stream`	По умолчанию `false`; поток сложных аргументов только с `stream=true`. Max — текст, Flash — все модальности
`response_format`	Поддерживается `json_object/json_schema`; первое требует слова JSON в промпте, второе задаёт структуру через `response_format.json_schema`, без выключения рассуждения
`enable_search`, `search_options`	`enable_search` по умолчанию `false`; `search_options.forced_search` принуждает поиск; эти модели используют `turbo/max`. С `include_tool_usage=true` статистика в `usage.x_tools`

Отличия Responses

Поле	Отличие
`reasoning.effort`	Поддерживается `none/low/medium/xhigh`, по умолчанию `xhigh`; `minimal` в `low`, `high/max` в `xhigh`
`enable_thinking`	Переключатель совместимости будет удалён, рекомендуется `reasoning.effort`; при обоих приоритет `reasoning.effort`
`max_output_tokens`	Минимум `16`, рассуждение и ответ вместе
`text.format`	Поддерживается `text/json_object/json_schema`; JSON Schema внутри `text.format.json_schema` с `name/schema/strict`, не плоская структура оригинала
`tool_choice`	Поддерживается `auto/none/required` и объект `allowed_tools`; `required` только с одним инструментом в списке
`tools`	Функции и встроенные `web_search`, `web_extractor`, `code_interpreter`; извлечение страниц вместе с поиском, интерпретатор требует рассуждения
`store`, `previous_response_id`, `conversation`	Серверная история; `store` по умолчанию `true`, ID действителен `7 дней`; последние два поля взаимоисключающие
`background` и прочие расширения	Фоновой асинхронности нет; параметры OpenAI вне официальной Responses Reference игнорируются

Отличия Messages

Поле	Отличие
`thinking.type`	Поддерживается `enabled/disabled`, рассуждение включено; не конфигурация Claude `adaptive`
`output_config.effort`	Используйте `low/medium/xhigh`, по умолчанию `xhigh`; `high/max` в `xhigh`, не все соответствия Chat
`thinking.budget_tokens`	Объявлено будущее устаревание; новые интеграции `output_config.effort`. При старом бюджете `max_tokens` должен его превышать
`max_tokens`	Обязательно; Qwen3.8 ограничивает суммарные рассуждение и ответ
`temperature`, `messages[].role`	Температура `[0,2)`; кроме ролей `user/assistant` допускается `system`
`tool_result.content`	Результат инструмента строкой; объекты/массивы сериализуйте, не используйте массивы блоков Claude
`output_config.format`	Строгий JSON Schema; `type: "json_schema"`, Schema в `schema`, `additionalProperties` обязательно `false`
`web_search` в `tools`	Имя поиска `web_search`, датированный тип вроде `web_search_20250305`; HTTP / SDK также требует идентификатор `x-anthropic-billing-header: cc_entrypoint=cli;` в `system`

Отличия кеша

Поле	Отличие
Неявный кеш	Автоматически; одинаковый префикс минимум `1024 Token`, без гарантии попадания
Явный кеш Chat / Messages	Метки `cache_control: { type: "ephemeral" }` на блоках; минимум `1024 Token`, срок `5 минут` обновляется при попадании, максимум `4` меток
Расположение явного кеша	System — массив блоков; определения инструментов входят в префикс, но метки только на них игнорируются. Не копируйте другие TTL или точки кеширования
Кеш Session Responses	Header `x-dashscope-session-cache: enable` включает, по умолчанию `disable`; отключение Session не отключает автоматический неявный кеш
Использование кеша	Chat `usage.prompt_tokens_details.cached_tokens`; Responses `usage.input_tokens_details.cached_tokens`; Messages `usage.cache_read_input_tokens`, `usage.cache_creation_input_tokens`

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

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat: `image_url.url` — публичный URL / Base64 Data URL
Видео	`video_url`	Расширение Chat: `video_url.url` — URL / Base64 Data URL; `fps` на уровне блока рядом с `video_url`
Список кадров	`video`	Расширение Chat: хронологические изображения в массиве `video`, минимум `4` кадров
Изображение	`input_image`	Responses: `image_url` — строка публичного URL / полного Base64 Data URL, не вложенный объект Chat
PDF	`input_file`	Responses официально перечисляет qwen3.8-max, qwen3.8-flash; PDF через `file_url`, до `100 MB`; не параметры OCR
Изображение	`image`	Messages: `url` для `source.type=url`; `media_type`, чистый Base64 `data` для `base64`
Видео	`video`	Расширение Messages: публичный URL через `source`, либо `media_type` и чистый Base64 `data`; не нативный блок Claude

Поле	Отличие
Изображения Chat	`min_pixels/max_pixels` на блоке регулируют пиксели; при верхнеуровневом `vl_high_resolution_images=true`, `max_pixels` не действует
Размер изображения	Публичное изображение до `20 MB`, до Base64 до `20 MB`; после кодирования Data URL до `20 MB` в Chat, `32 MB` в Messages
Ограничения видео	Публичное видео до `2 GB`, строка Base64 меньше `10 MB`; анализируется изображение, без звука
Область протоколов	Не используйте аудио API Omni для этих моделей; `input_audio/input_video` Responses пока только Omni. Не переносите видеоблоки Chat / Messages в Responses

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

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

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