Parametry żądania
Na tej stronie
Zaktualizowano 3 listopada 2026 r. Na podstawie dokumentacji API Responses i najlepszych praktyk xAI: zalecana temperatura to 0,7 (ograniczona do 1);
top_pdomyślnie wynosi 0,95;max_output_tokensogranicza tylko widoczną odpowiedź (domyślnie 128 000, bez wnioskowania); wysiłek wnioskowania (reasoning effort) dotyczy modeli od grok-4.5 do 4.7. Źródła: API Responses · Najlepsze praktyki.
Sterowanie zachowaniem modelu
Oprócz parametrów model, input i instructions, API Responses oferuje wiele dodatkowych opcji pozwalających precyzyjnie dostroić zachowanie Groka. Zrozumienie ich pozwala uzyskać odpowiedzi bardziej trafne, krótsze lub bardziej kreatywne, w zależności od Twoich potrzeb.
Parametry generowania
temperature
Kontroluje losowość odpowiedzi. API akceptuje wartości od 0 do 2, ale wszystko powyżej 1 jest próbkowane jako 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
Najlepsze praktyki xAI są jasne: ustaw temperature na 0,7 i nie odchodź znacznie od tej wartości, ponieważ modele Grok źle reagują na inne ustawienia próbkowania. Jeśli potrzebujesz tonu bardziej faktograficznego lub kreatywnego, dostosuj prompt, a nie temperaturę.
top_p
Próbkowanie jądra (nucleus sampling). Obecne modele tekstowe mają domyślnie wartość 0,95, a każda wartość wyższa niż domyślna dla modelu jest do niej redukowana.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Przy top_p: 0.95 model bierze pod uwagę tylko tokeny, które łącznie stanowią 95% prawdopodobieństwa. Dokumentacja API powtarza klasyczną radę, aby调整ować tylko jeden z tych dwóch parametrów, jednak najlepsze praktyki xAI wymagają wyraźnego ustawienia obu: na 0,7 i 0,95, w każdym żądaniu.
max_output_tokens
Ogranicza liczbę tokenów w widocznej odpowiedzi; wnioskowanie i wywołania funkcji nie są wliczane, a wartość domyślna to 128 000 tokenów:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
W przypadku modeli wnioskujących, to wysiłek wnioskowania (reasoning effort), a nie ten limit, zarządza wewnętrznym procesem myślowym. Jeśli odpowiedź zostanie ucięta przez ten limit, sygnalizuje to status incomplete.
reasoning
Dla modeli obsługujących wnioskowanie możesz dostosować poziom wysiłku:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Możliwe wartości to low, medium i high (domyślnie), oraz xhigh dla grok-4.6 i grok-4.7; parametr ten dotyczy modeli od grok-4.5 do 4.7, natomiast grok-4.20-0309-reasoning go nie akceptuje. Wysoki wysiłek zużywa więcej tokenów i nadaje się do rozwiązywania złożonych problemów.
Parametry konwersacji
store
Określa, czy odpowiedź ma być przechowywana po stronie serwera:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: odpowiedź przechowywana przez 30 dni, możliwa do pobrania przez GET, użyteczna z parametremprevious_response_idfalse: odpowiedź nie jest utrwalana (tryb prywatny)
previous_response_id
Łączy nowe żądanie z istniejącą konwersacją (szczegóły w lekcji 5).
user
Identyfikator użytkownika końcowego, przydatny do śledzenia i moderacji:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Parametry narzędzi
tools, tool_choice, parallel_tool_calls, max_turns
Parametry te kontrolują korzystanie z narzędzi (wyszukiwanie w sieci, interpreter kodu, funkcje niestandardowe). Są one szczegółowo omówione w sekcji „Narzędzia“ (lekcje 9–12).
Podsumowanie parametrów
| Parametr | Typ | Domyślnie | Zastosowanie |
|---|---|---|---|
model | string | wymagany | Identyfikator modelu |
input | string/array | wymagany | Prompt użytkownika |
instructions | string | null | Prompt systemowy |
temperature | number | — | Zalecane 0,7; ograniczone do 1 |
top_p | number | 0.95 | Próbkowanie jądra |
max_output_tokens | integer | 128 000 | Limit widocznej odpowiedzi |
reasoning | object | null | Wysiłek wnioskowania |
store | boolean | null | Utrwalanie przez 30 dni |
stream | boolean | false | Strumieniowanie SSE |
user | string | null | ID użytkownika końcowego |
Kluczowe wnioski
- xAI zaleca ustawienie
temperaturena 0,7 itop_pna 0,95, przy czym obie wartości należy podać wyraźnie max_output_tokensogranicza tylko widoczną odpowiedź, z wyłączeniem procesu wnioskowaniastore: trueutrwalają odpowiedź na 30 dni, co umożliwia kontynuację konwersacjireasoning.effortpozwala skalować głębokość wnioskowania modelu w zależności od złożoności zadania- Parametr
userułatwia śledzenie i moderację po stronie xAI