Ibgħat Immaġni permezz ta' URL
F'din il-paġna
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
contenttal-messaġġ huwa array li fih elementitextuimage_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