Grok 3 on xAI:n malliperhe kielitehtäviin, yleistietoon, ohjelmointiin ja ongelmanratkaisuun. Julkaisukuvaus erottaa tavanomaisesti vastaavan mallin perheen erikseen nimetyistä Think-versioista, jotka käyttävät lisäpäättelyä ennen lopullista vastausta. Tässä kuvattu nimetty grok-3-versio on tekstikeskusteluversio: valmistaja ilmoittaa sille tekstisyötteen ja tekstitulosteen eikä erillistä päättelyominaisuutta.
Perheen esikoulutuksen tarkoitus on tukea laajaa kysymysten ja ohjeiden kirjoa. xAI nostaa julkaisukuvauksessa esiin matematiikan, ohjelmoinnin, tiedon ja tyylin hallinnan. Kirjoitustehtävässä tämä tarjoaa hyödyllisen pohjan pyytää mallia muokkaamaan selitystä tietylle lukijalle, säilyttämään määritetyt faktat tai laatimaan yhtenäisen luonnoksen annetuista kohdista. Anna tekniselle avustajalle olennainen aineisto ja määritä kysymys, joka vastauksen on ratkaistava, sen sijaan, että käyttäisit vain yleistä pyyntöä käsitellä aihetta.
Havainnollistava asiakirjatehtävä on: ”Vertaa näitä kahta työnkulun kuvausta. Luettele yhteneväisyydet, ristiriidat ja puuttuvat tiedot ja kirjoita sitten lyhyt selitys uudelle tiimin jäsenelle.” Säilytä lähdeosioiden merkinnät, jotta vastaus voi yhdistää kunkin havainnon oikeaan katkelmaan. Kooditehtävä voi sisältää funktion, odotetun toiminnan ja konkreettisen syötteen, jolla nykyinen tulos on väärä. Pyydä ehdotettu korjaus ja kerro, millä esimerkeillä se tulee tarkistaa. Nämä esimerkit hyödyntävät dokumentoituja kieli- ja ohjelmointitehtävien ryhmiä eivätkä tarkoita, että tuotettu koodi olisi jo suoritettu.
Ero Think-versioihin on tärkeä. Grok 3 -perheen julkistus kuvaa myös Grok 3 Think- ja Grok 3 mini Think -mallit, jotka on koulutettu käyttämään enemmän työtä päättelyyn. Niiden laajennettu ajattelu tulee kuvata omana tilanaan tai mallivaihtoehtonaan. Tavallinen tekstiversio voi antaa selityksiä ja ratkaista kysymyksiä, mutta tätä ei tule sekoittaa erikseen dokumentoidun laajennetun päättelykokoonpanon valintaan.
Valmistajan nimettyä mallia koskeva metatietoesimerkki antaa grok-3-mallin kehotteen enimmäispituudeksi 131 072 tokenia ja ilmoittaa tuen rakenteisille tuloksille ja funktiokutsuille. Kehotteen pituuskenttä kuvaa kyseisessä esimerkissä julkaistua syötebudjettia; se ei ole erillinen tulostetokenien yläraja. Perheen julkistus käsittelee suurempaa pitkän kontekstin kokoonpanoa, joten pidä täsmällisen nimetyn mallin määritys ja laajempi perhekuvaus erillään valmistellessasi pyyntöä. Sisällytä kysymyksen tarvitsema konteksti ja määritä vastauksen muoto ja pituus nimenomaisesti.
Rakenteinen tulos on hyödyllinen, kun keskustelun tulee päättyä kenttiin, joita sovellus voi käsitellä, kuten yhteenvetoon, poimittuihin faktoihin ja yhä tarkennusta tarvitseviin kysymyksiin. Funktiokutsujen avulla sovellus voi tarjota sallittuja toimintoja ja vastaanottaa ehdotettuja argumentteja. Sovellus suorittaa toiminnon ja palauttaa tuloksen seuraavaa vastausta varten. Tämä eroaa siitä, että mallilla olisi itsenäisesti pääsy mihin tahansa tietokantaan, selaimeen tai koodintulkkiin.
Julkaisuartikkeli käsittelee DeepSearchia ja työkaluilla varustettuja agentteja Grok-perheen ympärille rakennettuina järjestelminä. Niiden haku-, suoritus- ja raportointityönkulut muodostavat integraatiokontekstin eivätkä ole peruste siirtää kaikkia sovellusominaisuuksia pelkkään grok-3-tekstiversioon. Kerro hyödyllistä tehtävää varten, mitä annettua aineistoa tai työkalujen palauttamia tietoja mallin tulee käyttää, erota faktat pyydetyistä tulkinnoista ja pyydä sitä merkitsemään puuttuvat tiedot. Päätä tehtävä konkreettiseen tuotokseen: muokattuun asiakirjaan, koodiehdotukseen, poimintatietueeseen tai selitykseen, jota voidaan verrata alkuperäisiin syötteisiin.
", "aboutText": "Grok 3 on xAI:n malliperhe kielitehtäviin, yleistietoon, ohjelmointiin ja ongelmanratkaisuun. Julkaisukuvaus erottaa tavanomaisesti vastaavan mallin perheen erikseen nimetyistä Think-versioista, jotka käyttävät lisäpäättelyä ennen lopullista vastausta. Tässä kuvattu nimetty grok-3-versio on tekstikeskusteluversio: valmistaja ilmoittaa sille tekstisyötteen ja tekstitulosteen eikä erillistä päättelyominaisuutta.\n\nPerheen esikoulutuksen tarkoitus on tukea laajaa kysymysten ja ohjeiden kirjoa. xAI nostaa julkaisukuvauksessa esiin matematiikan, ohjelmoinnin, tiedon ja tyylin hallinnan. Kirjoitustehtävässä tämä tarjoaa hyödyllisen pohjan pyytää mallia muokkaamaan selitystä tietylle lukijalle, säilyttämään määritetyt faktat tai laatimaan yhtenäisen luonnoksen annetuista kohdista. Anna tekniselle avustajalle olennainen aineisto ja määritä kysymys, joka vastauksen on ratkaistava, sen sijaan, että käyttäisit vain yleistä pyyntöä käsitellä aihetta.\n\nHavainnollistava asiakirjatehtävä on: ”Vertaa näitä kahta työnkulun kuvausta. Luettele yhteneväisyydet, ristiriidat ja puuttuvat tiedot ja kirjoita sitten lyhyt selitys uudelle tiimin jäsenelle.” Säilytä lähdeosioiden merkinnät, jotta vastaus voi yhdistää kunkin havainnon oikeaan katkelmaan. Kooditehtävä voi sisältää funktion, odotetun toiminnan ja konkreettisen syötteen, jolla nykyinen tulos on väärä. Pyydä ehdotettu korjaus ja kerro, millä esimerkeillä se tulee tarkistaa. Nämä esimerkit hyödyntävät dokumentoituja kieli- ja ohjelmointitehtävien ryhmiä eivätkä tarkoita, että tuotettu koodi olisi jo suoritettu.\n\nEro Think-versioihin on tärkeä. Grok 3 -perheen julkistus kuvaa myös Grok 3 Think- ja Grok 3 mini Think -mallit, jotka on koulutettu käyttämään enemmän työtä päättelyyn. Niiden laajennettu ajattelu tulee kuvata omana tilanaan tai mallivaihtoehtonaan. Tavallinen tekstiversio voi antaa selityksiä ja ratkaista kysymyksiä, mutta tätä ei tule sekoittaa erikseen dokumentoidun laajennetun päättelykokoonpanon valintaan.\n\nValmistajan nimettyä mallia koskeva metatietoesimerkki antaa grok-3-mallin kehotteen enimmäispituudeksi 131 072 tokenia ja ilmoittaa tuen rakenteisille tuloksille ja funktiokutsuille. Kehotteen pituuskenttä kuvaa kyseisessä esimerkissä julkaistua syötebudjettia; se ei ole erillinen tulostetokenien yläraja. Perheen julkistus käsittelee suurempaa pitkän kontekstin kokoonpanoa, joten pidä täsmällisen nimetyn mallin määritys ja laajempi perhekuvaus erillään valmistellessasi pyyntöä. Sisällytä kysymyksen tarvitsema konteksti ja määritä vastauksen muoto ja pituus nimenomaisesti.\n\nRakenteinen tulos on hyödyllinen, kun keskustelun tulee päättyä kenttiin, joita sovellus voi käsitellä, kuten yhteenvetoon, poimittuihin faktoihin ja yhä tarkennusta tarvitseviin kysymyksiin. Funktiokutsujen avulla sovellus voi tarjota sallittuja toimintoja ja vastaanottaa ehdotettuja argumentteja. Sovellus suorittaa toiminnon ja palauttaa tuloksen seuraavaa vastausta varten. Tämä eroaa siitä, että mallilla olisi itsenäisesti pääsy mihin tahansa tietokantaan, selaimeen tai koodintulkkiin.\n\nJulkaisuartikkeli käsittelee DeepSearchia ja työkaluilla varustettuja agentteja Grok-perheen ympärille rakennettuina järjestelminä. Niiden haku-, suoritus- ja raportointityönkulut muodostavat integraatiokontekstin eivätkä ole peruste siirtää kaikkia sovellusominaisuuksia pelkkään grok-3-tekstiversioon. Kerro hyödyllistä tehtävää varten, mitä annettua aineistoa tai työkalujen palauttamia tietoja mallin tulee käyttää, erota faktat pyydetyistä tulkinnoista ja pyydä sitä merkitsemään puuttuvat tiedot. Päätä tehtävä konkreettiseen tuotokseen: muokattuun asiakirjaan, koodiehdotukseen, poimintatietueeseen tai selitykseen, jota voidaan verrata alkuperäisiin syötteisiin.", "editorialOverlay": { "copy_fields": { "practical_html": "Tekninen esimerkki englanniksi
Revise a technical explanation\n\nRewrite this for a nontechnical office manager in at most 75 words: 'The synchronisation job retries transient transport failures using exponential backoff; repeated requests carry the same operation key to prevent duplicate entries.' Preserve the difference between retrying a failed connection and creating a second record. Use one everyday comparison and no unsupported guarantees.A concise plain-language explanation with one comparison and both retry and duplicate-prevention concepts intact.The rewrite does not imply that every failure is recoverable or that retries always succeed.grok-3Grok 3 on xAI:n tekstikeskusteluversio selityksiin, kirjoittamiseen, ohjelmointiin ja annettuun aineistoon perustuviin kysymyksiin. Nimetty malliversio tukee rakenteisia tuloksia ja funktiokutsuja ja eroaa perheen erikseen nimetyistä Think-malleista.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Grok 3 on xAI:n malliperhe kielitehtäviin, yleistietoon, ohjelmointiin ja ongelmanratkaisuun. Julkaisukuvaus erottaa tavanomaisesti vastaavan mallin perheen erikseen nimetyistä Think-versioista, jotka käyttävät lisäpäättelyä ennen lopullista vastausta. Tässä kuvattu nimetty grok-3-versio on tekstikeskusteluversio: valmistaja ilmoittaa sille tekstisyötteen ja tekstitulosteen eikä erillistä päättelyominaisuutta.
Perheen esikoulutuksen tarkoitus on tukea laajaa kysymysten ja ohjeiden kirjoa. xAI nostaa julkaisukuvauksessa esiin matematiikan, ohjelmoinnin, tiedon ja tyylin hallinnan. Kirjoitustehtävässä tämä tarjoaa hyödyllisen pohjan pyytää mallia muokkaamaan selitystä tietylle lukijalle, säilyttämään määritetyt faktat tai laatimaan yhtenäisen luonnoksen annetuista kohdista. Anna tekniselle avustajalle olennainen aineisto ja määritä kysymys, joka vastauksen on ratkaistava, sen sijaan, että käyttäisit vain yleistä pyyntöä käsitellä aihetta.
Havainnollistava asiakirjatehtävä on: ”Vertaa näitä kahta työnkulun kuvausta. Luettele yhteneväisyydet, ristiriidat ja puuttuvat tiedot ja kirjoita sitten lyhyt selitys uudelle tiimin jäsenelle.” Säilytä lähdeosioiden merkinnät, jotta vastaus voi yhdistää kunkin havainnon oikeaan katkelmaan. Kooditehtävä voi sisältää funktion, odotetun toiminnan ja konkreettisen syötteen, jolla nykyinen tulos on väärä. Pyydä ehdotettu korjaus ja kerro, millä esimerkeillä se tulee tarkistaa. Nämä esimerkit hyödyntävät dokumentoituja kieli- ja ohjelmointitehtävien ryhmiä eivätkä tarkoita, että tuotettu koodi olisi jo suoritettu.
Ero Think-versioihin on tärkeä. Grok 3 -perheen julkistus kuvaa myös Grok 3 Think- ja Grok 3 mini Think -mallit, jotka on koulutettu käyttämään enemmän työtä päättelyyn. Niiden laajennettu ajattelu tulee kuvata omana tilanaan tai mallivaihtoehtonaan. Tavallinen tekstiversio voi antaa selityksiä ja ratkaista kysymyksiä, mutta tätä ei tule sekoittaa erikseen dokumentoidun laajennetun päättelykokoonpanon valintaan.
Valmistajan nimettyä mallia koskeva metatietoesimerkki antaa grok-3-mallin kehotteen enimmäispituudeksi 131 072 tokenia ja ilmoittaa tuen rakenteisille tuloksille ja funktiokutsuille. Kehotteen pituuskenttä kuvaa kyseisessä esimerkissä julkaistua syötebudjettia; se ei ole erillinen tulostetokenien yläraja. Perheen julkistus käsittelee suurempaa pitkän kontekstin kokoonpanoa, joten pidä täsmällisen nimetyn mallin määritys ja laajempi perhekuvaus erillään valmistellessasi pyyntöä. Sisällytä kysymyksen tarvitsema konteksti ja määritä vastauksen muoto ja pituus nimenomaisesti.
Rakenteinen tulos on hyödyllinen, kun keskustelun tulee päättyä kenttiin, joita sovellus voi käsitellä, kuten yhteenvetoon, poimittuihin faktoihin ja yhä tarkennusta tarvitseviin kysymyksiin. Funktiokutsujen avulla sovellus voi tarjota sallittuja toimintoja ja vastaanottaa ehdotettuja argumentteja. Sovellus suorittaa toiminnon ja palauttaa tuloksen seuraavaa vastausta varten. Tämä eroaa siitä, että mallilla olisi itsenäisesti pääsy mihin tahansa tietokantaan, selaimeen tai koodintulkkiin.
Julkaisuartikkeli käsittelee DeepSearchia ja työkaluilla varustettuja agentteja Grok-perheen ympärille rakennettuina järjestelminä. Niiden haku-, suoritus- ja raportointityönkulut muodostavat integraatiokontekstin eivätkä ole peruste siirtää kaikkia sovellusominaisuuksia pelkkään grok-3-tekstiversioon. Kerro hyödyllistä tehtävää varten, mitä annettua aineistoa tai työkalujen palauttamia tietoja mallin tulee käyttää, erota faktat pyydetyistä tulkinnoista ja pyydä sitä merkitsemään puuttuvat tiedot. Päätä tehtävä konkreettiseen tuotokseen: muokattuun asiakirjaan, koodiehdotukseen, poimintatietueeseen tai selitykseen, jota voidaan verrata alkuperäisiin syötteisiin.
POST /v1/chat/completionstexttext| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat grok-3 | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat Kohteiden vähimmäismäärä: 1 | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat Esimerkit: system, user, assistant, tool, function Ehdot: Nämä roolit esitetään nimenomaisesti lähdekoodin yhteensopivuustyypeissä; mallin täsmällinen roolijoukko pysyy mallikohtaisena. Riippuu mallista | Oletus— |
Kenttämessages[].content | Tyyppistring|content_part[]|null | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_calls | Tyyppitool_call[] | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].tool_call_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: role=tool; käytä todella palautettua ID:tä | Oletus— |
Kenttämessages[].name | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttämessages[].reasoning_content | Tyyppistring | VaatimusValinnainen | Arvot & rajat Sovelletaan, kun: Palauta todella saatu päättely takaisin mallille, kun kyseinen malli käyttää sitä | Oletus— |
Kenttämessages[].reasoning_details | Tyyppiobject|array | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— |
Kenttämax_completion_tokens | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 Riippuu mallista | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Kenttästream_options.include_usage | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätemperature | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätop_p | Tyyppinumber | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttästop | Tyyppistring|string[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätools | Tyyppifunction_tool[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttätools[].type | Tyyppistring | VaatimusValinnainen | Arvot & rajat function Riippuu mallista | Oletus— |
Kenttätools[].function.name | Tyyppistring | VaatimusPakollinen | Arvot & rajat Sovelletaan, kun: funktiotyökalu annettu | Oletus— |
Kenttätools[].function.description | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätools[].function.parameters | TyyppiJSON_schema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätool_choice | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäparallel_tool_calls | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäresponse_format | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäreasoning_effort | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäreasoning | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäservice_tier | Tyyppistring | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäinstructions | Tyyppistring | VaatimusValinnainen | Arvot & rajat Yhteensopivuuskenttä | Oletus— |
Kenttäfunctions | Tyyppifunction[] | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäfunction_call | Tyyppistring|object | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttäprompt_cache_options | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Riippuu mallista | Oletus— |
Kenttämodalities | Tyyppistring[] | VaatimusValinnainen | Arvot & rajat text | Oletus— |
Kenttäprovider | Tyyppiobject | VaatimusValinnainen | Arvot & rajat Ehdot: provider.options hylätään tällä Ultran tekstireitillä | Oletus— |
Kenttäcache_control.ttl | Tyyppistring | VaatimusValinnainen | Arvot & rajat Ehdot: 1h hylätään varsinaisissa kehotevälimuistin kohdissa | Oletus— |
Teksti · UTF8-teksti
messages[].content
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages |
Parametrimaterial_types | Sopimustext |
Parametrimessages | Sopimusviestitaulukko role/content-rakenteella |
Parametrifile_material | Sopimusvarsinainen UTF-8-asiakirja lisätään sellaisenaan tekstinä; tiedoston ID:tä ei päätellä |
Parametrioptional_controls | Sopimusstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametricontrol_scope | Sopimusmallikohtainen; käyttäjän funktiotyökalut eroavat palvelun isännöimistä työkaluista |
Parametrioutput_modalities | Sopimustext |
Parametrihosted_operations | Sopimusfalse |
Parametrimultimodal_input_binding | Sopimusnull |
Elinkaari: synchronous_or_streamed
Lähetä mallin täsmällinen ID yhdessä messages-kentän kanssa.
Kontekstin pituus ei ole tuloksen yläraja.
Tekstitiedosto voi antaa tekstiä sellaisenaan; kuva-, ääni- ja tiedosto-objektisyötteet tarvitsevat täsmällisen sidonnan.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.006 / 1K tokenia Tuloste · Tulostokenit $0.03 / 1K tokenia Syöte · Välimuistin luku $0 / 1K tokenia Syöte · Välimuistiin kirjoitus $0 / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "grok-3", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='grok-3',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='grok-3',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä jokainen vastausvaihtoehto sisältöineen, työkalukutsuineen ja päättelyineen. Kokoa SSE:ssä muutokset vastausvaihtoehdon ja työkalun indeksin mukaan ja säilytä lopullinen päättymissyy sekä käyttötiedot.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttächoices[].index | Tyyppiinteger |
Kenttächoices[].message.content | Tyyppistring|null |
Kenttächoices[].message.tool_calls | Tyyppitool_call[] |
Kenttächoices[].message.reasoning_content | Tyyppistring |
Kenttächoices[].message.reasoning_details | Tyyppiobject|array |
Kenttächoices[].finish_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot Ultra grok-3
Käytä yllä näytettyjä menetelmäpolkuja.
grok-3Grok 3 on xAI:n tekstikeskusteluversio selityksiin, kirjoittamiseen, ohjelmointiin ja annettuun aineistoon perustuviin kysymyksiin. Nimetty malliversio tukee rakenteisia tuloksia ja funktiokutsuja ja eroaa perheen erikseen nimetyistä Think-malleista.
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Grok 3 on xAI:n malliperhe kielitehtäviin, yleistietoon, ohjelmointiin ja ongelmanratkaisuun. Julkaisukuvaus erottaa tavanomaisesti vastaavan mallin perheen erikseen nimetyistä Think-versioista, jotka käyttävät lisäpäättelyä ennen lopullista vastausta. Tässä kuvattu nimetty grok-3-versio on tekstikeskusteluversio: valmistaja ilmoittaa sille tekstisyötteen ja tekstitulosteen eikä erillistä päättelyominaisuutta.
Perheen esikoulutuksen tarkoitus on tukea laajaa kysymysten ja ohjeiden kirjoa. xAI nostaa julkaisukuvauksessa esiin matematiikan, ohjelmoinnin, tiedon ja tyylin hallinnan. Kirjoitustehtävässä tämä tarjoaa hyödyllisen pohjan pyytää mallia muokkaamaan selitystä tietylle lukijalle, säilyttämään määritetyt faktat tai laatimaan yhtenäisen luonnoksen annetuista kohdista. Anna tekniselle avustajalle olennainen aineisto ja määritä kysymys, joka vastauksen on ratkaistava, sen sijaan, että käyttäisit vain yleistä pyyntöä käsitellä aihetta.
Havainnollistava asiakirjatehtävä on: ”Vertaa näitä kahta työnkulun kuvausta. Luettele yhteneväisyydet, ristiriidat ja puuttuvat tiedot ja kirjoita sitten lyhyt selitys uudelle tiimin jäsenelle.” Säilytä lähdeosioiden merkinnät, jotta vastaus voi yhdistää kunkin havainnon oikeaan katkelmaan. Kooditehtävä voi sisältää funktion, odotetun toiminnan ja konkreettisen syötteen, jolla nykyinen tulos on väärä. Pyydä ehdotettu korjaus ja kerro, millä esimerkeillä se tulee tarkistaa. Nämä esimerkit hyödyntävät dokumentoituja kieli- ja ohjelmointitehtävien ryhmiä eivätkä tarkoita, että tuotettu koodi olisi jo suoritettu.
Ero Think-versioihin on tärkeä. Grok 3 -perheen julkistus kuvaa myös Grok 3 Think- ja Grok 3 mini Think -mallit, jotka on koulutettu käyttämään enemmän työtä päättelyyn. Niiden laajennettu ajattelu tulee kuvata omana tilanaan tai mallivaihtoehtonaan. Tavallinen tekstiversio voi antaa selityksiä ja ratkaista kysymyksiä, mutta tätä ei tule sekoittaa erikseen dokumentoidun laajennetun päättelykokoonpanon valintaan.
Valmistajan nimettyä mallia koskeva metatietoesimerkki antaa grok-3-mallin kehotteen enimmäispituudeksi 131 072 tokenia ja ilmoittaa tuen rakenteisille tuloksille ja funktiokutsuille. Kehotteen pituuskenttä kuvaa kyseisessä esimerkissä julkaistua syötebudjettia; se ei ole erillinen tulostetokenien yläraja. Perheen julkistus käsittelee suurempaa pitkän kontekstin kokoonpanoa, joten pidä täsmällisen nimetyn mallin määritys ja laajempi perhekuvaus erillään valmistellessasi pyyntöä. Sisällytä kysymyksen tarvitsema konteksti ja määritä vastauksen muoto ja pituus nimenomaisesti.
Rakenteinen tulos on hyödyllinen, kun keskustelun tulee päättyä kenttiin, joita sovellus voi käsitellä, kuten yhteenvetoon, poimittuihin faktoihin ja yhä tarkennusta tarvitseviin kysymyksiin. Funktiokutsujen avulla sovellus voi tarjota sallittuja toimintoja ja vastaanottaa ehdotettuja argumentteja. Sovellus suorittaa toiminnon ja palauttaa tuloksen seuraavaa vastausta varten. Tämä eroaa siitä, että mallilla olisi itsenäisesti pääsy mihin tahansa tietokantaan, selaimeen tai koodintulkkiin.
Julkaisuartikkeli käsittelee DeepSearchia ja työkaluilla varustettuja agentteja Grok-perheen ympärille rakennettuina järjestelminä. Niiden haku-, suoritus- ja raportointityönkulut muodostavat integraatiokontekstin eivätkä ole peruste siirtää kaikkia sovellusominaisuuksia pelkkään grok-3-tekstiversioon. Kerro hyödyllistä tehtävää varten, mitä annettua aineistoa tai työkalujen palauttamia tietoja mallin tulee käyttää, erota faktat pyydetyistä tulkinnoista ja pyydä sitä merkitsemään puuttuvat tiedot. Päätä tehtävä konkreettiseen tuotokseen: muokattuun asiakirjaan, koodiehdotukseen, poimintatietueeseen tai selitykseen, jota voidaan verrata alkuperäisiin syötteisiin.
POST /v1/messagestextjson, sse| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat grok-3 | Oletus— |
Kenttämessages | Tyyppimessage[] | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämessages[].role | Tyyppistring | VaatimusPakollinen | Arvot & rajat user, assistant | Oletus— |
Kenttämessages[].content | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämax_tokens | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttästream | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat | Oletusfalse |
Teksti · UTF-8-teksti
messages[].content-merkkijono
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, messages, max_tokens |
Parametrioptional_controls | Sopimusstream |
Parametrimaterial_types | Sopimustext |
Parametritext_file_material | SopimusLue varsinainen UTF-8-asiakirja ja sijoita sen teksti ilmoitettuun syöte- tai viestisisällön merkkijonoon. |
Elinkaari: synchronous_or_streamed
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
| Asetukset | Hinnasto | Veloitus |
|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Veloitus Syöte · Syötetokenit $0.006 / 1K tokenia Tuloste · Tulostokenit $0.03 / 1K tokenia Syöte · Välimuistin luku $0 / 1K tokenia Syöte · Välimuistiin kirjoitus $0 / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti — / 1K tokenia |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
{\n "model": "grok-3",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'grok-3', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'grok-3', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON tai SSE
Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.
Säilytä kaikki sisältölohkot, päättelyallekirjoitukset ja todelliset työkalukäytön ID:t. Kokoa kaikki SSE-lohkomuutokset; ensimmäinen tekstilohko ei ole koko tulos.
Säilytä pyyntöjen/vastausten ID:t ja otsakkeet. Yleistä tekstityön haku-URL:ää ei anneta.
| Kenttä | Tyyppi |
|---|---|
Kenttäid | Tyyppistring |
Kenttämodel | Tyyppistring |
Kenttäcontent[] | Tyyppitext|thinking|tool_use|other content block |
Kenttästop_reason | Tyyppistring|null |
Kenttäusage | Tyyppiobject |
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus400 · invalid_request_error | EhtoVirheelliset pakolliset kentät, aineiston esitysmuoto tai parametrin arvo | Seuraava vaiheKorjaa ilmoitetut kentät ennen uutta luontipyyntöä. |
Ailoot Ultra grok-3
Käytä yllä näytettyjä menetelmäpolkuja.
Tekninen esimerkki englanniksi
Revise a technical explanation\n\nRewrite this for a nontechnical office manager in at most 75 words: 'The synchronisation job retries transient transport failures using exponential backoff; repeated requests carry the same operation key to prevent duplicate entries.' Preserve the difference between retrying a failed connection and creating a second record. Use one everyday comparison and no unsupported guarantees.A concise plain-language explanation with one comparison and both retry and duplicate-prevention concepts intact.The rewrite does not imply that every failure is recoverable or that retries always succeed.