input_file i attachment_search u Responses API-ju
Na ovoj stranici
Dva puta do istog bloka
Grok Responses API prihvaća dokument na dva načina: putem file_id, što znači datoteku koju si prethodno prenio/la, ili putem file_url, javne adrese koju xAI dohvaća u trenutku zahtjeva. Blok u oba slučaja nosi isto ime, input_file, a daljnja obrada je identična: Grok aktivira alat attachment_search i izvlači odlomke koji odgovaraju na tvoje pitanje. Ono što se mijenja jest životni ciklus dokumenta, njegova povjerljivost i trošak svakog ponovljenog poziva.
Put putem file_id
Nakon što pošalješ datoteku putem POST /v1/files, referenciraš je njezinim identifikatorom, uz svoje pitanje u običnom tekstu:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_abc123"
},
{
"type": "input_text",
"text": "What are the main risks mentioned in this report?"
}
]
}
Ovaj put ima smisla u tri situacije. Prva su ponovljeni upiti: ako tvoj pravni tim postavi petnaest uzastopnih pitanja o istom ugovoru, jedno prijenos followed by petnaest referenci bolje je od petnaest prijenosa istog PDF-a. Druga je povjerljivost, kada dokument ne smije biti izložen iza URL-a dostupnog svakome tko ima poveznicu. Treća je arhitektura tvoje aplikacije: ako se datoteke unaprijed učitavaju tijekom noćne ingestije, tvoji zahtjevi obrađuju samo identifikatore.
Put putem file_url
Kada je dokument već negdje objavljen, prijenos postaje nepotreban korak i možeš izravno ukazati na adresu:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_url": "https://exemple.com/specifications-api.pdf"
},
{
"type": "input_text",
"text": "Summarize the endpoints described in this documentation."
}
]
}
Tipični slučajevi uporabe uključuju otvorenu dokumentaciju koju nemaš razloga pohranjivati, datoteku hostiranu na tvojoj infrastrukturi iza privremenog URL-a ili brzi test gdje želiš verificirati hipotezu bez postavljanja cijelog cjevovoda za prijenos.
S ovom pogodnošću dolaze tri ograničenja, a sva te koštaju u proizvodnji. URL mora biti stvarno javan, bez autentifikacije: adresu zaštićenu tokenom ili kolačićem xAI vraća kao stranicu s greškom, koju će model marljivo analizirati umjesto tvog dokumenta. Preuzimanje dodaje vrijeme obrade zahtjeva, čineći velike PDF-ove znatno sporijima nego s file_id. Konačno, ne postoji predmemorija na strani xAI-a: svaki poziv ponovno preuzima datoteku, pa jedan dokument upitan pedeset puta dnevno prelazi mrežu pedeset puta.
Što radi attachment_search
Čim se input_file pojavi u tvom zahtjevu, Grok pokreće attachment_search bez ikakve tvoje konfiguracije. Obrada se odvija u četiri koraka:
- Ekstrakcija sadržaja iz datoteke: tekst, tablice, struktura
- Privremeno indeksiranje tog sadržaja, za trajanje zahtjeva
- Pretraživanje relevantnih odlomaka na temelju tvog pitanja
- Umetanje isječaka u kontekst modela
Usredotoči se na pridjev „privremeno“ u drugom koraku, jer on objašnjava razliku u troškovima koju mnogi otkriju prekasno: indeks se gradi iznova pri svakom pozivu i nakon toga nestaje. To je upravo problem koji kolekcije rješavaju trajnim indeksiranjem. Imaj na umu i da model navodi odlomke koje je stvarno koristio u svom odgovoru, omogućujući ti da verificiraš njegov rad umjesto da mu vjeruješ na riječ.
Kombiniranje više dokumenata
Ništa te ne prisiljava da se držiš jedne datoteke po zahtjevu. Slaganjem više blokova input_file tražiš od modela da rezonira kroz skup:
{
"model": "grok-4.5",
"input": [
{
"type": "input_file",
"file_id": "file_rapport_q1"
},
{
"type": "input_file",
"file_id": "file_rapport_q2"
},
{
"type": "input_text",
"text": "Compare the Q1 and Q2 results."
}
]
}
Grok analizira oba dokumenta i unakrsno referencira informacije kako bi odgovorio, što otvara vrata kvartalnim usporedbama, pregledima uzastopnih verzija ugovora ili suočavanjima između specifikacije i njezine implementacije.
Odabir između ova dva
| Kriterij | file_id | file_url |
|---|---|---|
| Prethodni prijenos | Da | Ne |
| Povjerljiva datoteka | Preporučeno | Nepreporučeno |
| Ponovljeni upiti | Performantno (1 prijenos) | Sporo (ponovno preuzimanje) |
| Javna datoteka | Moguće | Idealno |
| Upravljanje životnim ciklusom | Ti kontroliraš | Ovisi o hostu |
Ključne točke
input_filesfile_idreferencira prenesenu datoteku,file_urljavni dokument- Alat
attachment_searchautomatski se aktivira za ekstrakciju relevantnog sadržaja - Možeš kombinirati više datoteka u jednom zahtjevu
- Preferiraj
file_idza povjerljive ili često upitivane datoteke - Preferiraj
file_urlza javne dokumente ili brze testove