Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ibgħat Immaġni permezz ta' URL

Lezzjoni 4 / 12 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. L-aktar metodu sempliċi
  2. Il-format tal-messaġġ
  3. Eżempju sħiħ f’Python
  4. Żieda ta’ prompt tas-sistema
  5. Rekwiżiti tal-URL
  6. Immaġnijiet mill-ħażna tas-sħaba
  7. Ġestjoni tal-iżbalji
  8. Punti Ewlenin

L-aktar metodu sempliċi

L-ibgħat ta’ immaġni permezz ta’ URL huwa l-aktar mod dirett biex tuża l-Vision API: inti tipprovdi l-indirizz ta’ immaġni aċċessibbli pubblikament, u Mistral tnizzilha għall-analiżi. It-talba tiegħek tibqa’ ħafifa—ftit mijiet ta’ bytes—peress li ġġorr biss link.

Agħżel dan il-metodu meta l-immaġnijiet tiegħek diġà huma ospitati fuq CDN, ħażna tas-sħaba, jew sit web, jew meta tkun qed taħdem ma’ immaġnijiet pubbliċi tal-web. Tim li diġà jaħżen viżwali tal-prodotti fuq CDN jista’ jibda janalizzahom mingħajr ma jbiddel l-infrastruttura tiegħu.

Il-format tal-messaġġ

Messaġġ multimodali b’URL ta’ immaġni jsegwi din l-istruttura:

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

Il-qasam image_url jaċċetta kwalunkwe URL HTTP jew HTTPS li jipponta lejn fajl ta’ immaġni validu fil-format JPEG, PNG, GIF, jew WebP.

Eżempju sħiħ f’Python

Hawnhekk hemm skript sħiħ, lest biex jitħaddem, li janalizza immaġni pubblika minn Wikimedia, jekk nassumu li ċ-ċavetta tal-API tiegħek hija stabbilita fl-ambjent:

from mistralai.client import Mistral
import os

# Inizzjalizza l-klijent
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Immaġni pubblika biex tiġi analizzata
url_image = "https://upload.wikimedia.org/wikipedia/commons/thumb/a/a7/Camponotus_flavomarginatus_ant.jpg/800px-Camponotus_flavomarginatus_ant.jpg"

# Sejjaħ il-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)

Innota li ngħaddu ċ-ċavetta permezz ta’ os.environ minflok ma niktbuha direttament fil-kodiċi. Din hija l-unika approċċ aċċettabbli ladarba l-iskript joħroġ mill-magna lokali tiegħek.

Żieda ta’ prompt tas-sistema

Ir-risposta ta’ hawn fuq tkun korretta iżda ġenerika—“namla sewda fuq sfond imċajpar.” Messaġġ tas-sistema jbiddel in-natura tal-analiżi billi jassenja rwol lill-mudell qabel ma jara l-immaġni:

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

B’dan il-qafas, l-istess immaġni tipproduċi identifikazzjoni tassonomika u deskrizzjoni morfoloġika. Il-prompt tas-sistema jiggwida kif il-mudell janalizza l-immaġni—leva qawwija biex tikseb risposti speċjalizzati bl-ispiża ta’ ftit għexieren ta’ tokens biss.

Rekwiżiti tal-URL

L-API trid tkun kapaċi tnizzel l-immaġni mingħajr l-ebda kuntest mis-sessjoni tiegħek. Dan iwassal għal erba’ rekwiżiti: l-URL irid ikun aċċessibbli pubblikament (l-ebda paġna wara awtentikazzjoni); irid jipponta direttament lejn il-fajl, mhux lejn paġna HTML li fiha l-immaġni; il-format irid ikun appoġġjat (JPEG, PNG, GIF fejn jiġi qari biss l-ewwel qafas, jew WebP); u d-daqs irid jibqa’ raġonevoli, taħt 20 MB.

L-aktar konfużjoni komuni tinvolvi links ta’ kondiviżjoni. Link ta’ Google Drive jew Dropbox “maqsum ma’ kulħadd” jirritorna paġna HTML, mhux fajl ta’ immaġni: is-sejħa tfalli, jew il-mudell jiddeskrivi interfaċċja web. L-aħjar prattika hija li tivverifika l-Content-Type qabel ma tibgħat:

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

Talba HEAD hija biżżejjed: tikseb l-intestaturi mingħajr ma tnizzel il-fajl.

Immaġnijiet mill-ħażna tas-sħaba

Dan ir-rekwiżit ta’ aċċessibbiltà pubblika jidher inkompatibbli ma’ dokumenti kunfidenzjali. Is-soluzzjoni tinsab f’URLs iffirmati minn qabel (pre-signed URLs): jekk l-immaġnijiet tiegħek huma f’bucket S3, Google Cloud Storage, jew Azure Blob, tiġġenera indirizz temporanju li jagħti aċċess għal oġġett wieħed għal durata li tispeċifika int.

import boto3

s3 = boto3.client("s3")

# Iġġenera URL iffirmat minn qabel validu għal siegħa
presigned_url = s3.generate_presigned_url(
    "get_object",
    Params={"Bucket": "my-bucket", "Key": "images/invoice.png"},
    ExpiresIn=3600
)

# Uża dan l-URL mal-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}
            ]
        }
    ]
)

Il-bucket tiegħek jibqa’ privat, l-URL jiskadi wara d-dewmien speċifikat, u inti żżomm in-natura ħafifa tat-talba. Stabbilixxi ExpiresIn kemm jista’ jkun qasir: ftit minuti huma aktar minn biżżejjed għal sejħa tal-API.

Ġestjoni tal-iżbalji

Sejħa li tiddependi fuq tniżżil remot tista’ tfalli għal raġunijiet lil hinn mill-kontroll tiegħek—l-immaġni tħassret, l-URL skada, jew is-server tal-ospitazzjoni mhux disponibbli. Fil-produzzjoni, qatt ma tħalli l-eċċezzjoni mhux ipproċessata tilħaq lill-utent:

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

Ittestja l-ġestjoni tal-iżbalji tiegħek b’URL deliberatament invalidu qabel ma tiddispjega: dan huwa l-aktar xenarju frekwenti u dak li l-inqas spiss jiġi ttestjat.

Punti Ewlenin

  • L-ibgħat permezz ta’ URL huwa l-aktar metodu sempliċi—URL pubbliku huwa biżżejjed
  • Il-qasam content tal-messaġġ huwa array li fih elementi text u image_url
  • L-URL irid jipponta direttament lejn fajl ta’ immaġni aċċessibbli
  • URLs iffirmati minn qabel jippermettulek tuża immaġnijiet privati b’mod sigur
  • Dejjem żid prompt tas-sistema biex tiggwida l-analiżi tal-mudell