Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Imagebestanden: URL en Base64

Les 1 van 12 Bijgewerkt op 3 november 2026 Beginner
Op deze pagina
  1. Afbeeldingen verzenden naar Grok
  2. Directe URL
  3. Base64-gecodeerd (Data URI)
  4. Belangrijkste verschillen tussen URL en Base64
  5. Tekst en afbeeldingen combineren
  6. Belangrijkste punten

Bijgewerkt op 3 november 2026. Met de Responses API gaan input_image- en input_text-objecten naar de content van een bericht {"role": "user", ...}, niet direct naar input. Het Python-voorbeeld riep eerder client.responses.create() aan op de xai-sdk-client, wat deze methode niet heeft, en schreef de API-sleutel in de code: het gebruikt nu user(...) en image(...) uit de SDK, waarbij de sleutel uit de omgeving wordt gelezen. Waarschuwing van xAI over geschiedenisopslag toegevoegd. Code geverifieerd met xai-sdk 1.21.0. Bron: Image Understanding.

Afbeeldingen verzenden naar Grok

Grok analyseert een afbeelding 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.

2
Ondersteunde formaten
20 MiB
Maximale grootte per afbeelding
JPG/PNG
Geaccepteerde formaten
Onbeperkt
Aantal afbeeldingen

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-bestanden
  • data: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_image in de content van een bericht; Chat Completions gebruikt image_url-onderdelen; de xAI SDK gebruikt image() binnen user()
  • Geef de voorkeur aan URL voor openbare afbeeldingen en Base64 voor lokale bestanden