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

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

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

Модели

Модель	Особенности использования
grok-4.7	Поддерживается `low/medium/high/xhigh`, по умолчанию `high`, мысли неотключаемы; Responses возвращает шифрованные по умолчанию
grok-4.6	Те же четыре уровня, по умолчанию `high`, неотключаемо; шифрование запросить через `include`
grok-4.5	Поддерживается `low/medium/high`, по умолчанию `high`, неотключаемо; `xhigh` как `high`

xAI считает Chat старой совместимостью, Responses основной API; исторический Messages устарел официально. Это не значит отключение других входов платформой.

Отличия Chat Completions

Поле	Отличие
`reasoning_effort`	Уровни выше; `none` не выключает рассуждение
`temperature`	Допускается `0～2`, реально максимум `1`; допустимое выше `1` становится `1`, не устаревание поля
`top_p`	Допустимо до `1`, реально не выше умолчания модели, сейчас `0.95`; при отсутствии оно же
`presence_penalty/frequency_penalty/stop`	Эти модели не поддерживают, передача даёт ошибку; не копируйте общие опции
`logprobs/top_logprobs`	Все три не поддерживают и молча игнорируют, в отличие от ошибок выше
`tools[].function.strict`	Аргументы строго по поддерживаемому JSON Schema; `strict` неявно `true`, `false` не включает нестрогий режим
История мыслей	У Chat нет поля шифрованных мыслей Responses; межтуровая передача через Responses

Отличия Responses

Поле	Отличие
`reasoning.effort`	Уровни модели, по умолчанию `high`; выключить нельзя
`temperature/top_p`	Те же пределы выборки; ответ может повторить запрос, не реальные обрезанные значения
Штрафы и Logprobs	Как Chat: штрафы не поддерживаются, Logprobs игнорируется; Responses не включает их
`max_output_tokens`	Только видимый ответ без токенов мыслей/функций; по умолчанию `128000`, не общий бюджет OpenAI
`include`	grok-4.6, grok-4.5 просят шифрование через `reasoning.encrypted_content`; grok-4.7 возвращает и без запроса
`store/previous_response_id`	`store` по умолчанию `true`; нативные ответы хранятся `30` дней и продолжаются по ID. С `store: false` передавайте всю историю/элементы, не только текст, шифрование неизменным
`tools[].strict`	Функции также неявно строгие; параметры/структура по подмножеству xAI
JSON Schema	`additionalProperties` по умолчанию `false`, для добавочных свойств `true`; `$ref/$defs` только нециклические ссылки, без рекурсии
Серверные инструменты	xAI Responses использует `web_search`, `x_search`, `code_interpreter`; последнее соответствует `code_execution` нативного SDK, не путайте имена

Отличия кеша

Поле	Отличие
Автоматический кеш префиксов	Идентичные префиксы используются автоматически; статичные инструкции сначала, далее лишь добавлять, не менять/переставлять историю
`x-grok-conv-id`	Стабильный ID диалога в Header Chat направляет к серверу с кешем; не параметр модели
`prompt_cache_key`	Соответствующий ID в теле Responses, стабильный каждый тур; шифрованные мысли без изменений. Не добавляйте чужие TTL/явные точки
Использование кеша	Chat `usage.prompt_tokens_details.cached_tokens`, Responses `usage.input_tokens_details.cached_tokens`; кеш вытесняется, ID не гарантирует попадание

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

Ввод	Блок протокола	Отличие
Изображение	`image_url`	Chat `image_url.url`: публичный URL / Base64 Data URL; JPEG / PNG, до `20 MiB` на изображение
Изображение	`input_image`	Responses `image_url` напрямую URL / Base64 Data URL, те же лимиты, не объект Chat

Все выводят текст; detail принимает auto/low/high для детализации анализа, не генерации картинок.

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

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

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