Vytvářej obrázky z promptu
Na této stránce
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. Modelygpt-image-1.5,gpt-image-1-miniachatgpt-image-latestbudou vyřazeny z provozu 1. prosince 2026. Příklady nyní využívají modelgpt-image-2.5-sunburst, který nabízí nejvyšší přesnost při úpravách; modelgpt-image-2.5-flareje rychlejší pro standardní generování. Obě modely také podporují nastavení kvalityxhighamax. Modely GPT Image vždy vracejí obrázky v base64: parametrresponse_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"
)
| Parametr | Typ | Popis |
|---|---|---|
model | string | "gpt-image-2.5-sunburst" (nejpřesnější) nebo "gpt-image-2.5-flare" (nejrychlejší) |
prompt | string | Popis obrázku (až 32 000 znaků) |
n | integer | Počet obrázků k vygenerování (1 až 10) |
size | string | "1024x1024", "1024x1536", "1536x1024" |
quality | string | "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.