Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Obmedzenia: Formáty, veľkosť a limity

Lekcia 4 z 12 Aktualizované 30. júla 2026 Začiatočník
Na tejto strane
  1. Základné pravidlá
  2. Akceptované formáty obrázkov
  3. Maximálna veľkosť: 20 MiB
  4. Počet obrázkov na požiadavku: Neobmedzený
  5. Kompatibilné modely
  6. Ošetrenie chýb
  7. Kľúčové poznatky

Základné pravidlá

Predtým, než integruješ videnie Grok do svojich aplikácií, musíš poznať technické obmedzenia uložené API xAI. Ignorovanie týchto limitov vedie k tichým chybám alebo zamietnutým požiadavkám, ktoré sa v produkcii ťažko ladia.

Akceptované formáty obrázkov

API xAI prijíma dva formáty súborov obrázkov (tri prípony: .jpg, .jpeg, .png):

  • JPG (alebo JPEG) – najbežnejší formát pre fotografie
  • PNG – vhodný pre snímky obrazovky, diagramy a obrázky s textom

Všetky ostatné formáty sú zamietnuté. Ak pracuješ s obrázkami WebP, GIF, BMP, TIFF, SVG alebo HEIC, musíš ich pred odoslaním konvertovať:

from PIL import Image

def convert_to_jpeg(source_path, output_path):
    img = Image.open(source_path)
    # Konverzia do RGB (vyžadované pre JPEG)
    if img.mode in ("RGBA", "P"):
        img = img.convert("RGB")
    img.save(output_path, "JPEG", quality=90)

Častá pasca: Obrázky RGBA

Súbory PNG s priehľadnosťou (alfa kanál) sú akceptované tak, ako sú. Ak ich však konvertuješ na JPEG, musíš najprv odstrániť alfa kanál, pretože JPEG nepodporuje priehľadnosť.

Maximálna veľkosť: 20 MiB

Každý obrázok nesmie presiahnuť 20 MiB (20 971 520 bajtov). Po prekročení tohto limitu API požiadavku zamietne.

Tento limit platí:

  • Pre stiahnutý súbor v prípade URL adresy
  • Pre dekódované dáta v prípade Base64 (nie pre samotný zakódovaný reťazec, ktorý je o ~33 % dlhší)

Kontrola veľkosti pred odoslaním

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"Obrázok je príliš veľký: {size_mib:.1f} MiB "
            f"(max {max_mib} MiB)"
        )
    return size_mib

Komprimácia v prípade potreby

Pre obrázky blízko limitu môžeš znížiť kvalitu 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

Počet obrázkov na požiadavku: Neobmedzený

Na rozdiel od iných API pre videnie, ktoré obmedzujú počet obrázkov na požiadavku, API xAI neukladá žiadny limit. Do jednej požiadavky môžeš odoslať toľko obrázkov, koľko potrebuješ.

Maj však na pamäti, že:

  • Každý obrázok spotrebuje medzi 256 a 1792 tokenmi
  • Celkový kontext modelu má maximálnu veľkosť
  • Viac obrázkov = vyššia latencia a náklady

Praktické odporúčanie

Hoci je limit teoreticky neobmedzený, zostaň rozumný:

# Najlepšia prax: spracovanie v dávkach
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": "Stručne popíš každý obrázok."
        })

        response = client.responses.create(
            model="grok-4.5",
            input=input_data
        )
        results.append(response)
    return results

Kompatibilné modely

Rozumienie obrázkom je dostupné na modeloch grok-4.5 a vyšších. Staršie modely túto funkciu nepodporujú.

Vždy skontroluj model použitý vo svojom kóde:

VISION_MODELS = ["grok-4.5", "grok-4.20-0309-reasoning"]

def supports_vision(model):
    return any(model.startswith(m) for m in VISION_MODELS)

Ošetrenie chýb

Predchádzaj chybám súvisiacim s obmedzeniami validáciou obrázkov pred odoslaním:

def validate_image(path):
    errors = []

    # Kontrola formátu
    extension = path.lower().rsplit(".", 1)[-1]
    if extension not in ("jpg", "jpeg", "png"):
        errors.append(f"Nepodporovaný formát: {extension}")

    # Kontrola veľkosti
    size_mib = os.path.getsize(path) / (1024 * 1024)
    if size_mib > 20:
        errors.append(f"Príliš veľký: {size_mib:.1f} MiB (max 20)")

    # Kontrola, či ide o skutočný obrázok
    try:
        img = Image.open(path)
        img.verify()
    except Exception:
        errors.append("Poškodený súbor alebo neplatný obrázok")

    return errors

Kľúčové poznatky

  • Akceptované sú iba formáty JPG/JPEG a PNG – ostatné konvertuj
  • Maximálna veľkosť: 20 MiB na obrázok – v prípade potreby komprimuj
  • Počet obrázkov na požiadavku je neobmedzený, ale každý obrázok spotrebúva tokeny
  • Videnie podporujú iba modely grok-4.5 a vyššie
  • Obrázky vždy validuj pred odoslaním, aby si predišiel tichým chybám