Ota X-haku käyttöön rajapinnassa
Tällä sivulla
Käytä X:n dataa reaaliajassa
X-haku on ainutlaatuinen, sisäänrakennettu työkalu, joka on tarkoitettu nimenomaan Grok-rajapinnalle. Se antaa mallin hakea viestejä, profiileja ja keskusteluketjuja X:stä (entinen Twitter) reaaliajassa. Tämä tarjoaa Grokille merkittävän kilpailuedun muihin kielimalleihin verrattuna, sillä niillä ei yleensä ole suoraa pääsyä sosiaalisiin verkkoihin.
X-haun ominaisuudet
X-haku tarjoaa neljä hakutilaa:
- Avainsanahaku: löytää viestejä, jotka sisältävät tiettyjä termejä
- Semanttinen haku: löytää aiheeseen liittyviä viestejä, vaikka tarkkoja sanoja ei käytettäisi
- Käyttäjähaku: tunnistaa asiaankuuluvia profiileja
- Ketjujen nouto: pääsy kokonaisiin keskusteluketjuihin
Malli valitsee automaattisesti käyttäjän pyyntöön parhaiten sopivan tilan.
Peruskäyttöönotto
Käyttöönotto toimii samalla tavalla kuin verkkohaku. Lisäät {"type": "x_search"} kohdan tools-taulukkoon:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are developers saying about the latest React update?",
"tools": [
{"type": "x_search"}
]
}
Malli hakee automaattisesti X:stä asiaankuuluvia viestejä ja sisällyttää ne vastaukseensa asianmukaisin viittauksin.
SDK-käyttöönotto
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Yhdistä X-haku ja verkkohaku
Voit ottaa molemmat työkalut käyttöön samanaikaisesti, jolloin malli voi ristiviitata tietoja verkosta ja sosiaalisista verkostoista:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Malli päättää kumpaa käyttää – tai käyttääkö molempia – esitetyn kysymyksen perusteella. Yleiseen mielipiteeseen liittyvä kysymys suosii X-hakua, kun taas faktuaalinen kysymys suosii verkkohakua.
Keskeiset erot verkkohakuun verrattuna
| Ominaisuus | Verkkohaku | X-haku |
|---|---|---|
| Lähde | Koko verkko | Vain X/Twitter |
| Suodatus | Verkkotunnuksen mukaan (max 5) | Käyttäjätunnuksen mukaan (max 10) |
| Päivämäärät | Ei saatavilla | from_date / to_date |
| Kuvat | enable_image_understanding | enable_image_understanding |
| Video | Ei saatavilla | enable_video_understanding |
| Hinta | 5 $ / 1 000 pyyntöä | 5 $ / 1 000 pyyntöä |
Videoiden ymmärtäminen on yksinomaan X-haun ominaisuus. Tämä toiminto antaa mallille mahdollisuuden analysoida X:ään ladattujen videoiden sisältöä.
Hinnoittelu 5.8.2026 alkaen – hinnat muuttuvat säännöllisesti: ennen budjetin laskemista tarkista ajantasainen hintataulukko xAI:n viralliselta mallit ja hinnoittelu -sivulta.
Keskeiset asiat
- X-haku on Grok-rajapinnan yksinoikeus
- Käyttöönotto tapahtuu lisäämällä
{"type": "x_search"}kohtaantools - Neljä hakutilaa: avainsanat, semanttinen haku, käyttäjät, ketjut
- Yhdistettävissä verkkohakuun tietojen ristiviittaamiseksi
- Tukee kuvien ja videoiden ymmärtämistä (yksinoikeus)