Przejdź do głównej treści
Polski— Wybierz język
Menu

Parametry żądania

Lekcja 3 z 16 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Sterowanie zachowaniem modelu
  2. Parametry generowania
  3. Parametry konwersacji
  4. Parametry narzędzi
  5. Podsumowanie parametrów
  6. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 r. Na podstawie dokumentacji API Responses i najlepszych praktyk xAI: zalecana temperatura to 0,7 (ograniczona do 1); top_p domyślnie wynosi 0,95; max_output_tokens ogranicza 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 parametrem previous_response_id
  • false: 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

ParametrTypDomyślnieZastosowanie
modelstringwymaganyIdentyfikator modelu
inputstring/arraywymaganyPrompt użytkownika
instructionsstringnullPrompt systemowy
temperaturenumber—Zalecane 0,7; ograniczone do 1
top_pnumber0.95Próbkowanie jądra
max_output_tokensinteger128 000Limit widocznej odpowiedzi
reasoningobjectnullWysiłek wnioskowania
storebooleannullUtrwalanie przez 30 dni
streambooleanfalseStrumieniowanie SSE
userstringnullID użytkownika końcowego

Kluczowe wnioski

  • xAI zaleca ustawienie temperature na 0,7 i top_p na 0,95, przy czym obie wartości należy podać wyraźnie
  • max_output_tokens ogranicza tylko widoczną odpowiedź, z wyłączeniem procesu wnioskowania
  • store: true utrwalają odpowiedź na 30 dni, co umożliwia kontynuację konwersacji
  • reasoning.effort pozwala skalować głębokość wnioskowania modelu w zależności od złożoności zadania
  • Parametr user ułatwia śledzenie i moderację po stronie xAI