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

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

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

Модели

Модель	Область применения
hy4-preview	Chat, Responses, Messages; уровни Chat `none/high`, по умолчанию `high`
hy3	Chat, Responses, Messages; уровни Chat `none/low/high`, по умолчанию `high`; сохранение и инструменты см. ниже

Отличия Chat Completions

Поле	Отличие
`thinking.type`	Обе рассуждают по умолчанию; переключатель `enabled/disabled`, уровни `reasoning_effort` выше
`reasoning_effort`	Hy3 с `tools` преобразует `low` в `high`; модель выбирает глубину по задаче инструмента
`max_tokens`, `max_completion_tokens`	Оба ограничивают общий бюджет, второе приоритетно. Hy3 рекомендуется минимум `16000`, но это не обязательный минимум поля
`top_k`, `repetition_penalty`	Молча игнорируются, не расширения как у Qwen
`n`	При рассуждении обязательно `1`
`preserved_thinking`	Сохранение Hy3: с `tools` включено по умолчанию, в простом тексте выключено; имя `preserved_thinking`
История `reasoning_content`	С результатами сохраняйте прошлые мысли assistant и `tool_calls`; включение не восстанавливает пропущенную клиентом историю
`tool_choice`	При рассуждении используйте `auto/none`, не `required` и не функцию принудительно
`web_search_options`	Поиск Hy3: `enable: true`; `search_source` принимает `standard/lite`, по умолчанию `standard`; строка только для Hy3

Отличия Responses

Поле	Отличие
`max_output_tokens`	Включает рассуждение и ответ; не бюджетируйте лишь видимый текст
`tool_choice`	Hy3 только `auto/none`; не `required` и не объект конкретной функции
`previous_response_id`	Hy3 возвращает `400` на непустое значение; передавайте историю в `input`
`reasoning.preserved_thinking`	Сохранение Hy3 в объекте `reasoning`, умолчания как Chat
`text.format`	Поддерживается `text/json_object/json_schema`; JSON Schema Hy3 требует `additionalProperties: false`
`web_search` в `tools`	Поиск Hy3 использует `type: "web_search"`, не расположение `web_search_options` Chat

Отличия Messages

Поле	Отличие
`thinking.type`, `max_tokens`	Переключатель `enabled/disabled`; `max_tokens` включает рассуждение/ответ, оставляйте место ответу при `budget_tokens`
`HY-Preserved-Thinking`	Header сохранения Hy3 принимает `true/false`, иначе умолчания; не переносите верхнеуровневое поле Chat в тело Messages
История блоков thinking	С результатами сохраняйте реальный assistant. Если Hy3 не вернул `signature`, не создавайте подпись; требование Claude не применяется

Отличия кеша

Поле	Отличие
`prompt_cache_key`	Идентификатор кеша Chat; стабильные префикс и значение, попадание проверять по ответу
Сохранение рассуждения и кеш	Сохранение продолжает рассуждение, не доказывает кеш; полная стабильная история помогает префиксам
Использование кеша	Chat `usage.prompt_tokens_details.cached_tokens`; Responses реальный `usage.input_tokens_details.cached_tokens`; Messages реальный `usage.cache_read_input_tokens`

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

Замените 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": "high",
    "max_completion_tokens": 16384
  }'