Pyyntöparametrit
Tällä sivulla
Päivitetty 3. marraskuuta 2026. Perustuu Responses API -viitteeseen ja xAI:n parhaisiin käytäntöihin: suositeltu lämpötila 0,7, yläraja 1;
top_poletuksena 0,95;max_output_tokensrajoitettu näkyvään vastaukseen (oletus 128 000, päättely ei mukana); päättelypyrkimys varattu malleille grok-4.5–4.7. Lähteet: Responses API · Parhaat käytännöt.
Mallin toiminnan ohjaus
model, input ja instructions -parametrien lisäksi Responses API tarjoaa lukuisia parametreja Grokin toiminnan hienosäätöön. Näiden parametrien ymmärtäminen auttaa sinua saamaan tarpeisiisi sopivampia, lyhyempiä tai luovempia vastauksia.
Generointiparametrit
temperature (lämpötila)
Ohjaa vastauksien satunnaisuutta. API hyväksyy arvoja välillä 0–2, mutta kaikki yli 1 olevat arvot näytetään otannassa arvolla 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
xAI:n parhaat käytännöt ovat selkeät: aseta temperature arvoksi 0,7 äläkä poikkea siitä merkittävästi, sillä Grok-mallit reagoivat huonosti muihin otanta-asetuksiin. Säädä kehottetta faktuaalisemmaksi tai luovammaksi muokkaamalla promptia eikä lämpötilaa.
top_p
Ydinotanta (nucleus sampling). Nykyiset tekstimallet käyttävät oletuksena arvoa 0,95, ja kaikki mallin oletusarvoa suuremmat arvot pienennetään tähän.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Arvolla top_p: 0.95 malli huomioi vain ne tokenit, jotka kattavat 95 % todennäköisyydestä. API-viite toistaa klassisen neuvon säätää vain toista kahdesta parametrista, mutta xAI:n parhaat käytännöt vaativat molempien asettamista eksplisiittisesti arvoihin 0,7 ja 0,95 jokaisessa pyynnössä.
max_output_tokens
Rajoittaa näkyvän vastauksen tokenien määrää; päättely ja funktiokutsut eivät sisälly laskentaan, ja oletusarvo on 128 000 tokenia:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Päättelymalleissa sisäistä pohdintaa ohjaa päättelypyrkimys, ei tämä yläraja. Jos vastaus katkeaa rajan vuoksi, tilaksi ilmoitetaan incomplete.
reasoning (päättely)
Malleille, jotka tukevat päättelyä, voit säätää pyrkimyksen tasoa:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Mahdolliset arvot ovat low, medium ja high (oletus), sekä xhigh malleissa grok-4.6 ja grok-4.7. Parametri koskee malleja grok-4.5–4.7, eikä grok-4.20-0309-reasoning hyväksy sitä. Korkea pyrkimys kuluttaa enemmän tokeneita ja sopii monimutkaisiin ongelmiin.
Keskusteluparametrit
store
Määrittää, tallennetaanko vastaus palvelinpuolelle:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: vastaus tallennetaan 30 päiväksi, haettavissa GET-pyynnöllä, käytettävissä parametrillaprevious_response_idfalse: vastausta ei pysyväistytä (yksityinen tila)
previous_response_id
Ketjuttaa uuden pyynnön olemassa olevaan keskusteluun (käsitelty tarkemmin oppitunnilla 5).
user
Loppukäyttäjän tunniste, hyödyllinen seurantaan ja moderointiin:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Työkaluparametrit
tools, tool_choice, parallel_tool_calls, max_turns
Nämä parametrit ohjaavat työkalujen käyttöä (web_search, code_interpreter, mukautetut funktiot). Niitä käsitellään yksityiskohtaisesti osiossa “Työkalut” (oppitunnit 9–12).
Parametrien yhteenveto
| Parametri | Tyyppi | Oletus | Käyttö |
|---|---|---|---|
model | merkkijono | vaadittu | Mallin tunniste |
input | merkkijono/taulukko | vaadittu | Käyttäjän kehote |
instructions | merkkijono | null | Järjestelmäkehote |
temperature | numero | — | Suositus 0,7; yläraja 1 |
top_p | numero | 0.95 | Ydinotanta |
max_output_tokens | kokonaisluku | 128 000 | Näkyvän vastauksen raja |
reasoning | objekti | null | Päättelypyrkimys |
store | totuusarvo | null | 30 päivän pysyvyys |
stream | totuusarvo | false | SSE-virtaus |
user | merkkijono | null | Loppukäyttäjän ID |
Keskeiset asiat
- xAI suosittelee asettamaan
temperaturearvoksi 0,7 jatop_parvoksi 0,95 eksplisiittisesti max_output_tokensrajoittaa vain näkyvää vastausta, päättelyä ei lasketa mukaanstore: truepysyväistää vastauksen 30 päiväksi keskusteluketjutusta vartenreasoning.effortantaa sinun skaalata mallin pohdintaa tehtävän vaativuuden mukaanuser-parametri auttaa xAI:ta seurannassa ja moderoinnissa