Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Een afbeelding verzenden via URL

Les 4 van 12 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. De eenvoudigste methode
  2. Berichtformaat
  3. Volledig Python-voorbeeld
  4. Een systeemprompt toevoegen
  5. Vereisten voor URL’s
  6. Afbeeldingen uit cloudopslag
  7. Foutafhandeling
  8. Belangrijkste punten

De eenvoudigste methode

Het verzenden van een afbeelding via een URL is de meest directe manier om de Vision API te gebruiken: u geeft het adres op van een publiek toegankelijke afbeelding, en Mistral downloadt deze voor analyse. Uw verzoek blijft lichtgewicht—enkele honderden bytes—omdat het slechts een link bevat.

Geef deze methode voorrang wanneer uw afbeeldingen al gehost worden op een CDN, cloudopslag of website, of wanneer u werkt met publieke webafbeeldingen. Een team dat productvisuals al op een CDN opslaat, kan direct beginnen met de analyse zonder de infrastructuur aan te passen.

Berichtformaat

Een multimodaal bericht met een afbeeldings-URL volgt deze structuur:

message = {
    "role": "user",
    "content": [
        {
            "type": "text",
            "text": "Your question about the image"
        },
        {
            "type": "image_url",
            "image_url": "https://example.com/my-image.jpg"
        }
    ]
}

Het veld image_url accepteert elke HTTP- of HTTPS-URL die verwijst naar een geldig afbeeldingsbestand in JPEG-, PNG-, GIF- of WebP-formaat.

Volledig Python-voorbeeld

Hier volgt een compleet, direct uitvoerbaar script dat een publieke afbeelding van Wikimedia analyseert, ervan uitgaande dat uw API-sleutel in de omgeving is ingesteld:

from mistralai.client import Mistral
import os

# Initialiseer de client
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Publieke afbeelding om te analyseren
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Roep de Vision API aan
response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Describe precisely what you see in this image."
                },
                {
                    "type": "image_url",
                    "image_url": url_image
                }
            ]
        }
    ]
)

print(response.choices[0].message.content)

Merk op dat we de sleutel via os.environ doorgeven in plaats van deze hardcoden. Dit is de enige aanvaardbare aanpak zodra het script uw lokale machine verlaat.

Een systeemprompt toevoegen

Het bovenstaande antwoord zal correct maar generiek zijn: “een zwarte mier op een wazige achtergrond”. Een systeembericht verandert de aard van de analyse door het model een rol toe te wijzen voordat het de afbeelding bekijkt:

response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "system",
            "content": "You are an entomology expert. Analyze insect images with scientific precision, identifying the species, family, and visible morphological characteristics."
        },
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Identify this insect."},
                {"type": "image_url", "image_url": url_image}
            ]
        }
    ]
)

Met deze context levert dezelfde afbeelding een taxonomische identificatie en een morfologische beschrijving op. De systeemprompt stuurt hoe het model de afbeelding analyseert—een krachtig instrument om gespecialiseerde antwoorden te verkrijgen voor de kostprijs van slechts enkele tientallen tokens.

Vereisten voor URL’s

De API moet de afbeelding kunnen downloaden zonder enige context van uw sessie. Dit leidt tot vier vereisten: de URL moet publiek toegankelijk zijn (geen pagina’s achter authenticatie); deze moet direct naar het bestand verwijzen, niet naar een HTML-pagina die de afbeelding bevat; het formaat moet ondersteund worden (JPEG, PNG, GIF waarbij alleen het eerste frame wordt gelezen, of WebP); en de grootte moet redelijk blijven, onder de 20 MB.

De meest voorkomende verwarring betreft deellinks. Een Google Drive- of Dropbox-link die “met iedereen gedeeld” is, retourneert een HTML-pagina, geen afbeeldingsbestand: de call faalt, of het model beschrijft een webinterface. De beste praktijk is om het Content-Type-header te verifiëren voordat u verzendt:

import requests

def verify_image_url(url):
    """Verify that a URL points to an accessible image."""
    try:
        response = requests.head(url, timeout=5, allow_redirects=True)
        content_type = response.headers.get("Content-Type", "")

        if response.status_code == 200 and "image" in content_type:
            size = int(response.headers.get("Content-Length", 0))
            print(f"Image accessible: {content_type}, {size / 1024:.0f} KB")
            return True
        else:
            print(f"Issue: status={response.status_code}, type={content_type}")
            return False
    except requests.RequestException as e:
        print(f"Connection error: {e}")
        return False

verify_image_url("https://example.com/photo.jpg")

Een HEAD-request is voldoende: deze haalt de headers op zonder het bestand te downloaden.

Afbeeldingen uit cloudopslag

Deze vereiste van publieke toegankelijkheid lijkt onverenigbaar met vertrouwelijke documenten. De oplossing ligt in pre-signed URLs: als uw afbeeldingen zich in een S3-bucket, Google Cloud Storage of Azure Blob bevinden, genereert u een tijdelijk adres dat toegang verleent tot één object voor een door u bepaalde duur.

import boto3

s3 = boto3.client("s3")

# Genereer een pre-signed URL geldig voor 1 uur
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Gebruik deze URL met de Vision API
response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Extract the total amount from this invoice."},
                {"type": "image_url", "image_url": presigned_url}
            ]
        }
    ]
)

Uw bucket blijft privé, de URL verloopt na de opgegeven tijd, en u behoudt het lichtgewicht karakter van het verzoek. Stel ExpiresIn zo kort mogelijk in: enkele minuten zijn meer dan genoeg voor een API-call.

Foutafhandeling

Een call die afhankelijk is van een remote download kan om redenen buiten uw controle mislukken—de afbeelding is verwijderd, de URL is verlopen, of de hostingserver is niet beschikbaar. Laat in productie nooit de rauwe exception doordringen tot de gebruiker:

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

try:
    response = client.chat.complete(
        model="mistral-small-latest",
        messages=[
            {
                "role": "user",
                "content": [
                    {"type": "text", "text": "Describe this image."},
                    {"type": "image_url", "image_url": "https://example.com/image.jpg"}
                ]
            }
        ]
    )
    print(response.choices[0].message.content)
except Exception as e:
    print(f"Error: {e}")

Test uw foutafhandeling met een bewust ongeldige URL voordat u implementeert: dit is het meest voorkomende scenario en het scenario dat het minst vaak getest wordt.

Belangrijkste punten

  • Verzenden via URL is de eenvoudigste methode—een publieke URL is alles wat u nodig hebt
  • Het veld content van het bericht is een array met elementen text en image_url
  • De URL moet direct verwijzen naar een toegankelijk afbeeldingsbestand
  • Pre-signed URLs stellen u in staat privé-afbeeldingen veilig te gebruiken
  • Voeg altijd een systeemprompt toe om de analyse van het model te sturen