Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

input_file och attachment_search i Responses API

Lektion 4 av 16 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Två vägar till samma block
  2. Vägen via file_id
  3. Vägen via file_url
  4. Vad attachment_search gör
  5. Kombinera flera dokument
  6. Att välja mellan de två
  7. Viktiga punkter

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:

  1. Innehållsextraktion från filen: text, tabeller, struktur
  2. Tillfällig indexering av detta innehåll, under begärans varaktighet
  3. Sökning efter relevanta passager baserat på din fråga
  4. 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å

Kriteriumfile_idfile_url
Föregående uppladdningJaNej
Konfidentiell filRekommenderasAvråds från
Upprepade förfrågningarPrestanda (1 uppladdning)Långsamt (omnedladdning)
Offentlig filMöjligtIdealt
LivscykelhanteringDu kontrollerarBeror på värd

Viktiga punkter

  • input_file med file_id refererar till en uppladdad fil, file_url till ett offentligt dokument
  • Verktyget attachment_search aktiveras automatiskt för att extrahera relevant innehåll
  • Du kan kombinera flera filer i en enda begäran
  • Föredra file_id för konfidentiella eller ofta förfrågade filer
  • Föredra file_url för offentliga dokument eller snabba tester