Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Slanje slike putem URL-a

Lekcija 4 od 12 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Najjednostavnija metoda
  2. Format poruke
  3. Potpuni Python primjer
  4. Dodavanje sistemske upute (System Prompt)
  5. Zahtjevi za URL
  6. Slike iz cloud pohrane
  7. Rukovanje greškama
  8. Ključne točke

Najjednostavnija metoda

Slanje slike putem URL-a najizravniji je način korištenja Vision API-ja: dostavljaš adresu javno dostupne slike, a Mistral je preuzima radi analize. Tvoj zahtjev ostaje lagan – svega nekoliko stotina bajtova – jer sadrži samo poveznicu.

Daj prednost ovoj metodi kada su tvoje slike već hostirane na CDN-u, u cloud pohrani ili na web-mjestu, ili kada radiš s javnim web-slikama. Tim koji već pohranjuje vizuale proizvoda na CDN-u može ih početi analizirati bez promjene svoje infrastrukture.

Format poruke

Višemodalna poruka s URL-om slike slijedi ovu strukturu:

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

Polje image_url prihvaća bilo koji HTTP ili HTTPS URL koji vodi do valjane slikovne datoteke u formatu JPEG, PNG, GIF ili WebP.

Potpuni Python primjer

Evo potpunog skripta spremnog za pokretanje koji analizira javnu sliku s Wikimedije, pod pretpostavkom da je tvoj API ključ postavljen u okruženju:

from mistralai.client import Mistral
import os

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

# Javna slika za analizu
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Poziv Vision API-ja
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)

Imaj na umu da ključ prosljeđujemo putem os.environ, a ne hardkodiranjem. To je jedini prihvatljiv pristup čim skripta napusti tvoje lokalno računalo.

Dodavanje sistemske upute (System Prompt)

Gornji odgovor bit će točan, ali generičan – „crni mrav na zamućenoj pozadini“. Sistemska poruka mijenja prirodu analize dodjeljivanjem uloge modelu prije nego što on vidi sliku:

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

S ovim okvirom, ista slika rezultirat će taksonomskom identifikacijom i morfološkim opisom. Sistemska uputa usmjerava način na koji model analizira sliku – moćan alat za dobivanje specijaliziranih odgovora uz cijenu od samo nekoliko desetaka tokena.

Zahtjevi za URL

API mora moći preuzeti sliku bez ikakvog konteksta iz tvoje sesije. To dovodi do četiri zahtjeva: URL mora biti javno dostupan (bez stranica iza autentifikacije); mora voditi izravno do datoteke, a ne do HTML stranice koja sadrži sliku; format mora biti podržan (JPEG, PNG, GIF gdje se čita samo prvi kadar, ili WebP); a veličina mora ostati razumna, ispod 20 MB.

Najčešća zabuna odnosi se na poveznice za dijeljenje. Google Drive ili Dropbox poveznica „podijeljena sa svima“ vraća HTML stranicu, a ne slikovnu datoteku: poziv ne uspijeva ili model opisuje web sučelje. Najbolja praksa je provjeriti Content-Type prije slanja:

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

Zahtjev HEAD je dovoljan: dohvaća zaglavlja bez preuzimanja datoteke.

Slike iz cloud pohrane

Ovaj zahtjev za javnom dostupnošću čini se nespojivim s povjerljivim dokumentima. Rješenje leži u unaprijed potpisanim URL-ovima (pre-signed URLs): ako su tvoje slike u S3 spremniku, Google Cloud Storageu ili Azure Blobovu, generiraš privremenu adresu koja odobrava pristup jednom objektu na trajanje koje odrediš.

import boto3

s3 = boto3.client("s3")

# Generiranje unaprijed potpisanog URL-a vrijedi 1 sat
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Korištenje ovog URL-a s Vision API-jem
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}
            ]
        }
    ]
)

Tvoj spremnik ostaje privatan, URL istječe nakon određenog kašnjenja, a zadržavaš laganu prirodu zahtjeva. Postavi ExpiresIn što je kraće moguće: nekoliko minuta više je nego dovoljno za API poziv.

Rukovanje greškama

Poziv koji ovisi o udaljenom preuzimanju može ne uspjeti iz razloga izvan tvoje kontrole – slika je izbrisana, URL je istekao ili je poslužitelj domaćin nedostupan. U proizvodnji nikada nemoj dopustiti da sirova iznimka ispliva do korisnika:

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

Testiraj svoje rukovanje greškama s namjerno nevaljanim URL-om prije implementacije: to je najčešći scenarij i onaj koji se najrjeđe testira.

Ključne točke

  • Slanje putem URL-a najjednostavnija je metoda – potreban ti je samo javni URL
  • Polje content poruke niz je koji sadrži elemente text i image_url
  • URL mora voditi izravno do dostupne slikovne datoteke
  • Unaprijed potpisani URL-ovi omogućuju sigurno korištenje privatnih slika
  • Uvijek dodaj sistemsku uputu kako bi usmjerio/la analizu modela