Параметри на заявката
На тази страница
Обновено на 3 ноември 2026 г. Въз основа на справочната документация за Responses API и най-добрите практики на xAI: препоръчителна температура 0.7, ограничена до 1;
top_pпо подразбиране 0.95;max_output_tokensограничено до видимия отговор (128 000 по подразбиране, без разсъжденията); усилието за разсъждане е запазено за grok-4.5 до 4.7. Източници: Responses API · Най-добри практики.
Контрол на поведението на модела
Освен model, input и instructions, Responses API предлага множество параметри за фина настройка на поведението на Grok. Разбирането на тези параметри Ви позволява да получавате по-релевантни, по-кратки или по-креативни отговори в зависимост от Вашите нужди.
Параметри за генериране
temperature
Контролира случайността на отговорите. API приема стойности от 0 до 2, но всичко над 1 се семплира като 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Най-добрите практики на xAI са ясни: задайте temperature на 0.7 и не се отклонявайте значително от тази стойност, тъй като моделите на Grok реагират лошо на други настройки за семплиране. За по-фактологичен или по-креативен тон коригирайте подканата (prompt), а не температурата.
top_p
Семплиране на ядрото (Nucleus sampling). Текущите текстови модели използват по подразбиране 0.95, като всяка стойност, по-висока от тази по подразбиране, се редуцира до нея.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
При top_p: 0.95 моделът разглежда само токените, които обхващат 95% от вероятността. Справочната документация на API повтаря класическия съвет да се коригира само един от двата параметъра; най-добрите практики на xAI обаче изискват изричното задаване и на двата – съответно на 0.7 и 0.95 – при всяка заявка.
max_output_tokens
Ограничава броя на токените във видимия отговор; разсъжденията и извикванията на функции не се броят, а стойността по подразбиране е 128 000 токена:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
При моделите за разсъждане вътрешният процес на размисъл се управлява от усилието за разсъждане (reasoning effort), а не от това ограничение. Отговор, прекъснат поради достигане на лимита, се сигнализира със статус incomplete.
reasoning
За модели, които поддържат разсъждане, можете да коригирате усилието:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Възможните стойности са low, medium и high (по подразбиране), както и xhigh за grok-4.6 и grok-4.7; параметърът важи за grok-4.5 до 4.7, а grok-4.20-0309-reasoning не го приема. Високото усилие консумира повече токени и е подходящо за сложни задачи.
Параметри за разговор
store
Определя дали отговорът се съхранява на сървъра:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: отговорът се съхранява за 30 дни, може да бъде извлечен чрез GET и използван сprevious_response_idfalse: отговорът не се запазва (режим на поверителност)
previous_response_id
Свързва нова заявка със съществуващ разговор (подробно разгледано в урок 5).
user
Идентификатор на крайния потребител, полезен за проследяване и модериране:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Параметри за инструменти
tools, tool_choice, parallel_tool_calls, max_turns
Тези параметри контролират използването на инструменти (web_search, code_interpreter, персонализирани функции). Те са разгледани подробно в раздела „Инструменти“ (уроци 9–12).
Обобщение на параметрите
| Параметър | Тип | По подразбиране | Употреба |
|---|---|---|---|
model | string | задължителен | Идентификатор на модела |
input | string/array | задължителен | Подкана от потребителя |
instructions | string | null | Системна подкана |
temperature | number | — | Препоръчително 0.7; ограничено до 1 |
top_p | number | 0.95 | Семплиране на ядрото |
max_output_tokens | integer | 128 000 | Лимит на видимия отговор |
reasoning | object | null | Усилие за разсъждане |
store | boolean | null | Запазване за 30 дни |
stream | boolean | false | SSE стрийминг |
user | string | null | ID на крайния потребител |
Ключови изводи
- xAI препоръчва
temperatureда бъде 0.7, аtop_p– 0.95, като и двете трябва да се задават изрично max_output_tokensограничава само видимия отговор, без да включва разсъждениятаstore: trueзапазва отговора за 30 дни, което позволява верижно свързване на разговориreasoning.effortВи позволява да мащабирате размисъла на модела според сложността на задачата- Параметърът
userподпомага проследяването и модерирането от страна на xAI