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

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

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

Модели

Модель	Область применения
kimi-k3.1-pro, kimi-k3.1-pro-highspeed, kimi-k3	Общие правила трёх протоколов; модели для расширений указаны в соответствующих строках

Отличия Chat Completions

Поле	Отличие
`temperature`, `top_p`	Фиксированы `1.0`, `0.95`; лучше не передавать. Другие значения вызывают ошибку
`n`, `presence_penalty`, `frequency_penalty`	Фиксированы `1`, `0`, `0`; другие значения вызывают ошибку
`reasoning_effort`	Поддерживается `low/high/max`, по умолчанию `max`; рассуждение и его сохранение всегда включены. Не используйте переключатель K2.x `thinking`
`max_completion_tokens`	По умолчанию `131072`, максимум `1048576`; если ввод и бюджет превышают контекст, бюджет вывода уменьшается автоматически. Сам ввод обязан помещаться
`stop`	Не более 5 строк, каждая до 32 байт
`tool_choice`	Поддерживается `auto/none/required`; объект с конкретной функцией несовместим с рассуждением и возвращает `400`
`messages[].reasoning_content`	В диалогах и инструментах передавайте полные неизменённые сообщения assistant, включая рассуждение и `tool_calls`
`messages[].partial`	Kimi Partial Mode: `true` в последнем assistant продолжает его префикс; не совмещать с `response_format.type=json_object`
`messages[].tools`	Динамические инструменты для kimi-k3.1-pro, kimi-k3: добавьте system со всеми определениями без `content`. Инструменты видны с этой позиции; сохраняйте сообщение далее

Отличия Responses

Поле	Отличие
`reasoning.effort`	Поддерживается `low/high/max`; по умолчанию `max`
`max_output_tokens`	По умолчанию `131072`; максимум `1048576`
`tool_choice`	Только `auto`
`tools[].type`	Только `function/namespace/custom/web_search`; имя инструмента `custom` — только `apply_patch`
`text.format`	Используйте `type: "json_schema"`, `schema`; при отсутствии `name` равно `output`
Поля состояния диалога в ответе	`store`, `background` фиксированы в `false`; `previous_response_id`, `conversation` в `null`. Клиент передаёт ввод и вывод заново, без серверной цепочки сохранённых ответов

Отличия Messages

Поле	Отличие
`max_tokens`	Обязательно, минимум `1`; `0` недопустимо
`output_config.effort`	Поддерживается `low/high/max`; по умолчанию `max`
`tool_choice.type`	Поддерживается `auto/any/none`; по умолчанию `auto`
`stop_sequences`	Не более 5 строк, каждая до 32 байт
Предыдущие блоки `thinking`	Передавайте неизменными вместе с `signature` в следующем assistant
`output_config.format`	Для структурированного вывода обязательны `type: "json_schema"`, `schema`

Отличия кеша

Поле	Отличие
`prompt_cache_options` в Chat / Responses	`mode` принимает только `implicit`; `ttl` — `5m/1h`, по умолчанию `5m`. Без настройки также записывается кеш на 5 минут
`prompt_cache_breakpoint` в Chat / Responses	Явные точки кеширования не поддерживаются; в содержимом возвращают `400`
`cache_control` в Messages	Действует только настройка верхнего уровня; метки внутри `messages` игнорируются. `type` фиксировано `ephemeral`; `ttl` принимает `5m/1h`, по умолчанию `5m`. Без настройки чтение/запись с TTL 5 минут
Глубина рассуждения	Смена уровня нарушает совпадение префикса; выбирайте при начале диалога

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

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat: `image_url.url` принимает Base64 Data URL либо нативную ссылку `ms://<file_id>`, но не обычный публичный URL изображения
Видео	`video_url`	Chat: Base64 Data URL или ссылка `ms://<file_id>` на загруженное видео
Изображение	`input_image`	Responses: `image_url` принимает Base64 Data URL, не публичный HTTP(S) URL
Изображение	`image`	Messages: при `source.type=base64` укажите `media_type`, `data`; при `source.type=url` поместите нативную ссылку `ms://<file_id>` в `source.url`
SVG	Ввод изображений	SVG не поддерживается, включая Base64; для анализа передайте XML как текст

ms:// — нативная ссылка Kimi, требующая загрузки в Kimi. Эта страница не предоставляет API загрузки AGTCloud.

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

Замените 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,
    "prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
  }'