Lähe põhisisu juurde
Eesti— Vali keel
Menüü

X Search'i API-s lubamine

Õppetund 8 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Ligipääs X-i andmetele reaalajas
  2. X Search’i võimalused
  3. Põhiline aktiveerimine
  4. SDK aktiveerimine
  5. Kombineeri X Search ja veebiotsing
  6. Peamised erinevused veebiotsingust
  7. Peamised punktid

Ligipääs X-i andmetele reaalajas

X Search on Grok API-le omane ainulaadne sisseehitatud tööriist. See võimaldab mudelil otsida reaalajas postitusi, profiile ja lõngu platvormil X (varem Twitter). See annab Grokile märkimisväärse eelise teiste keelemudelite API-de ees, millel tavaliselt puudub otsene ligipääs sotsiaalvõrgustikele.

𝕏
Native search
10
Filterable handles
🎥
Video supported
$5
/ 1,000 calls

X Search’i võimalused

X Search pakub nelja otsingurežiimi:

  • Märksõnaotsing: leiab postitusi, mis sisaldavad konkreetseid termineid
  • Semantiline otsing: leiab teemaga seotud postitusi, isegi kui täpsed sõnad puuduvad
  • Kasutajaotsing: tuvastab asjakohased profiilid
  • Lõngude toomine: annab juurdepääsu terviklikele arutelulõngadele

Mudel valib automaatselt kasutaja päringule kõige sobivama režiimi.

Põhiline aktiveerimine

Aktiveerimine toimib samamoodi nagu veebiotsingu (Web Search) puhul. Lisa massiivi tools objekt {"type": "x_search"}:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What are developers saying about the latest React update?",
  "tools": [
    {"type": "x_search"}
  ]
}

Mudel otsib automaatselt X-ist asjakohaseid postitusi ja lõimib need koos vastavate viidetega oma vastusesse.

SDK aktiveerimine

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()]

Kombineeri X Search ja veebiotsing

Saad mõlemad tööriistad samaaegselt lubada, et mudel saaks ristviidata teavet veebist ja sotsiaalvõrgustikest:

{
  "tools": [
    {"type": "web_search"},
    {"type": "x_search"}
  ]
}

Mudel otsustab küsimuse põhjal, kumbat kasutada – või mõlemat. Avaliku arvamuse kohta käiv küsimus eelistab X Search’i, samas kui faktiline küsimus eelistab veebiotsingut.

Peamised erinevused veebiotsingust

OmadusVeebiotsingX Search
AllikasKogu veebAinult X/Twitter
FiltreerimineDomeeni järgi (max 5)Kasutajanime järgi (max 10)
KuupäevadPole saadavalfrom_date / to_date
Pildidenable_image_understandingenable_image_understanding
VideoPole saadavalenable_video_understanding
Hind5 $ / 1000 päringut5 $ / 1000 päringut

Video mõistmine on eranditult X Search’i funktsioon. See võimaldab mudelil analüüsida X-i postitatud videote sisu.

Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve koostamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.

Peamised punktid

  • X Search on Grok API eksklusiivne eelis
  • Aktiveerimiseks lisa massiivi tools väärtus {"type": "x_search"}
  • Neli otsingurežiimi: märksõnad, semantika, kasutajad, lõngud
  • Kombineeritav veebiotsinguga teabe ristviitamiseks
  • Toetab piltide ja videote mõistmist (eksklusiivne)