OpenAI: GPT Image 1

GPT Image 1 vytváří a upravuje obrázky z textových a vizuálních vstupů, včetně kompozic vedených předlohami a maskovaných změn. Podporuje volitelnou věrnost vstupů, standardní rozměry, průhledná pozadí a výstup PNG, JPEG nebo WebP.

Ailoot Ultra · Obrázky POST /v1/images/generations openai/gpt-image-1

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

GPT Image 1 je nativně multimodální obrazový model OpenAI, který přijímá textové a obrazové vstupy a vytváří obrazové výstupy. Umí vygenerovat novou scénu, pomocí předloh utvářet kompozici nebo upravit stávající podklad podle nového pokynu. Praktické využití zahrnuje ilustrace, produktové obrázky, návrhové koncepty a místní změny vedené maskou. Jde o pojmenovanou edici GPT Image 1 odlišnou od Image 1 Mini, Image 1.5 a pozdějších verzí GPT Image.

Připravte zadání určující hlavní motiv, prostředí, kompozici, osvětlení a vizuální styl. Pokud úloha potřebuje viditelný text, přidejte přesné znění a vysvětlete zamýšlenou hierarchii a polohu. U kompozice podle předloh přiřaďte každému obrázku jasnou roli, například produkt, prostředí nebo vizuální zpracování. Přímé postupy generování a úprav povolují zadání o délce až 32 000 znaků a jeden až deset obrazových výsledků. Vrácené varianty porovnejte podle stejného zadání a vybraný podklad uchovejte pro další práci.

Úpravy mohou přijmout až šestnáct referenčních obrázků. GPT Image 1 podporuje input_fidelity low a high, přičemž výchozí je low. Tento parametr ovlivňuje úsilí o zachování vlastností a stylu zdrojového obrázku; je oddělený od kvality vykreslení a velikosti výstupu. Úprava s vysokou věrností je užitečná, když záleží na detailech zdroje, ale nezaručuje, že každý rozpoznávací detail zůstane totožný. Uveďte, co se má zachovat a co se může změnit, místo abyste spoléhali pouze na nastavení věrnosti.

Maskované úpravy označují oblast ke změně. Zdroj a masku připravte ve stejném formátu a rozměrech, podle požadavků průvodce menší než 50 MB a s alfa kanálem v masce. Při více zdrojových obrázcích se maska aplikuje na první. Praktické zadání úpravy může požadovat jinou barvu stěny při zachování nábytku, úhlu kamery a osvětlení. Model používá masku jako vodítko, místo aby sliboval přesnou hranici, proto zkontrolujte změněnou oblast i její okolí.

Dokumentované standardní výstupní velikosti jsou 1024 × 1024, 1536 × 1024 a 1024 × 1536 pixelů, s automatickým výběrem velikosti tam, kde je podporován. Kvalita je low, medium, high nebo auto. GPT Image 1 používá tyto standardní formáty a úrovně kvality až po high. Standardní formát vybírejte podle zamýšleného zobrazení a úroveň detailu podle účelu podkladu.

Výchozím výstupem je PNG, alternativami jsou JPEG a WebP. Pro JPEG a WebP je dostupná komprese od 0 do 100. Volby průhledného, neprůhledného a automatického pozadí podporují různé potřeby doručení; průhlednost vyžaduje PNG nebo WebP. U samostatné grafiky použijte formát zachovávající alfa kanál, než ji vložíte do pozdějšího rozvržení. U úplné scény zahrňte do zadání pozadí a vztah hlavního motivu k němu.

OpenAI dokumentuje přímé generování a úpravy a karta modelu zahrnuje také konverzační využití obrázků. Při navazující práci uchovejte vybraný výsledek jako zdroj další změny, místo abyste implicitně volili jinou variantu. Obrazová dokumentace popisuje streamování až se třemi částečnými obrázky; ukazují postup, nejde o další hotové podklady. Dokončený obrázek a zadání uchovávejte společně, aby pozdější úpravy odkazovaly na skutečnou kompozici. Rozhraní výrobce podporuje také dávkové zpracování.

Model může mít stále potíže s přesným umístěním textu, pevně strukturovanými rozvrženími a konzistencí opakujících se motivů. V zamýšlené velikosti zkontrolujte nápisy, hranice objektů, barevné pojetí a detaily identifikující zdrojový materiál. Pokud úprava potřebuje doladění, popište viditelný nesoulad a prvky k zachování. GPT Image 1 je užitečný pro konkrétní posloupnost generování, úprav vedených předlohami a přípravy podkladu, s vlastními standardními velikostmi a volitelnou věrností vstupu oddělenými od ostatních edic.

Ailoot Ultra · Obrázky POST /v1/images/generations openai/gpt-image-1

openai/gpt-image-1

OpenAI /openai/gpt-image-1

Úvod

Přijímané vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Obrázky POST /v1/images/generations

Vstup: text, image
Výstup: image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity openai/gpt-image-1	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Minimální délka: 1	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1:1, 3:2, 2:3, auto	Výchozí—
Pole`quality`	Typ`string`	PožadavekVolitelné	Hodnoty a limity auto, low, medium, high	Výchozí—
Pole`background`	Typ`string`	PožadavekVolitelné	Hodnoty a limity auto, transparent, opaque	Výchozí—
Pole`n`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 1 Maximum: 10	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 16	Výchozí—
Pole`output_compression`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 0 Maximum: 100	Výchozí—
Pole`provider`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Životní cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.32768 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Obrázky

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Přijímání a ukládání výsledků

Ailoot Ultra · Obrázky

Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Další načtení obsahu

Načíst existující soubory, které vám patří

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Uchovejte všechny dokončené výsledky

Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.

Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.

Pole odpovědi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

Ailoot Ultra openai/gpt-image-1

Aliasy cest metod

/v1/images

Související ID modelů

openai/gpt-image-1

FAQ · OpenAI: GPT Image 1

Jaké vstupy a výsledky jsou dostupné?: POST /v1/images/generations · openai/gpt-image-1: text, image → image
Jaká pole požadavek používá?: POST /v1/images/generations · openai/gpt-image-1: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider
Jaké limity platí?: POST /v1/images/generations · openai/gpt-image-1: n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

OpenAI: GPT Image 1