Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Nosūtīt attēlu, izmantojot URL

Nodarbība 4 no 12 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Vienkāršākā metode
  2. Ziņojuma formāts
  3. Pilns Python piemērs
  4. Sistēmas uzvednes pievienošana
  5. URL prasības
  6. Attēli no mākoņkrātuvēm
  7. Kļūdu apstrāde
  8. Galvenās atziņas

Vienkāršākā metode

Attēla nosūtīšana, izmantojot URL, ir visdirektākais veids, kā izmantot Vision API: tu norādi publiski pieejama attēla adresi, un Mistral to lejupielādē analīzei. Tavs pieprasījums paliek viegls – tikai dažus simtus baitu –, jo tas satur tikai saiti.

Dod priekšroku šai metodei, ja tavi attēli jau ir izvietoti CDN, mākoņkrātuvē vai tīmekļa vietnē, vai arī ja strādā ar publiskiem tīmekļa attēliem. Komanda, kas jau glabā produktu vizuālos materiālus CDN, var sākt tos analizēt, nemainot savu infrastruktūru.

Ziņojuma formāts

Daudzmodāls ziņojums ar attēla URL atbilst šādai struktūrai:

message = {
    "role": "user",
    "content": [
        {
            "type": "text",
            "text": "Tavs jautājums par attēlu"
        },
        {
            "type": "image_url",
            "image_url": "https://example.com/my-image.jpg"
        }
    ]
}

Lauks image_url pieņem jebkuru HTTP vai HTTPS URL, kas norāda uz derīgu attēla failu JPEG, PNG, GIF vai WebP formātā.

Pilns Python piemērs

Šeit ir pilns, gatavs palaišanam skripts, kas analizē publisku attēlu no Wikimedia, pieņemot, ka tava API atslēga ir iestatīta vidē:

from mistralai.client import Mistral
import os

# Inicizē klientu
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Publisks attēls analīzei
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Izsauc Vision API
response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Precīzi apraksti, ko redzi šajā attēlā."
                },
                {
                    "type": "image_url",
                    "image_url": url_image
                }
            ]
        }
    ]
)

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

Ņem vērā, ka mēs nododam atslēgu, izmantojot os.environ, nevis iekodējot to tieši kodā. Tas ir vienīgais pieņemamais risinājums, kad skripts pamet tavu lokālo datoru.

Sistēmas uzvednes pievienošana

Iepriekšējā atbilde būs pareiza, bet vispārīga – „melnā skudra uz izplūduša fona”. Sistēmas ziņojums maina analīzes raksturu, piešķirot modelim lomu pirms tas aplūko attēlu:

response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "system",
            "content": "Tu esi entomoloģijas eksperts. Analizē kukaiņu attēlus ar zinātnisku precizitāti, identificējot sugu, dzimtu un redzamās morfoloģiskās īpašības."
        },
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Identificē šo kukaini."},
                {"type": "image_url", "image_url": url_image}
            ]
        }
    ]
)

Ar šādu ietvaru tas pats attēls nodrošina taksonomisku identifikāciju un morfoloģisku aprakstu. Sistēmas uzvedne virza to, kā modelis analizē attēlu – tas ir spēcīgs instruments specializētu atbilžu iegūšanai, iztērējot tikai dažus desmitus tokenus.

URL prasības

API ir jāspēj lejupielādēt attēlu bez jebkāda konteksta no tavas sesijas. No tā izriet četras prasības: URL ir jābūt publiski pieejamam (nav lapu aiz autentifikācijas); tam ir jānorāda tieši uz failu, nevis uz HTML lapu, kas satur attēlu; formātam ir jābūt atbalstītam (JPEG, PNG, GIF, kur tiek nolasīts tikai pirmais kadrs, vai WebP); un izmēram ir jāpaliek saprātīgām robežās – zem 20 MB.

Visbiežākā neskaidrība saistīta ar koplietošanas saitēm. Google Drive vai Dropbox saite, kas „koplietota ar visiem”, atgriež HTML lapu, nevis attēla failu: izsaukums neizdodas vai modelis apraksta tīmekļa saskarni. Labākā prakse ir pārbaudīt Content-Type pirms nosūtīšanas:

import requests

def verify_image_url(url):
    """Pārbauda, vai URL norāda uz pieejamu attēlu."""
    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"Attēls pieejams: {content_type}, {size / 1024:.0f} KB")
            return True
        else:
            print(f"Problēma: status={response.status_code}, type={content_type}")
            return False
    except requests.RequestException as e:
        print(f"Savienojuma kļūda: {e}")
        return False

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

HEAD pieprasījums ir pietiekams: tas iegūst galvenes, nelejupielādējot failu.

Attēli no mākoņkrātuvēm

Šī publiskās pieejamības prasība šķiet nesavienojama ar konfidenciāliem dokumentiem. Risinājums slēpjas iepriekš parakstītajos URL: ja tavi attēli atrodas S3 bucket, Google Cloud Storage vai Azure Blob, tu ģenerē pagaidu adresi, kas piešķir piekļuvi vienam objektam uz tavu noteiktu laiku.

import boto3

s3 = boto3.client("s3")

# Ģenerē iepriekš parakstītu URL, derīgu 1 stundu
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Izmanto šo URL ar Vision API
response = client.chat.complete(
    model="mistral-small-latest",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Izvilc no šī rēķina kopējo summu."},
                {"type": "image_url", "image_url": presigned_url}
            ]
        }
    ]
)

Tavs bucket paliek privāts, URL zaudē spēku pēc noteiktā laika, un tu saglabā pieprasījuma vieglumu. Iestati ExpiresIn pēc iespējas īsāku: dažas minūtes ir vairāk nekā pietiekami API izsaukumam.

Kļūdu apstrāde

Izsaukums, kas ir atkarīgs no attālinātas lejupielādes, var neizdoties iemeslu dēļ, kurus tu nevari kontrolēt – attēls ir dzēsts, URL ir beidzies derīguma termiņš vai mitināšanas serveris nav pieejams. Produkcijas vidē nekad nepieļauj, lai neapstrādāts izņēmums nonāktu līdz lietotājam:

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": "Apraksti šo attēlu."},
                    {"type": "image_url", "image_url": "https://example.com/image.jpg"}
                ]
            }
        ]
    )
    print(response.choices[0].message.content)
except Exception as e:
    print(f"Kļūda: {e}")

Pirms izvietošanas pārbaudi savu kļūdu apstrādi, izmantojot apzināti nederīgu URL: tas ir visbiežāk sastopamais scenārijs un vienlaikus visretāk testētais.

Galvenās atziņas

  • Nosūtīšana, izmantojot URL, ir vienkāršākā metode – pietiek ar publisku URL
  • Ziņojuma lauks content ir masīvs, kas satur elementus text un image_url
  • URL ir jānorāda tieši uz pieejamu attēla failu
  • Iepriekš parakstīti URL ļauj droši izmantot privātus attēlus
  • Vienmēr pievieno sistēmas uzvedni, lai virzītu modeļa analīzi