Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Indholdsformat: simpel streng og objekt-array

Lektion 3 af 12 Opdateret 30. juli 2026 Udvikler
På denne side
  1. To formater til feltet content
  2. Strengformat: det mest almindelige tilfælde
  3. Array-format: multimodalt indhold
  4. Hvornår skal du bruge hvilket format?
  5. Tekniske begrænsninger for billeder
  6. Vigtige pointer

To formater til feltet content

Feltet content i hver besked accepterer to forskellige formater i xAI Chat Completions API. Valget afhænger af, hvad du sender til modellen: ren tekst eller multimodalt indhold (tekst + billeder).

Strengformat: det mest almindelige tilfælde

Til rent tekstbeskeder er feltet content en simpel streng:

{
  "role": "user",
  "content": "Forklar, hvordan en transformer fungerer."
}

Dette er det format, du vil bruge i langt de fleste tilfælde. Det er simpelt, læsbart og tilstrækkeligt til alle tekstinteraktioner med Grok.

Til system-beskeden bruges strengformatet næsten altid:

{
  "role": "system",
  "content": "Du er en ekspert i softwarearkitektur. Svar på engelsk med Python-kodeeksempler."
}

Array-format: multimodalt indhold

Når du skal sende billeder sammen med tekst, bliver feltet content til et array af typede objekter. Hvert objekt har et type-felt, der angiver dets natur.

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "Hvad viser dette billede?"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/photo.jpg",
        "detail": "high"
      }
    }
  ]
}

Tilgængelige objekttyper

Content-arrayet accepterer to objekttyper:

  • text: en tekstblok med egenskaben text
  • image_url: en reference til et billede med egenskaben image_url

Du kan kombinere så mange objekter, som du har brug for, i en enkelt besked. For eksempel for at bede modellen om at sammenligne to billeder:

{
  "role": "user",
  "content": [
    {"type": "text", "text": "Sammenlign disse to arkitekturdiagrammer."},
    {"type": "image_url", "image_url": {"url": "https://example.com/schema-v1.png"}},
    {"type": "image_url", "image_url": {"url": "https://example.com/schema-v2.png"}}
  ]
}

Parameteren detail for billeder

Hvert image_url-objekt accepterer en valgfri parameter detail, der styrer analyseopløsningen:

  • auto: modellen vælger automatisk detaljeringsniveauet (standardværdi)
  • low: hurtig og økonomisk analyse, tilstrækkelig til simple billeder (ikoner, basale diagrammer)
  • high: detaljeret analyse, anbefalet til komplekse billeder (dokumenter, fotografier, grænseflader)
{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/document-scan.jpg",
    "detail": "high"
  }
}

Valget af detaljeringsniveau påvirker direkte antallet af forbrugte tokens og dermed omkostningerne ved anmodningen.

Hvornår skal du bruge hvilket format?

Reglen er simpel:

  • Kun tekst → strengformat (enklere, mere læsbart)
  • Tekst + billeder → array-format (kræves til multimodale data)
  • Kun billeder → array-format med kun image_url-objekter

Et array-format med et enkelt text-objekt er funktionelt ækvivalent med strengformatet, men unødigt verbost:

// Ækvivalent, men unødigt komplekst
{"content": [{"type": "text", "text": "Hej"}]}

// Foretræk denne form
{"content": "Hej"}

Tekniske begrænsninger for billeder

Før du sender billeder til xAI API, skal du huske på disse grænser:

  • Maksimal størrelse: 20 MiB pr. billede
  • Accepterede formater: Kun JPG, JPEG, PNG (ingen GIF, WebP eller SVG)
  • Antal: ingen begrænsning på antallet af billeder pr. anmodning
  • Kompatible modeller: kun grok-4.5 og højere

Billeder kan leveres via en offentlig URL eller kodet i base64 direkte i URL’en (format data:image/jpeg;base64,...).

Vigtige pointer

  • Feltet content accepterer enten en simpel streng (tekst) eller et objekt-array (multimodalt)
  • Array-formatet bruger objekter med et type-felt: "text" eller "image_url"
  • Parameteren detail (auto, low, high) styrer analyseopløsningen for billeder
  • Billeder er begrænset til 20 MiB i JPG/PNG og kræver grok-4.5 eller højere
  • Brug strengformatet, når du kun sender tekst – det er mere læsbart og enklere