Imagebestanden: URL en Base64
Op deze pagina
Bijgewerkt op 3 november 2026. Met de Responses API gaan
input_image- eninput_text-objecten naar decontentvan een bericht{"role": "user", ...}, niet direct naarinput. Het Python-voorbeeld riep eerderclient.responses.create()aan op dexai-sdk-client, wat deze methode niet heeft, en schreef de API-sleutel in de code: het gebruikt nuuser(...)enimage(...)uit de SDK, waarbij de sleutel uit de omgeving wordt gelezen. Waarschuwing van xAI over geschiedenisopslag toegevoegd. Code geverifieerd metxai-sdk1.21.0. Bron: Image Understanding.
Afbeeldingen verzenden naar Grok
Grok-modellen vanaf grok-4.5 beschikken over visuele mogelijkheden. U kunt een of meer afbeeldingen in uw API-verzoeken opnemen; het model analyseert deze om uw vragen te beantwoorden. Dit noemen we beeldbegrip, of multimodale visie.
Voordat we ingaan op use-cases, is het essentieel om de twee indelingsformaten voor afbeeldingen die door de xAI-API worden ondersteund, onder de knie te krijgen.
Directe URL
De eenvoudigste methode is het verstrekken van de openbare URL van een afbeelding. Het model downloadt en analyseert deze automatisch.
Met de Responses API (hoofdeindpunt):
{
"model": "grok-4.5",
"input": [
{
"role": "user",
"content": [
{
"type": "input_image",
"image_url": "https://exemple.com/photo-produit.jpg"
},
{
"type": "input_text",
"text": "Beschrijf deze afbeelding gedetailleerd."
}
]
}
]
}
xAI raadt aan om bij het verzenden van afbeeldingen de verzoek- en antwoordgeschiedenis niet op hun servers op te slaan, anders kan het verzoek mislukken: geef bij de Responses API "store": false mee.
Met de Chat Completions API (verouderd, compatibel met OpenAI):
{
"model": "grok-4.5",
"messages": [
{
"role": "user",
"content": [
{
"type": "image_url",
"image_url": {
"url": "https://exemple.com/photo-produit.jpg"
}
},
{
"type": "text",
"text": "Beschrijf deze afbeelding gedetailleerd."
}
]
}
]
}
De URL moet verwijzen naar een openbaar toegankelijk afbeeldingsbestand. Als de afbeelding achter authenticatie of een beveiligde CDN staat, gebruikt u in plaats daarvan het Base64-formaat.
Base64-gecodeerd (Data URI)
Het tweede formaat houdt in dat de afbeelding direct in het verzoek wordt gecodeerd als een Base64-tekenreeks, voorafgegaan door een MIME-voorvoegsel. Dit is de ideale methode wanneer u werkt met lokale afbeeldingen, screenshots of dynamisch gegenereerde bestanden.
{
"type": "input_image",
"image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}
Het voorvoegsel data:image/jpeg;base64, vertelt het model het MIME-type van de afbeelding. Pas dit aan op basis van het formaat:
data:image/jpeg;base64,voor JPG/JPEG-bestandendata:image/png;base64,voor PNG-bestanden
Een afbeelding coderen in Python
import base64
with open("photo.jpg", "rb") as f:
image_data = base64.standard_b64encode(f.read()).decode("utf-8")
image_url = f"data:image/jpeg;base64,{image_data}"
Coderen in JavaScript/Node.js
import { readFileSync } from 'fs';
const imageData = readFileSync('photo.jpg').toString('base64');
const imageUrl = `data:image/jpeg;base64,${imageData}`;
Belangrijkste verschillen tussen URL en Base64
| Criterium | URL | Base64 |
|---|---|---|
| Grootte verzoek | Lichtgewicht (alleen de URL) | Zwaar (+33% t.o.v. originele bestand) |
| Toegankelijkheid | Openbare afbeelding vereist | Werkt met elk lokaal bestand |
| Latentie | Serverdownload | Gegevens direct in verzoek |
| Typische use-case | Webafbeeldingen, CDN, cloudopslag | Lokale bestanden, screenshots, uploads |
Tekst en afbeeldingen combineren
De content van een bericht accepteert een gemengde array van input_image- en input_text-objecten, in willekeurige volgorde: u kunt tekst en afbeeldingen vrij afwisselen. Met de native xAI SDK wordt hetzelfde bericht opgebouwd met user(), dat tekst en afbeeldingen accepteert die door image() in sequentie zijn gemaakt:
from xai_sdk import Client
from xai_sdk.chat import image, user
client = Client() # sleutel gelezen uit XAI_API_KEY
chat = client.chat.create(model="grok-4.5")
chat.append(
user(
"Vergelijk deze twee foto's:",
image(image_url="https://exemple.com/photo1.jpg", detail="high"),
image(image_url="https://exemple.com/photo2.jpg", detail="high"),
"Wat zijn de belangrijkste verschillen?",
)
)
response = chat.sample()
print(response.content)
image() accepteert een openbare URL of een Base64 Data URI.
Belangrijkste punten
- Twee afbeeldingsformaten worden ondersteund: Directe URL en Base64 (Data URI)
- Alleen de formaten JPG, JPEG en PNG worden geaccepteerd
- Elke afbeelding mag niet groter zijn dan 20 MiB
- Het aantal afbeeldingen per verzoek is onbeperkt
- De Responses API plaatst
input_imagein decontentvan een bericht; Chat Completions gebruiktimage_url-onderdelen; de xAI SDK gebruiktimage()binnenuser() - Geef de voorkeur aan URL voor openbare afbeeldingen en Base64 voor lokale bestanden