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

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

Настройте мысли, инструменты, кеш Muse здесь. Структуры: Chat Completions, Responses, Messages.

Модели

Модель	Особенности использования
muse-wonder-1.0	Три протокола, мысли неотключаемы; `max` — глубина, не переключение на Muse Wonder Full
muse-spark-1.3	Тот же формат и поддержка `max`; ограничения аудио в таблице

Отличия Chat Completions

Поле	Отличие
`reasoning_effort`	Обе используют `minimal/low/medium/high/xhigh/max`, без параметра всё равно рассуждают; `none` возвращает `400`
`max_completion_tokens`	Мысли и видимый ответ делят бюджет; старый псевдоним `max_tokens` принят, не `max_output_tokens` Responses
`temperature/top_p`	Диапазоны `0～2`, `(0,1]`, оба по умолчанию `1`; оставьте их или меняйте одно. `top_p: 0` даёт `400`
`n`	Только `1`; больше `1` возвращает `400`
Несовместимые настройки	`stop`, `verbosity`, `logit_bias`, `prediction`, `modalities`, `audio`, `web_search_options` не поддерживаются; не копируйте общие примеры
Штрафы и Logprobs	`frequency_penalty/presence_penalty` не поддерживается и может дать ошибку; `logprobs: true` возвращает `400`
`tool_choice`	Только `auto`; `none`, `required`, конкретная функция дают `400`. Имя функции — максимум одна точка
`reasoning_content`	Внешний нативный API не возвращает читаемые оригинальные мысли; не храните их этим полем. Используйте Responses / Messages
`strict`	Функции и структура по умолчанию `false`; при включении каждый объект требует `additionalProperties: false`, все свойства в `required`; корень простой объект без `oneOf/allOf`

Отличия Responses

Поле	Отличие
`reasoning.effort`	Шесть уровней как Chat, без `none`; `reasoning.summary` просит сводку, не заменяющую шифрованную историю
`max_output_tokens`	Минимум `16`, мысли/ответ включены; ввод и бюджет обязаны помещаться в контекст
`include`	Запросить шифрование через `reasoning.encrypted_content`, по умолчанию отсутствует; с `store: false` передавайте все элементы без изменения шифротекста
`previous_response_id`	Продолжает сохранённые мысли/историю на сервере; выбрать это или ручной повтор, не один финальный текст
`truncation`	Только умолчание `disabled`; `auto` даёт `400`; длинной историей управляйте сами
`background/stream`	При создании нельзя оба `true`, иначе `400`; затем фоновую задачу можно опрашивать/читать потоком
`tool_choice`	Также только `auto`; `web_search`, `tool_search` для серверного поиска/поиска инструментов, недоступных в Chat
`text.format/strict`	Используйте структуру Responses; корневое `response_format`, даже принятое, не меняет формат. Строгие правила выше
Logprobs и потоковое usage	Запрос `message.output_text.logprobs` даёт `400`; финал потока содержит usage, `stream_options.include_usage` Chat не действует

Отличия Messages

Поле	Отличие
`max_tokens`	Обязательно, минимум `1`; бюджет мыслей/ответа, не имя и минимум Responses
`thinking/output_config.effort`	Рекомендуется `thinking.type: adaptive` с `low/medium/high/xhigh/max`; ни `minimal`, ни `disabled` не выключают мысли
`thinking.budget_tokens`	Старое `enabled` принято, не задаёт глубину; бюджет не меньше `1024` и меньше `max_tokens`; глубина через `output_config.effort`
`thinking.display`	`summarized` — сводка, `omitted` — только шифрование; передавайте блоки неизменными, особенно `redacted_thinking`
`temperature`	Диапазон `0～1`, не максимум Chat / Responses; обычно исключайте семплирование
Несовместимые поля	`top_k`, `stop_sequences`, `inference_geo` явно не поддерживаются и отвергаются
`tool_choice`	Принимается `auto/any/none`, не `{type: "tool"}` для конкретного инструмента; `disable_parallel_tool_use: true` ограничивает параллельность
`output_config.format`	Структура через `{type: "json_schema", schema: ...}`; `citations.enabled: true` блока document не поддерживается
Поиск и история	Поиск `web_search`; `allowed_domains/blocked_domains/max_uses` возвращает `400`. Нативный Messages не хранит диалог; каждый тур все сообщения/результаты, аналога `previous_response_id` нет

Отличия кеша

Поле	Отличие
Автоматический кеш префиксов	Без переключателя; стабильные инструкции, примеры, материалы сначала, переменное позже, префикс одинаковый
`prompt_cache_key`	Необязательный ID группы Chat / Responses по общему префиксу; не создавайте отдельный каждому пользователю/запросу, рассеивая маршруты
`prompt_cache_retention`	Responses использует `in_memory/24h` как подсказку хранения, управляемую сервером; не новые поля OpenAI и не устаревшее
`cache_control`	Messages принимает метки сверху, в блоках/инструментах; `ttl` только `5m`, не `1h` Claude
Использование кеша	Chat `usage.prompt_tokens_details.cached_tokens`, Responses `usage.input_tokens_details.cached_tokens`, Messages `usage.cache_read_input_tokens`; ID не доказывает попадания

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

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat `image_url.url`, Responses `input_image` со строкой `image_url`; URL/Base64, нативные ссылки от соответствующего Files
Видео	`input_video`	Responses `video_url` или `file_id`, загруженное видео также `input_file`; Chat блок `video_url`, структуры не смешивать
Аудио	`input_audio`	Chat / Responses: чистый Base64 в `input_audio.data`, формат `input_audio.format`; Responses также `audio_url` Base64 Data URL или нативный `file_id`
PDF	`file`	Chat `file.file_data/file_id`, Responses `input_file`, Messages `document`; не поля изображений
Медиа	`image/video`	Messages использует источники `base64/url/file` внутри `source`; `video` — расширение Meta

Лимит	Описание
Изображение	Встроенная картинка до `50 MB` (`50000000` байт), до `50` на запрос; также лимиты тела/контекста. Размещайте в user
Аудио Spark 1.3	Аудио поддерживается не полностью; качество может снижаться
Вывод	Обе выводят текст; приём картинок/аудио/видео не означает их генерацию

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

Замените MODEL_ID полным ID; кеш группируйте по префиксу приложения. Три примера с низкой глубиной и явным бюджетом.

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,
    "prompt_cache_key": "YOUR_SHARED_PREFIX"
  }'