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

Endpoint /v1/images/generations: Začínáme

Lekce 1 z 14 Aktualizováno 3. listopadu 2026 Začátečník
Na této stránce
  1. Vygeneruj svůj první obrázek s Grok API
  2. Struktura požadavku na generování
  3. Parametry požadavku
  4. Formát odpovědi
  5. Praktické cvičení
  6. Klíčové poznatky

Lekce dokončena 3. listopadu 2026 na základě stránky Image Generation a reference k xAI Images API: výchozí hodnoty (aspect_ratio nastaveno na auto, resolution na 1k), parametr quality pro Imagine 2.0 a JPEG jako výchozí formát. Zdroje: Image Generation · Images API.

Vygeneruj svůj první obrázek s Grok API

Obrázek vygenerovaný modelem Grok API xAI nabízí vyhrazený endpoint pro generování obrázků: POST /v1/images/generations. Tento endpoint ti umožňuje vytvářet obrázky na základě textového popisu pomocí modelů Grok Imagine. Ať už chceš produkovat ilustrace, marketingové vizuály nebo kreativní prototypy, vše začíná právě tímto endpointem.

V této lekci se naučíš, jak strukturovat požadavek na generování obrázku a pochopíš základní parametry.

1
Endpoint pro generování
2
Dostupné modely
10
Maximální počet obrázků na požadavek
2k
Maximální rozlišení

Struktura požadavku na generování

K vygenerování obrázku stačí dva parametry: model a prompt (příkaz). Všechny ostatní mají výchozí hodnoty, což ti umožní získat první výsledek ve třech řádcích kódu – a přesně to bys měl udělat ještě před čtením zbytku lekce, abys měl před sebou obrázek, ke kterému si budeš moci přiřadit jednotlivé parametry.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="A Breton lighthouse under a starry sky, watercolor style"
)

image_url = response.data[0].url
print(image_url)

API xAI je kompatibilní se SDK OpenAI pro generování obrázků: stačí nastavit base_url na https://api.x.ai/v1, poskytnout svůj klíč xAI a zbytek kódu zůstane nezměněn. Měj však na paměti rozsah této kompatibility – platí pro generování, ale ne pro úpravy, které očekávají jiný formát. Tomu se věnujeme v lekci 5.

Parametry požadavku

Zde jsou parametry, které můžeš do svého požadavku zahrnout:

  • model: model pro generování (grok-imagine-image nebo grok-imagine-image-2.0, viz lekce 2)
  • prompt: textový popis požadovaného obrázku
  • n: počet obrázků k vygenerování (1 až 10, výchozí: 1)
  • aspect_ratio: poměr stran obrázku (výchozí auto: model zvolí poměr na základě promptu)
  • resolution: rozlišení (výchozí 1k nebo 2k)
  • quality: low, medium nebo auto (výchozí) u Imagine 2.0, viz lekce 12
  • response_format: url (výchozí) nebo b64_json pro přijetí obrázku v Base64

Příklad se všemi parametry

response = client.images.generate(
    model="grok-imagine-image",
    prompt="An enchanted forest with fireflies, digital art style",
    n=2,
    response_format="url",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)

for image in response.data:
    print(image.url)

Formát odpovědi

Odpověď je vždy pole (array), a to i pro jediný obrázek – iteruj tedy přes něj, místo abys četl přímo data[0], jinak se ti kód rozbije ve chvíli, kdy nastavíš n=4. Každý objekt obsahuje:

  • url: dočasná URL adresa obrázku (pokud je response_format nastaveno na url)
  • b64_json: data obrázku v Base64 (pokud je response_format nastaveno na b64_json)

Vrácený typ MIME může být image/png, image/jpeg nebo image/webp; výchozí je image/jpeg, pokud nastavení kvality nevede k výstupu PNG.

Praktické cvičení

Zkus vygenerovat svůj první obrázek úpravou promptu tak, aby odpovídal tvému profesnímu kontextu. Například pro vizuál do prezentace:

response = client.images.generate(
    model="grok-imagine-image",
    prompt="Minimalist chart showing startup growth, "
           "blue and white colors, dark background, flat design style",
    extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)

Klíčové poznatky

  • Endpoint pro generování je POST /v1/images/generations
  • Ke startu stačí dva parametry: model a prompt
  • API je kompatibilní s Python SDK od OpenAI po změně base_url
  • Na jeden požadavek můžeš vygenerovat až 10 obrázků
  • K dispozici jsou rozlišení 1k (výchozí) a 2k