Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

input_file in attachment_search v API-ju Responses

Lekcija 4 od 16 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Dve poti do istega bloka
  2. Pot prek file_id
  3. Pot prek file_url
  4. Kaj počne attachment_search
  5. Združevanje več dokumentov
  6. Izbira med obema
  7. Ključne ugotovitve

Dve poti do istega bloka

API Responses za Grok sprejme dokument na dva načina: prek file_id, kar pomeni datoteko, ki ste jo predhodno naložili, ali prek file_url, javnega naslova, ki ga xAI pridobi ob času zahteve. Blok ima v obeh primerih isto ime, input_file, nadaljnja obdelava pa je enaka: Grok aktivira orodje attachment_search in izvleče odlomke, ki odgovarjajo na vaše vprašanje. Razlika je v življenjskem ciklu dokumenta, njegovi zaupnosti in stroških vsakega ponovljenega klica.

Pot prek file_id

Ko datoteko pošljete prek POST /v1/files, se nanjo sklicujete z njenim identifikatorjem, skupaj z vašim vprašanjem v navadnem besedilu:

{
  "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?"
    }
  ]
}

Ta pot ima smisel v treh situacijah. Prva so ponavljajoča se poizvedbe: če vaša pravna ekipa zastavi petnajst zaporednih vprašanj o isti pogodbi, je en sam prenos, ki mu sledi petnajst sklicevanj, boljši od petnajstih prenosov istega PDF-ja. Druga je zaupnost, ko dokument ne sme biti izpostavljen za URL-jem, dostopnim komur koli s povezavo. Tretja je arhitektura vaše aplikacije: če so datoteke vnaprej naložene med nočnim vnosom podatkov, vaši zahtevki obravnavajo le identifikatorje.

Pot prek file_url

Ko je dokument že nekje objavljen, nalaganje postane nepotreben korak in lahko neposredno navedete naslov:

{
  "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 primeri uporabe vključujejo odprto dokumentacijo, ki je ni treba shranjevati, datoteko, gostovano na vaši infrastrukturi za začasnim URL-jem, ali hiter test, kjer želite preveriti hipotezo brez vzpostavitve celotnega cevovoda za nalaganje.

S to priročnostjo so povezane tri omejitve in vse vas v proizvodnem okolju nekaj stanejo. URL mora biti resnično javen, brez avtentikacije: naslov, zaščiten s žetonom ali piškotkom, vrne xAI-ju stran z napako, ki jo bo model vestno analiziral namesto vašega dokumenta. Prenos podaljša čas obdelave zahteve, zaradi česar so veliki PDF-ji bistveno počasnejši kot pri uporabi file_id. Nazadnje, na strani xAI ni predpomnilnika: vsak klic znova prenese datoteko, zato en sam dokument, po katerem se poizveduje petdesetkrat na dan, prečka omrežje petdesetkrat.

Takoj ko se v vaši zahtevi pojavi input_file, Grok brez vaše konfiguracije sproži attachment_search. Obdelava poteka v štirih korakih:

  1. Izvleček vsebine iz datoteke: besedilo, tabele, struktura
  2. Začasno indeksiranje te vsebine za čas trajanja zahteve
  3. Iskanje ustreznih odlomkov na podlagi vašega vprašanja
  4. Vstavljanje izsekov v kontekst modela

Osredotočite se na pridevnik „začasno” v drugem koraku, saj pojasnjuje razliko v stroških, ki jo mnogi odkrijejo prepozno: indeks se ob vsakem klicu znova zgradi in nato izgine. To je ravno težava, ki jo zbirke rešujejo s trajnim indeksiranjem. Upoštevajte tudi, da model v svojem odgovoru navede odlomke, ki jih je dejansko uporabil, kar vam omogoča preverjanje njegovega dela, namesto da bi mu slepo verjeli.

Združevanje več dokumentov

Ni vam treba omejiti se na eno datoteko na zahtevo. Z zlaganjem več blokov input_file od modela zahtevate sklepanje po celotnem nizu:

{
  "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 in navzkrižno poveže informacije za odgovor, kar odpira vrata četrtletnim primerjavam, pregledom zaporednih različic pogodb ali soočanjem med specifikacijo in njeno implementacijo.

Izbira med obema

Merilofile_idfile_url
Predhodno nalaganjeDaNe
Zaupna datotekaPriporočljivoOdsvetovano
Ponavljajoča se poizvedbaUčinkovito (1 nalaganje)Počasno (ponovni prenos)
Javna datotekaMogočeIdealno
Upravljanje življenjskega ciklaVi nadzorujeteOdvisno od gostitelja

Ključne ugotovitve

  • input_file s file_id se sklicuje na naloženo datoteko, file_url pa na javni dokument
  • Orodje attachment_search se samodejno aktivira za izvleček ustrezne vsebine
  • V eni zahtevi lahko združite več datotek
  • Za zaupne ali pogosto poizvedovane datoteke raje uporabite file_id
  • Za javne dokumente ali hitre teste raje uporabite file_url