input_file och attachment_search i Responses API
På denna sida
Två vägar till samma block
Grok Responses API accepterar ett dokument på två sätt: via file_id, vilket innebär en fil du tidigare har laddat upp, eller via file_url, en offentlig adress som xAI hämtar vid begäran. Blocket använder samma namn i båda fallen, input_file, och den efterföljande bearbetningen är identisk: Grok aktiverar verktyget attachment_search och extraherar de passager som svarar på din fråga. Det som skiljer sig är dokumentets livscykel, dess konfidentialitet och kostnaden för varje upprepad anrop.
Vägen via file_id
När du har skickat filen via POST /v1/files refererar du till den med dess identifierare, tillsammans med din fråga i klartext:
{
"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?"
}
]
}
Denna väg är meningsfull i tre situationer. Den första är upprepade förfrågningar: om ditt juridiska team ställer femton efterföljande frågor om samma kontrakt, slår en enda uppladdning följd av femton referenser femton överföringar av samma PDF. Den andra är konfidentialitet, när dokumentet inte får exponeras bakom en URL som är tillgänglig för alla med länken. Den tredje är din applikationsarkitektur: om filer laddas upp i förväg under nattlig datainmatning hanterar dina förfrågningar endast identifierare.
Vägen via file_url
När dokumentet redan är publicerat någonstans blir uppladdning ett onödigt steg och du kan peka direkt 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."
}
]
}
Typiska användningsfall inkluderar öppen dokumentation som du inte har någon anledning att lagra, en fil som hostas på din egen infrastruktur bakom en tillfällig URL, eller ett snabbt test där du vill verifiera en hypotes utan att sätta upp en hel uppladdningspipeline.
Tre begränsningar följer med denna bekvämlighet, och alla kostar dig i produktion. URL:en måste vara verkligen offentlig, utan autentisering: en adress skyddad av en token eller kaka returnerar en felsida till xAI, vilket modellen flitigt kommer att analysera istället för ditt dokument. Nedladdningen läggs till i begärans bearbetningstid, vilket gör stora PDF-filer betydligt långsammare än med file_id. Slutligen finns det ingen cache på xAI:s sida: varje anrop laddar ner filen på nytt, så ett enda dokument som frågas ut femtio gånger om dagen korsar nätverket femtio gånger.
Vad attachment_search gör
Så snart en input_file dyker upp i din begäran utlöser Grok attachment_search utan någon konfiguration från din sida. Bearbetningen sker i fyra steg:
- Innehållsextraktion från filen: text, tabeller, struktur
- Tillfällig indexering av detta innehåll, under begärans varaktighet
- Sökning efter relevanta passager baserat på din fråga
- Inmatning av utdrag i modellens kontext
Fokusera på adjektivet “tillfällig” i det andra steget, eftersom det förklarar en kostnadsskillnad som många upptäcker för sent: indexet byggs om vid varje anrop och försvinner efteråt. Detta är precis problemet som samlingar (collections) löser med persistent indexering. Observera också att modellen citerar de passager den faktiskt använde i sitt svar, så att du kan verifiera dess arbete istället för att bara lita på dess ord.
Kombinera flera dokument
Inget tvingar dig att hålla dig till en fil per begäran. Genom att stapla flera input_file-block ber du modellen att resonera över hela mängden:
{
"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 analyserar båda dokumenten och korsreferenserar information för att svara, vilket öppnar dörren för kvartalsvisa jämförelser, granskningar av successiva kontraktsversioner eller konfrontationer mellan en specifikation och dess implementering.
Att välja mellan de två
| Kriterium | file_id | file_url |
|---|---|---|
| Föregående uppladdning | Ja | Nej |
| Konfidentiell fil | Rekommenderas | Avråds från |
| Upprepade förfrågningar | Prestanda (1 uppladdning) | Långsamt (omnedladdning) |
| Offentlig fil | Möjligt | Idealt |
| Livscykelhantering | Du kontrollerar | Beror på värd |
Viktiga punkter
input_filemedfile_idrefererar till en uppladdad fil,file_urltill ett offentligt dokument- Verktyget
attachment_searchaktiveras automatiskt för att extrahera relevant innehåll - Du kan kombinera flera filer i en enda begäran
- Föredra
file_idför konfidentiella eller ofta förfrågade filer - Föredra
file_urlför offentliga dokument eller snabba tester