Endpoint /v1/images/generations: Začínáme
Na této stránce
Lekce dokončena 3. listopadu 2026 na základě stránky Image Generation a reference k xAI Images API: výchozí hodnoty (
aspect_rationastaveno naauto,resolutionna1k), parametrqualitypro Imagine 2.0 a JPEG jako výchozí formát. Zdroje: Image Generation · Images API.
Vygeneruj svůj první obrázek s Grok API
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.
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-imagenebogrok-imagine-image-2.0, viz lekce 2)prompt: textový popis požadovaného obrázkun: 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í1knebo2k)quality:low,mediumneboauto(výchozí) u Imagine 2.0, viz lekce 12response_format:url(výchozí) nebob64_jsonpro 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 jeresponse_formatnastaveno naurl)b64_json: data obrázku v Base64 (pokud jeresponse_formatnastaveno nab64_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:
modelaprompt - 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í) a2k