Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Omejitve: Formati, velikost in limite

Lekcija 4 od 12 Posodobljeno 30. julij 2026 Začetnik
Na tej strani
  1. Osnovna pravila
  2. Podprti formati slik
  3. Največja velikost: 20 MiB
  4. Število slik na zahtevo: Neomejeno
  5. Združljivi modeli
  6. Obravnava napak
  7. Ključne ugotovitve

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