Indholdsformat: simpel streng og objekt-array
På denne side
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 egenskabentextimage_url: en reference til et billede med egenskabenimage_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
contentaccepterer 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