Indelingsformaat van inhoud
Op deze pagina
De twee invoerformaten van Grok
Wanneer u een bericht naar Grok verzendt, kan het veld content in elk bericht een van twee verschillende vormen aannemen. Het begrijpen van dit onderscheid is belangrijk, omdat het bepaalt wat u naar het model kunt sturen: alleen tekst of een mix van tekst en afbeeldingen.
Eenvoudige tekstreeks
De meest directe vorm: de inhoud is een eenvoudige reeks (string). U gebruikt dit voor het merendeel van uw tekstgebaseerde interacties.
{
"role": "user",
"content": "Explain the advantages of the Rust language compared to C++"
}
Dit formaat werkt voor alle puur tekstgebaseerde taken: vragen, instructies, het verstrekken van gegevens of verzoeken tot generatie. Gebruik dit formaat wanneer u geen visuele elementen hoeft op te nemen.
Getypeerde objectarray
Voor multimodale verzoeken (tekst + afbeeldingen) accepteert Grok een array van objecten, waarbij elk element een veld type bevat dat de aard ervan aangeeft.
Formaat voor Chat Completions (verouderd eindpunt)
{
"role": "user",
"content": [
{"type": "text", "text": "Describe this user interface and suggest improvements"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/screenshot.png", "detail": "high"}}
]
}
Formaat voor Responses (primair eindpunt)
{
"input": [
{"type": "input_text", "text": "Analyze this chart and extract the main trends"},
{"type": "input_image", "image_url": "https://exemple.com/graphique.png"}
]
}
Let op het naamgevingsverschil tussen de twee eindpunten: text en image_url voor Chat Completions, input_text en input_image voor Responses.
Tekst en afbeeldingen combineren
Met de objectarray kunt u tekst en afbeeldingen vrijelijk in elke willekeurige volgorde mengen. U kunt meerdere afbeeldingen in hetzelfde verzoek verzenden, met tekst ervoor, erna of ertussen.
{
"role": "user",
"content": [
{"type": "text", "text": "Compare these two interface mockups:"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/maquette-v1.png"}},
{"type": "text", "text": "Version 1 above, version 2 below:"},
{"type": "image_url", "image_url": {"url": "https://exemple.com/maquette-v2.png"}},
{"type": "text", "text": "Identify the main differences and recommend the best version."}
]
}
Geaccepteerde afbeeldingsbronnen
Grok accepteert afbeeldingen op twee manieren:
- Directe URL: een HTTPS-link naar de online gehoste afbeelding
- Base64-gecodeerd: de afbeelding direct ingesloten in het verzoek als data-URI
{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQ..."}}
Het Base64-formaat is handig wanneer uw afbeeldingen niet online gehost zijn (lokale screenshots, afbeeldingen gegenereerd door uw applicatie).
De parameter detail voor afbeeldingen
Elke afbeelding kan een parameter detail ontvangen die het analyseniveau bepaalt:
- auto: het model kiest automatisch (standaardgedrag)
- low: snelle en zuinige analyse, verbruikt minder tokens
- high: gedetailleerde analyse, verbruikt meer tokens maar legt fijne details vast
{"type": "image_url", "image_url": {"url": "https://...", "detail": "low"}}
Gebruik low voor eenvoudige taken (classificatie, algemene beschrijving) en high voor precieze analyses (OCR, detaildetectie, grafieken lezen).
Technische beperkingen
Houd rekening met deze limieten wanneer u met afbeeldingen werkt:
- Maximale grootte: 20 MB per afbeelding
- Geaccepteerde formaten: alleen JPG, JPEG, PNG
- Geen limiet op het aantal afbeeldingen per verzoek
- Compatibele modellen: grok-4.5 en hoger
- Afbeeldingen verbruiken tussen de 256 en 1.792 tokens, afhankelijk van hun grootte en detailniveau
Praktijkoefening
Test beide formaten met een eenvoudige taak:
Eenvoudig tekstformaat:
{"role": "user", "content": "What are the 5 fundamental principles of UX design?"}
Array-formaat (alleen tekst, maar gestructureerd):
{
"role": "user",
"content": [
{"type": "text", "text": "Context: I'm designing a mobile food delivery application."},
{"type": "text", "text": "Question: what are the 5 most important UX principles for this type of application?"}
]
}
Zelfs zonder afbeelding stelt het array-formaat u in staat om context en vraag duidelijk van elkaar te scheiden, wat de relevantie van het antwoord kan verbeteren.
Belangrijkste punten
- Inhoud kan een eenvoudige reeks (platte tekst) of een objectarray (multimodaal) zijn
- Het array-formaat stelt u in staat tekst en afbeeldingen in elke willekeurige volgorde te mengen
- Er bestaan twee naamgevingsformaten, afhankelijk van het eindpunt: Chat Completions versus Responses
- De parameter
detailbepaalt de diepgang van de afbeeldingsanalyse (low, auto, high) - Afbeeldingen verbruiken tokens: pas het detailniveau aan uw behoeften aan
- Met het Base64-formaat kunt u afbeeldingen verzenden zonder ze online te hosten