Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Skicka en bild via URL

Lektion 4 av 12 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Den enklaste metoden
  2. Meddelandeformat
  3. Komplett Python-exempel
  4. Lägga till en systemprompt
  5. Krav på URL:er
  6. Bilder från molnlagring
  7. Felhantering
  8. Viktiga punkter

Den enklaste metoden

Att skicka en bild via URL är det mest direkta sättet att använda Vision API: du anger adressen till en offentligt tillgänglig bild, så laddar Mistral ner den för analys. Din begäran förblir lättviktig – några hundra byte – eftersom den bara innehåller en länk.

Prioritera denna metod när dina bilder redan finns på en CDN, i molnlagring eller på en webbplats, eller när du arbetar med offentliga webbbilder. Ett team som redan lagrar produktbilder på en CDN kan börja analysera dem utan att ändra sin infrastruktur.

Meddelandeformat

Ett multimodalt meddelande med en bild-URL följer denna struktur:

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

Fältet image_url accepterar vilken HTTP- eller HTTPS-URL som helst som pekar på en giltig bildfil i formaten JPEG, PNG, GIF eller WebP.

Komplett Python-exempel

Här är ett komplett, körklart skript som analyserar en offentlig bild från Wikimedia, under förutsättning att din API-nyckel är inställd i miljön:

from mistralai.client import Mistral
import os

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

# Public image to analyze
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Call the Vision API
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)

Observera att vi skickar nyckeln via os.environ istället för att hardkoda den. Detta är det enda acceptabla tillvägagångssättet så snart skriptet lämnar din lokala dator.

Lägga till en systemprompt

Svaret ovan kommer att vara korrekt men generiskt – “en svart myra på en suddig bakgrund”. Ett systemmeddelande ändrar analysens karaktär genom att tilldela modellen en roll innan den ser bilden:

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}
            ]
        }
    ]
)

Med denna inramning ger samma bild en taxonomisk identifiering och en morfologisk beskrivning. Systemprompten styr hur modellen analyserar bilden – en kraftfull hävstång för att få specialiserade svar till kostnaden av bara några dussin token.

Krav på URL:er

API:t måste kunna ladda ner bilden utan någon kontext från din session. Detta leder till fyra krav: URL:en måste vara offentligt tillgänglig (inga sidor bakom autentisering); den måste peka direkt på filen, inte på en HTML-sida som innehåller bilden; formatet måste stödjas (JPEG, PNG, GIF där endast den första ramen läses, eller WebP); och storleken måste vara rimlig, under 20 MB.

Den vanligaste förvirringen gäller delningslänkar. En Google Drive- eller Dropbox-länk som är “delad med alla” returnerar en HTML-sida, inte en bildfil: anropet misslyckas, eller så beskriver modellen ett webbgränssnitt. Bästa praxis är att verifiera Content-Type innan du skickar:

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")

En HEAD-begäran räcker: den hämtar rubriker utan att ladda ner filen.

Bilder från molnlagring

Detta krav på offentlig tillgänglighet verkar oförenligt med konfidentiella dokument. Lösningen ligger i försignerade URL:er: om dina bilder finns i en S3-bucket, Google Cloud Storage eller Azure Blob genererar du en temporär adress som ger åtkomst till ett enskilt objekt under en tid du anger.

import boto3

s3 = boto3.client("s3")

# Generate a pre-signed URL valid for 1 hour
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Use this URL with the 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}
            ]
        }
    ]
)

Din bucket förblir privat, URL:en upphör efter den angivna tiden, och du behåller begärans lättviktiga natur. Ställ in ExpiresIn så kort som möjligt: några minuter räcker gott och väl för ett API-anrop.

Felhantering

Ett anrop som beror på en fjärrnedladdning kan misslyckas av skäl du inte kontrollerar – bilden har raderats, URL:en har löpt ut eller värdservern är otillgänglig. I produktion får du aldrig låta det råa undantaget bubbla upp till användaren:

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}")

Testa din felhantering med en avsiktligt ogiltig URL innan du distribuerar: detta är det vanligaste scenariot och det som testas minst ofta.

Viktiga punkter

  • Att skicka via URL är den enklaste metoden – en offentlig URL är allt du behöver
  • Fältet content i meddelandet är en array som innehåller elementen text och image_url
  • URL:en måste peka direkt på en tillgänglig bildfil
  • Försignerade URL:er låter dig använda privata bilder på ett säkert sätt
  • Lägg alltid till en systemprompt för att styra modellens analys