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

Vytvářej obrázky z promptu

Lekce 2 z 12 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Vytvářej obrázky z promptu
  2. Anatomie volání pro generování
  3. Získání vygenerovaného obrázku
  4. Generování více obrázků v jediném volání
  5. Piš efektivní prompty
  6. Zpracování chyb

Aktualizováno 2. listopadu 2026 — Modely pro generování obrázků. Model gpt-image-1, pro který byl tento kurz původně napsán, byl ukončen 23. října 2026. Modely gpt-image-1.5, gpt-image-1-mini a chatgpt-image-latest budou vyřazeny z provozu 1. prosince 2026. Příklady nyní využívají model gpt-image-2.5-sunburst, který nabízí nejvyšší přesnost při úpravách; model gpt-image-2.5-flare je rychlejší pro standardní generování. Obě modely také podporují nastavení kvality xhigh a max. Modely GPT Image vždy vracejí obrázky v base64: parametr response_format, který používaly starší modely DALL·E, není podporován a byl z kódu odstraněn. Zdroj: Image generation (OpenAI).

Vytvářej obrázky z promptu

Metoda client.images.generate() je tvým hlavním vstupním bodem pro vytvoření obrázku na základě textového popisu. Spoléhá jen na hrstku parametrů, ale právě proto, že jich je tak málo, záleží na každém z nich: rozdíl mezi náhodným výsledkem a předvídatelným výstupem závisí téměř výhradně na obsahu pole prompt. Tato lekce tě naučí ovládat obojí.

Anatomie volání pro generování

Zde je kompletní struktura volání se všemi dostupnými parametry.

from openai import OpenAI

client = OpenAI()

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Podrobný popis požadovaného obrázku",
    n=1,
    size="1024x1024",
    quality="high"
)
ParametrTypPopis
modelstring"gpt-image-2.5-sunburst" (nejpřesnější) nebo "gpt-image-2.5-flare" (nejrychlejší)
promptstringPopis obrázku (až 32 000 znaků)
nintegerPočet obrázků k vygenerování (1 až 10)
sizestring"1024x1024", "1024x1536", "1536x1024"
qualitystring"low", "medium", "high"

Limit 32 000 znaků pro prompt je štědrý: umožňuje velmi podrobné popisy a brzy uvidíš, že detail je tvou nejlepší pákou pro kontrolu výsledku.

Získání vygenerovaného obrázku

Odpověď obsahuje objekt data, který drží vygenerované obrázky. Modely GPT Image vždy vracejí obrázek zakódovaný v base64 v poli b64_json: musíš jej dekódovat a okamžitě uložit na disk. Parametr response_format a dočasné URL adresy ze starších modelů DALL·E se na GPT Image nevztahují.

import base64

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Japonská zahrada v dešti, fotografie",
    n=1,
    size="1024x1024",
)

image_data = base64.b64decode(response.data[0].b64_json)

with open("garden.png", "wb") as f:
    f.write(image_data)

print("Obrázek uložen: garden.png")

Jakmile je soubor zapsán, nic už nezávisí na OpenAI: toto je soubor, který ukládáš, obsluhuješ nebo dále upravuješ.

Generování více obrázků v jediném volání

Parametr n požaduje více variant v rámci jedné žádosti. Udělej z toho svůj výchozí reflex, když zkoumáš vizuální směr a nevíš, kterou verzi si vybrat: čtyři návrhy vedle sebe ti řeknou mnohem více než jeden jediný.

import base64
response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="Minimalistické logo pro řemeslnou pekárnu, bílé pozadí",
    n=4,
    size="1024x1024",
    quality="high"
)

for i, image in enumerate(response.data):
    with open(f"logo_{i+1}.png", "wb") as f:
        f.write(base64.b64decode(image.b64_json))
    print(f"Varianta {i+1}: logo_{i+1}.png")

Sleduj však své náklady: každý obrázek spotřebovává tokeny nezávisle a generování 4 obrázků stojí 4krát více než jeden. Prozkoumávej možnosti s vysokým n a nízkou kvalitou, vysokou kvalitu si nech až pro finální výběr.

