input_file og attachment_search i Responses API
På denne side
To veje til samme blok
Grok Responses API accepterer et dokument på to måder: via file_id, hvilket betyder en fil, du tidligere har uploadet, eller via file_url, en offentlig adresse, som xAI henter på anmodningstidspunktet. Blokken bruger det samme navn i begge tilfælde, input_file, og den efterfølgende behandling er identisk: Grok aktiverer værktøjet attachment_search og udtrækker de passager, der besvarer dit spørgsmål. Det, der ændrer sig, er dokumentets livscyklus, dets fortrolighed og omkostningerne ved hvert gentagne kald.
Vejen med file_id
Når du har sendt filen via POST /v1/files, refererer du til den ved hjælp af dens identifikator sammen med dit spørgsmål i klartekst:
{
"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?"
}
]
}
Denne vej giver mening i tre situationer. Den første er gentagne forespørgsler: Hvis dit juridiske team stiller femten på hinanden følgende spørgsmål om den samme kontrakt, er én upload efterfulgt af femten referencer bedre end femten overførsler af den samme PDF. Den anden er fortrolighed, når dokumentet ikke må være eksponeret bag en URL, der er tilgængelig for alle med linket. Den tredje er din applikationsarkitektur: Hvis filer uploades på forhånd under nightly ingestion, håndterer dine forespørgsler kun identifikatorer.
Vejen med file_url
Når dokumentet allerede er offentliggjort et sted, bliver upload et unødvendigt trin, og du kan pege direkte på adressen:
{
"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."
}
]
}
Typiske brugstilfælde omfatter åben dokumentation, du ikke har nogen grund til at gemme, en fil hostet på din egen infrastruktur bag en midlertidig URL, eller en hurtig test, hvor du vil verificere en hypotese uden at opsætte en hel upload-pipeline.
Tre begrænsninger følger med denne bekvemmelighed, og de koster dig alle sammen i produktion. URL’en skal være virkelig offentlig uden godkendelse: En adresse beskyttet af et token eller en cookie returnerer en fejlside til xAI, som modellen flittigt vil analysere i stedet for dit dokument. Downloadet lægger sig til forespørgslens behandlingstid, hvilket gør store PDF’er betydeligt langsommere end med file_id. Endelig findes der ingen cache på xAI’s side: Hvert kald gen-downloader filen, så et enkelt dokument, der forespørges halvtreds gange om dagen, krydser netværket halvtreds gange.
Hvad attachment_search gør
Så snart en input_file dukker op i din forespørgsel, udløser Grok attachment_search uden nogen konfiguration fra din side. Behandlingen foregår i fire trin:
- Indholdsekstraktion fra filen: tekst, tabeller, struktur
- Midlertidig indeksering af dette indhold for forespørgslens varighed
- Søgning efter relevante passager baseret på dit spørgsmål
- Indsættelse af uddrag i modellens kontekst
Fokuser på adjektivet „midlertidig” i det andet trin, for det forklarer en omkostningsforskel, som mange opdager for sent: Indekset genopbygges ved hvert kald og forsvinder bagefter. Dette er præcis det problem, som collections løser med vedvarende indeksering. Bemærk også, at modellen citerer de passager, den faktisk har brugt i sit svar, så du kan verificere dens arbejde i stedet for blot at tage dens ord for det.
Kombination af flere dokumenter
Intet tvinger dig til at holde dig til én fil pr. forespørgsel. Ved at stable flere input_file-blokke beder du modellen om at ræsonnere på tværs af sættet:
{
"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 analyserer begge dokumenter og krydsrefererer information for at svare, hvilket åbner døren til kvartalsvise sammenligninger, gennemgange af successive kontraktversioner eller konfrontationer mellem en specifikation og dens implementering.
Valg mellem de to
| Kriterium | file_id | file_url |
|---|---|---|
| Forudgående upload | Ja | Nej |
| Fortrolig fil | Anbefales | Frarådes |
| Gentagne forespørgsler | Ydedygtig (1 upload) | Langsom (gen-download) |
| Offentlig fil | Mulig | Ideel |
| Livscyklusstyring | Du styrer | Afhænger af host |
Vigtige pointer
input_filemedfile_idrefererer til en uploadet fil,file_urltil et offentligt dokument- Værktøjet
attachment_searchaktiveres automatisk for at udtrække relevant indhold - Du kan kombinere flere filer i en enkelt forespørgsel
- Foretræk
file_idtil fortrolige eller hyppigt forespurgte filer - Foretræk
file_urltil offentlige dokumenter eller hurtige tests