Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

input_file i attachment_search u Responses API-ju

Lekcija 4 od 16 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Dva puta do istog bloka
  2. Put putem file_id
  3. Put putem file_url
  4. Što radi attachment_search
  5. Kombiniranje više dokumenata
  6. Odabir između ova dva
  7. Ključne točke

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.

Čim se input_file pojavi u tvom zahtjevu, Grok pokreće attachment_search bez ikakve tvoje konfiguracije. Obrada se odvija u četiri koraka:

  1. Ekstrakcija sadržaja iz datoteke: tekst, tablice, struktura
  2. Privremeno indeksiranje tog sadržaja, za trajanje zahtjeva
  3. Pretraživanje relevantnih odlomaka na temelju tvog pitanja
  4. 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

Kriterijfile_idfile_url
Prethodni prijenosDaNe
Povjerljiva datotekaPreporučenoNepreporučeno
Ponovljeni upitiPerformantno (1 prijenos)Sporo (ponovno preuzimanje)
Javna datotekaMogućeIdealno
Upravljanje životnim ciklusomTi kontrolirašOvisi o hostu

Ključne točke

  • input_file s file_id referencira prenesenu datoteku, file_url javni dokument
  • Alat attachment_search automatski se aktivira za ekstrakciju relevantnog sadržaja
  • Možeš kombinirati više datoteka u jednom zahtjevu
  • Preferiraj file_id za povjerljive ili često upitivane datoteke
  • Preferiraj file_url za javne dokumente ili brze testove