Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Siųsti vaizdą per URL

Paskaita 4 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Kūrėjas
Šiame puslapyje
  1. Paprasčiausias būdas
  2. Žinutės formatas
  3. Pilnas „Python“ pavyzdys
  4. Sistemos raginimo pridėjimas
  5. URL reikalavimai
  6. Vaizdai iš debesijos saugyklų
  7. Klaidų apdorojimas
  8. Svarbiausi punktai

Paprasčiausias būdas

Vaizdo siuntimas per URL yra tiesiogiausias būdas naudoti „Vision“ API: pateikiate viešai pasiekiamo vaizdo adresą, o „Mistral“ jį atsisiunčia analizei. Jūsų užklausa lieka lengva – tik keli šimtai baitų, nes joje yra tik nuoroda.

Teikite pirmenybę šiam metodui, kai jūsų vaizdai jau talpinami CDN, debesijos saugykloje arba svetainėje, arba kai dirbate su viešais interneto vaizdais. Komanda, kuri jau saugo produktų vizualizacijas CDN, gali pradėti jas analizuoti nekeisdama savo infrastruktūros.

Žinutės formatas

Daugiamodė žinutė su vaizdo URL turi šią struktūrą:

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

Laukas image_url priima bet kokį HTTP arba HTTPS URL, nukreipiantį į tinkamą vaizdo failą JPEG, PNG, GIF arba WebP formatu.

Pilnas „Python“ pavyzdys

Štai pilnas, paruoštas paleisti scenarijus, analizuojantis viešą vaizdą iš „Wikimedia“, darant prielaidą, kad jūsų API raktas nustatytas aplinkos kintamuosiuose:

from mistralai.client import Mistral
import os

# Inicijuoti klientą
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Viešas vaizdas analizei
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Iškviesti „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)

Atkreipk dėmesį, kad raktą perduodame per os.environ, o ne įtraukiame tiesiai į kodą. Tai vienintelis priimtinas būdas, kai scenarijus palieka tavo vietinį kompiuterį.

Sistemos raginimo pridėjimas

Aukščiau gautas atsakymas bus teisingas, bet bendro pobūdžio – „juodas skruzdėlynas neryškiame fone“. Sistemos žinutė pakeičia analizės pobūdį, priskirdama modeliuo vaidmenį prieš jam peržiūrint vaizdą:

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

Taip suformuluotas užklausimas tame pačiame vaizde suteikia taksonominį identifikavimą ir morfologinį aprašymą. Sistemos raginimas nukreipia, kaip modelis analizuoja vaizdą – tai galingas svertas specializuotiems atsakymams gauti, kainuojantis tik kelias dešimtis tokenų.

URL reikalavimai

API turi galėti atsisiųsti vaizdą be jokio tavo sesijos konteksto. Iš to išplaukia keturi reikalavimai: URL turi būti viešai pasiekiamas (jokių puslapių už autentifikavimo); jis turi nukreipti tiesiai į failą, o ne į HTML puslapį, kuriame yra vaizdas; formatas turi būti palaikomas (JPEG, PNG, GIF, kur nuskaitytas tik pirmas kadras, arba WebP); o dydis turi būti protingas – mažesnis nei 20 MB.

Dažniausia painiava kyla dėl bendrinimo nuorodų. „Google Drive“ arba „Dropbox“ nuoroda, „bendrainama su visais“, grąžina HTML puslapį, o ne vaizdo failą: užklausa nepavyksta arba modelis aprašo žiniatinklio sąsają. Geriausia praktika – prieš siunčiant patikrinti Content-Type:

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

HEAD užklausos pakanka: ji gauna antraštes neatsisiųsdama failo.

Vaizdai iš debesijos saugyklų

Šis viešo prieinamumo reikalavimas atrodo nesuderinamas su konfidencialiais dokumentais. Sprendimas – išankstinio pasirašymo URL (pre-signed URLs): jei tavo vaizdai yra „S3“ kibire, „Google Cloud Storage“ arba „Azure Blob“, sugeneruoji laikiną adresą, suteikiantį prieigą prie vieno objekto tavo nurodytą laikotarpį.

import boto3

s3 = boto3.client("s3")

# Sugeneruoti išankstinio pasirašymo URL, galiojantį 1 valandą
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Naudoti šį URL su „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}
            ]
        }
    ]
)

Tavo kibiras lieka privatus, URL galiojimas baigiasi po nurodyto laiko, o užklausos lengvumas išlieka. Nustatyk ExpiresIn kuo trumpesnį: kelioms minutėms visiškai pakanka API užklausai atlikti.

Klaidų apdorojimas

Užklausa, priklausanti nuo nuotolinio atsisiuntimo, gali nepavykti dėl nuo tavęs nepriklausančių priežasčių – vaizdas ištrintas, URL galiojimas baigėsi arba talpinimo serveris nepasiekiamas. Gamybinėje aplinkoje niekada neleisk neapdorotai išimčiai pasiekti naudotojo:

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

Prieš diegdami išbandykite klaidų apdorojimą su tyčia neteisingu URL: tai dažniausias scenarijus, kuris rečiausiai būna testuojamas.

Svarbiausi punktai

  • Siuntimas per URL yra paprasčiausias būdas – pakanka viešo URL
  • Žinutės laukas content yra masyvas, kuriame yra text ir image_url elementų
  • URL turi nukreipti tiesiai į pasiekiamą vaizdo failą
  • Išankstinio pasirašymo URL leidžia saugiai naudoti privačius vaizdus
  • Visada pridėk sistemos raginimą, kad nukreiptum modelio analizę