Omejitve: Formati, velikost in limite
Na tej strani
Osnovna pravila
Preden v svoje aplikacije integriraš vid Grok, moraš poznati tehnične omejitve, ki jih nalaga API xAI. Ignoriranje teh limitov vodi v tihe napake ali zavrnjene zahteve, ki jih je v produkcijskem okolju težko odpravljati.
Podprti formati slik
API xAI sprejme dva formata slikovnih datotek (tri končnice: .jpg, .jpeg, .png):
- JPG (ali JPEG) – najpogostejši format za fotografije
- PNG – primeren za posnetke zaslona, diagrame in slike s besedilom
Vsi drugi formati so zavrnjeni. Če delaš s slikami WebP, GIF, BMP, TIFF, SVG ali HEIC, jih moraš pred pošiljanjem pretvoriti:
from PIL import Image
def convert_to_jpeg(source_path, output_path):
img = Image.open(source_path)
# Pretvorba v RGB (zahtevano za JPEG)
if img.mode in ("RGBA", "P"):
img = img.convert("RGB")
img.save(output_path, "JPEG", quality=90)
Pogosta past: Slike RGBA
Datoteke PNG s prosojnostjo (alfa kanal) so sprejete takšne, kot so. Če pa jih pretvarjaš v JPEG, moraš najprej odstraniti alfa kanal, saj JPEG ne podpira prosojnosti.
Največja velikost: 20 MiB
Vsaka slika ne sme presegati 20 MiB (20.971.520 bajtov). Če je večja, API zahtevo zavrne.
Ta omejitev velja:
- Za preneseno datoteko v primeru URL-ja
- Za dekodirane podatke v primeru Base64 (ne za kodirani niz sam, ki je približno 33 % daljši)
Preveri velikost pred pošiljanjem
import os
def check_size(image_path, max_mib=20):
size = os.path.getsize(image_path)
size_mib = size / (1024 * 1024)
if size_mib > max_mib:
raise ValueError(
f"Slika je prevelika: {size_mib:.1f} MiB "
f"(največ {max_mib} MiB)"
)
return size_mib
Stisni po potrebi
Za slike, ki so blizu limite, lahko zmanjšaš kakovost JPEG:
def compress_image(path, quality=80, max_size_mib=20):
img = Image.open(path)
buffer = io.BytesIO()
img.save(buffer, "JPEG", quality=quality)
while buffer.tell() > max_size_mib * 1024 * 1024 and quality > 20:
quality -= 10
buffer = io.BytesIO()
img.save(buffer, "JPEG", quality=quality)
buffer.seek(0)
return buffer
Število slik na zahtevo: Neomejeno
Za razliko od drugih API-jev za vid, ki omejujejo število slik na zahtevo, API xAI ne nalaga nobene omejitve. V eno zahtevo lahko pošlješ poljubno število slik.
Vendar imej v mislih, da:
- Vsaka slika porabi med 256 in 1792 žetonov
- Celoten kontekst modela ima največjo velikost
- Več slik = večja zakasnitev in višji stroški
Praktično priporočilo
Čeprav je limita teoretično neomejena, ostani razumen:
# Najboljša praksa: obdelava v serijah
def analyze_batch(images, batch_size=10):
results = []
for i in range(0, len(images), batch_size):
batch = images[i:i + batch_size]
input_data = []
for img in batch:
input_data.append({
"type": "input_image",
"image_url": img,
"detail": "low"
})
input_data.append({
"type": "input_text",
"text": "Na kratko opiši vsako sliko."
})
response = client.responses.create(
model="grok-4.5",
input=input_data
)
results.append(response)
return results
Združljivi modeli
Razumevanje slik je na voljo pri modelih grok-4.5 in novejših. Starejši modeli te funkcije ne podpirajo.
Vedno preveri model, ki ga uporabljaš v kodi:
VISION_MODELS = ["grok-4.5", "grok-4.20-0309-reasoning"]
def supports_vision(model):
return any(model.startswith(m) for m in VISION_MODELS)
Obravnava napak
Pričakuj napake, povezane z omejitvami, tako da slike validiraš pred pošiljanjem:
def validate_image(path):
errors = []
# Preveri format
extension = path.lower().rsplit(".", 1)[-1]
if extension not in ("jpg", "jpeg", "png"):
errors.append(f"Nepodprt format: {extension}")
# Preveri velikost
size_mib = os.path.getsize(path) / (1024 * 1024)
if size_mib > 20:
errors.append(f"Prevelika: {size_mib:.1f} MiB (največ 20)")
# Preveri, ali gre za pravo sliko
try:
img = Image.open(path)
img.verify()
except Exception:
errors.append("Poškodovana datoteka ali neveljavna slika")
return errors
Ključne ugotovitve
- Sprejeta sta samo formata JPG/JPEG in PNG – druge pretvori
- Največja velikost: 20 MiB na sliko – po potrebi stisni
- Število slik na zahtevo je neomejeno, vendar vsaka slika porabi žetone
- Samo modeli grok-4.5 in novejši podpirajo vid
- Slike vedno validiraj pred pošiljanjem, da se izogneš tihih napakam