input_file en attachment_search in de Responses API
Op deze pagina
Twee wegen naar hetzelfde blok
De Grok Responses API accepteert een document op twee manieren: via file_id, wat verwijst naar een bestand dat u eerder hebt geüpload, of via file_url, een openbaar adres dat xAI op het moment van het verzoek ophaalt. Het blok gebruikt in beide gevallen dezelfde naam, input_file, en de downstream-verwerking is identiek: Grok activeert de attachment_search-tool en haalt de fragmenten eruit die uw vraag beantwoorden. Wat verandert, is de levenscyclus van het document, de vertrouwelijkheid ervan en de kosten van elke herhaalde aanroep.
Het file_id-pad
Zodra u het bestand via POST /v1/files verzendt, verwijst u ernaar met zijn identifier, samen met uw vraag in platte tekst:
{
"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?"
}
]
}
Dit pad is zinvol in drie situaties. De eerste is herhaalde query’s: als uw juridische team vijftien opeenvolgende vragen stelt over hetzelfde contract, wint een enkele upload gevolgd door vijftien verwijzingen het van vijftien transfers van dezelfde PDF. De tweede is vertrouwelijkheid, wanneer het document niet blootgesteld mag worden achter een URL die voor iedereen met de link toegankelijk is. De derde is uw applicatie-architectuur: als bestanden tijdens nachtelijke ingestie vooraf worden geüpload, verwerken uw verzoeken alleen identifiers.
Het file_url-pad
Wanneer het document al ergens gepubliceerd is, wordt uploaden een overbodige stap en kunt u direct naar het adres verwijzen:
{
"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."
}
]
}
Typische use cases zijn open documentatie die u geen reden hebt om op te slaan, een bestand dat op uw eigen infrastructuur staat achter een tijdelijke URL, of een snelle test waarbij u een hypothese wilt verifiëren zonder een volledige upload-pipeline op te zetten.
Aan dit gemak kleven drie beperkingen, en allemaal kosten ze u geld in productie. De URL moet echt openbaar zijn, zonder authenticatie: een adres dat beveiligd is met een token of cookie, retourneert een foutpagina aan xAI, die het model ijverig zal analyseren in plaats van uw document. De download voegt tijd toe aan de verwerking van het verzoek, waardoor grote PDF’s aanzienlijk trager zijn dan bij file_id. Tot slot is er geen cache aan de kant van xAI: elke aanroep downloadt het bestand opnieuw, dus een enkel document dat vijftig keer per dag wordt bevraagd, steekt vijftig keer het netwerk over.
Wat attachment_search doet
Zodra er een input_file in uw verzoek verschijnt, activeert Grok attachment_search zonder enige configuratie aan uw kant. De verwerking verloopt in vier stappen:
- Inhoudsextractie uit het bestand: tekst, tabellen, structuur
- Tijdelijke indexering van deze inhoud, voor de duur van het verzoek
- Zoeken naar relevante fragmenten op basis van uw vraag
- Injectie van fragmenten in de modelcontext
Leg de nadruk op het bijvoeglijk naamwoord “tijdelijk” in de tweede stap, want dit verklaart een kostenverschil dat velen te laat ontdekken: de index wordt bij elke aanroep opnieuw opgebouwd en verdwijnt daarna. Dit is precies het probleem dat collections oplossen met persistente indexering. Merk ook op dat het model de fragmenten citeert die het daadwerkelijk in zijn antwoord heeft gebruikt, zodat u zijn werk kunt verifiëren in plaats van het zomaar aan te nemen.
Meerdere documenten combineren
Niets dwingt u om bij één bestand per verzoek te blijven. Door meerdere input_file-blokken te stapelen, vraagt u het model om redeneringen over de set heen uit te voeren:
{
"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 analyseert beide documenten en kruisverwijst informatie om te antwoorden, wat de deur opent naar kwartaalvergelijkingen, reviews van opeenvolgende contractversies, of confrontaties tussen een specificatie en de implementatie ervan.
Kiezen tussen de twee
| Criterium | file_id | file_url |
|---|---|---|
| Voorafgaande upload | Ja | Nee |
| Vertrouwelijk bestand | Aanbevolen | Afgeraden |
| Herhaalde query’s | Performant (1 upload) | Traag (opnieuw downloaden) |
| Openbaar bestand | Mogelijk | Ideaal |
| Levenscyclusbeheer | U heeft controle | Hangt af van host |
Belangrijkste punten
input_filemetfile_idverwijst naar een geüpload bestand,file_urlnaar een openbaar document- De
attachment_search-tool activeert automatisch om relevante inhoud te extraheren - U kunt meerdere bestanden combineren in één verzoek
- Geef de voorkeur aan
file_idvoor vertrouwelijke of vaak bevraagde bestanden - Geef de voorkeur aan
file_urlvoor openbare documenten of snelle tests