Премини към основното съдържание
Български— Изберете език
Меню

Параметри на заявката

Урок 3 от 16 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Контрол на поведението на модела
  2. Параметри за генериране
  3. Параметри за разговор
  4. Параметри за инструменти
  5. Обобщение на параметрите
  6. Ключови изводи

Обновено на 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_id
  • false: отговорът не се запазва (режим на поверителност)

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).

Обобщение на параметрите

ПараметърТипПо подразбиранеУпотреба
modelstringзадължителенИдентификатор на модела
inputstring/arrayзадължителенПодкана от потребителя
instructionsstringnullСистемна подкана
temperaturenumber—Препоръчително 0.7; ограничено до 1
top_pnumber0.95Семплиране на ядрото
max_output_tokensinteger128 000Лимит на видимия отговор
reasoningobjectnullУсилие за разсъждане
storebooleannullЗапазване за 30 дни
streambooleanfalseSSE стрийминг
userstringnullID на крайния потребител

Ключови изводи

  • xAI препоръчва temperature да бъде 0.7, а top_p – 0.95, като и двете трябва да се задават изрично
  • max_output_tokens ограничава само видимия отговор, без да включва разсъжденията
  • store: true запазва отговора за 30 дни, което позволява верижно свързване на разговори
  • reasoning.effort Ви позволява да мащабирате размисъла на модела според сложността на задачата
  • Параметърът user подпомага проследяването и модерирането от страна на xAI