Piš efektivní prompty

Kvalita výsledku přímo závisí na přesnosti tvého promptu. Dobrý prompt následuje jednoduchou strukturu—předmět + styl + kontext + technické detaily—a níže uvedené srovnání činí rozdíl hmatatelným: „dům“ nechává model vymyslet vše, co jsi neřekl, zatímco rozpracovaná verze fixuje materiál, barvu okenic, denní dobu, editorský rejstřík a optické zpracování.

# Vágní prompt — nepředvídatelný výsledek
weak_prompt = "dům"

# Strukturovaný prompt — kontrolovaný výsledek
strong_prompt = (
    "Provensálský venkovský dům ze světlého kamene, "
    "levandulově modré okenice, břečťan na fasádě, "
    "fotografováno ve zlatou hodinku, "
    "editorský styl pro architektonický časopis, "
    "centrální kompozice, hloubka ostrosti"
)

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt=strong_prompt,
    size="1536x1024",
    quality="high"
)

Vizuální styl deklaruj stejným způsobem: pojmenuj médium, místo abys doufal v určitý záměr. GPT Image rozumí široké škále rejstříků a následující smyčka ti umožní pocítit rozdíl mezi nimi na zcela totožném předmětu: kolo zaparkované před pařížskou kavárnou se zcela změní v závislosti na tom, zda požádáš o editorskou fotografii, plochou vektorovou ilustraci nebo tužkovou skicu.

import base64
styles = [
    "editorská fotografie, studiové osvětlení",
    "plochá vektorová ilustrace",
    "akvarel na texturovaném papíře",
    "fotorealistický 3D render, Octane Render",
    "tužková skica na kraftovém papíře",
]

for style in styles:
    prompt = f"Starožitné kolo zaparkované před pařížskou kavárnou, {style}"
    response = client.images.generate(
        model="gpt-image-2.5-sunburst",
        prompt=prompt,
        size="1024x1024",
        quality="medium"
    )
    filename = f"kolo_{styles.index(style) + 1}.png"
    with open(filename, "wb") as f:
        f.write(base64.b64decode(response.data[0].b64_json))
    print(f"Styl: {style} → {filename}")

Text vložený do obrázku si zaslouží samostatnou poznámku, protože právě zde se GPT Image jasně odlišuje od svých předchůdců. Zprávu uveď v uvozovkách přímo v promptu, specifikuj rodinu písma a očekávané grafické zpracování a výsledek bude čitelný.

response = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt=(
        "Propagační plakát s textem „LETNÍ VÝPRODEJ -50 %“ "
        "velkými bílými písmeny na modro-oranžovém gradientním pozadí, "
        "moderní bezpatková typografie, profesionální komerční styl"
    ),
    size="1024x1536",
    quality="high"
)

Zpracování chyb

Skript pro generování běžící ve smyčce dříve či později narazí na limit rychlosti nebo chybu API. Tyto dva případy od začátku řeš odlišně: RateLimitError vyžaduje čekání a opakování, zatímco APIError vyžaduje prozkoumání zprávy před jakýmkoli dalším pokusem.

import base64
from openai import OpenAI, APIError, RateLimitError

client = OpenAI()

try:
    response = client.images.generate(
        model="gpt-image-2.5-sunburst",
        prompt="Zasněžená horská krajina při východu slunce",
        size="1024x1024"
    )
    with open("mountain.png", "wb") as f:
        f.write(base64.b64decode(response.data[0].b64_json))

except RateLimitError:
    print("Dosažen limit požadavků. Před opakováním počkej.")

except APIError as e:
    print(f"Chyba API: {e.message}")

Aby sis vše upevnil, nyní napiš skript, který vygeneruje tři varianty stejného předmětu ve třech různých stylech—fotografie, ilustrace, akvarel—a každý obrázek uloží lokálně ve formátu PNG s využitím formátu base64 pro získání dat.