Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Omezení: Formáty, velikost a limity

Lekce 4 z 12 Aktualizováno 30. července 2026 Začátečník
Na této stránce
  1. Základní pravidla
  2. Podporované formáty obrázků
  3. Maximální velikost: 20 MiB
  4. Počet obrázků na požadavek: Neomezený
  5. Kompatibilní modely
  6. Zpracování chyb
  7. Klíčové poznatky

Základní pravidla

Než začneš do svých aplikací integrovat Grok Vision, musíš znát technická omezení uložená rozhraním xAI API. Ignorování těchto limitů vede k tichým chybám nebo zamítnutým požadavkům, které jsou v produkčním prostředí obtížně laditelné.

Podporované formáty obrázků

Rozhraní xAI API přijímá dva formáty souborů (tři přípony: .jpg, .jpeg, .png):

  • JPG (nebo JPEG) – nejběžnější formát pro fotografie
  • PNG – vhodný pro snímky obrazovky, diagramy a obrázky s textem

Všechny ostatní formáty jsou odmítnuty. Pokud pracuješ s obrázky WebP, GIF, BMP, TIFF, SVG nebo HEIC, musíš je před odesláním převést:

from PIL import Image

def convert_to_jpeg(source_path, output_path):
    img = Image.open(source_path)
    # Převod do RGB (požadováno pro JPEG)
    if img.mode in ("RGBA", "P"):
        img = img.convert("RGB")
    img.save(output_path, "JPEG", quality=90)

Častá past: Obrázky RGBA

Soubory PNG s průhledností (alfa kanál) jsou přijímány tak, jak jsou. Pokud je však převádíš do formátu JPEG, musíš nejprve odstranit alfa kanál, protože JPEG průhlednost nepodporuje.

Maximální velikost: 20 MiB

Každý obrázek nesmí překročit 20 MiB (20 971 520 bajtů). Při překročení tohoto limitu API požadavek zamítne.

Tento limit platí:

  • Pro stažený soubor v případě URL
  • Pro dekódovaná data v případě Base64 (ne pro samotný zakódovaný řetězec, který je přibližně o 33 % delší)

Kontrola velikosti před odeslání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ázek je příliš velký: {size_mib:.1f} MiB "
            f"(max {max_mib} MiB)"
        )
    return size_mib

Komprese v případě potřeby

U obrázků blízkých limitu můžeš snížit 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ázků na požadavek: Neomezený

Na rozdíl od jiných vision API, která omezují počet obrázků na požadavek, rozhraní xAI API neklade žádný limit. Do jednoho požadavku můžeš odeslat libovolný počet obrázků.

Měj však na paměti, že:

  • Každý obrázek spotřebuje mezi 256 a 1792 tokeny
  • Celkový kontext modelu má maximální velikost
  • Více obrázků = vyšší latence a náklady

Praktické doporučení

I když je limit teoreticky neomezený, zachovej rozumnou míru:

# Osvědčený postup: zpracování v dávkách
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čně popiš každý obrázek."
        })

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

Kompatibilní modely

Rozumění obrazu je dostupné na modelech grok-4.5 a vyšších. Starší modely tuto funkci nepodporují.

Vždy ověř model použitý ve svém kódu:

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

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

Zpracování chyb

Předvídej chyby související s omezeními validací obrázků před jejich odeslání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 velikosti
    size_mib = os.path.getsize(path) / (1024 * 1024)
    if size_mib > 20:
        errors.append(f"Příliš velký: {size_mib:.1f} MiB (max 20)")

    # Kontrola, zda jde o skutečný obrázek
    try:
        img = Image.open(path)
        img.verify()
    except Exception:
        errors.append("Poškozený soubor nebo neplatný obrázek")

    return errors

Klíčové poznatky

  • Přijímány jsou pouze formáty JPG/JPEG a PNG – ostatní převeď
  • Maximální velikost: 20 MiB na obrázek – v případě potřeby komprimuj
  • Počet obrázků na požadavek je neomezený, ale každý obrázek spotřebovává tokeny
  • Pouze modely grok-4.5 a vyšší podporují vision
  • Před odesláním vždy validuj obrázky, abys předešel tichým chybám