OpenAI: GPT Image 1

GPT Image 1 vytvára a upravuje obrázky z textových a vizuálnych vstupov vrátane kompozícií vedených referenciami a zmien pomocou masky. Podporuje voliteľnú vernosť vstupu, štandardné rozmery rámca, priehľadné pozadia a výstup PNG, JPEG alebo WebP.

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

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

GPT Image 1 je natívne multimodálny obrazový model spoločnosti OpenAI, ktorý prijíma textové a obrazové vstupy a vytvára obrazové výstupy. Dokáže vygenerovať novú scénu, použiť referenčné obrázky na vytvorenie kompozície alebo upraviť existujúci podklad pomocou nového pokynu. Praktická práca zahŕňa ilustrácie, produktové obrázky, návrhové koncepty a miestne zmeny vedené maskou. Ide o edíciu s názvom GPT Image 1, oddelenú od Image 1 Mini, Image 1.5 a neskorších verzií GPT Image.

Pripravte zadanie určujúce objekt, prostredie, kompozíciu, osvetlenie a vizuálny štýl. Ak úloha potrebuje viditeľný text, priložte presné znenie a vysvetlite jeho zamýšľanú hierarchiu a polohu. Pri referenčnej kompozícii prideľte každému obrázku jasnú úlohu, napríklad produkt, prostredie alebo vizuálne spracovanie. Priame postupy generovania a úpravy povoľujú zadanie s najviac 32 000 znakmi a jeden až desať obrazových výsledkov. Vrátené varianty porovnajte podľa rovnakého zadania a vybraný podklad uchovajte na ďalšiu prácu.

Úpravy môžu prijať až šestnásť referenčných obrázkov. GPT Image 1 podporuje input_fidelity low a high, pričom low je predvolené. Tento ovládací prvok ovplyvňuje úsilie zachovať vlastnosti a štýl zdrojového obrázka; je oddelený od kvality vykreslenia a veľkosti výstupu. Úprava s vysokou vernosťou je užitočná, keď záleží na zdrojových detailoch, no nezaručuje, že každý identifikačný detail zostane rovnaký. Uveďte, čo sa má zachovať a čo sa môže zmeniť, a nespoliehajte sa iba na nastavenie vernosti.

Úprava s maskou označuje oblasť na zmenu. Zdroj a masku pripravte v rovnakom formáte a rozmeroch, podľa požiadaviek príručky s veľkosťou menšou než 50 MB a s alfa kanálom v maske. Pri viacerých zdrojových obrázkoch sa maska aplikuje na prvý. Užitočné zadanie úpravy môže žiadať inú farbu steny pri zachovaní nábytku, uhla kamery a osvetlenia. Model používa masku ako usmernenie bez prísľubu presnej hranice, preto skontrolujte zmenenú oblasť aj jej okolie.

Dokumentované štandardné výstupné veľkosti sú 1 024 × 1 024, 1 536 × 1 024 a 1 024 × 1 536 pixelov s automatickým výberom veľkosti tam, kde je podporovaný. Kvalita je low, medium, high alebo auto. GPT Image 1 používa tieto štandardné rámce a úrovne kvality až po high. Štandardný rámec vyberte podľa zamýšľaného zobrazenia a úroveň detailov podľa účelu podkladu.

PNG je predvolený výstup s alternatívami JPEG a WebP. Pre JPEG a WebP je dostupná kompresia od 0 do 100. Voľby priehľadného, nepriehľadného a automatického pozadia podporujú rôzne potreby doručenia; priehľadnosť vyžaduje PNG alebo WebP. Pri izolovanej grafike použite formát zachovávajúci alfa kanál pred vložením do neskoršieho rozloženia. Pri kompletnej scéne ponechajte v zadaní pozadie a vzťah objektu k nemu.

OpenAI dokumentuje priame generovanie a úpravy a karta modelu zahŕňa aj konverzačné použitie obrázkov. Pri priebežnej práci uchovajte vybraný výsledok ako zdroj nadväzujúcej zmeny a nevyberajte implicitne iný variant. Obrazová referenčná dokumentácia uvádza streamovanie s až tromi čiastočnými obrázkami; tie ukazujú postup a nie sú ďalšími hotovými podkladmi. Dokončený obrázok a zadanie uchovávajte spolu, aby neskoršie úpravy odkazovali na skutočnú kompozíciu. Rozhranie výrobcu podporuje aj dávkové spracovanie.

Model môže mať stále ťažkosti s presným umiestnením textu, prísne štruktúrovanými rozloženiami a konzistentnosťou opakujúcich sa objektov. Pri zamýšľanej veľkosti skontrolujte nápisy, hranice predmetov, farebné spracovanie a detaily identifikujúce zdrojový materiál. Ak úprava potrebuje doladenie, opíšte viditeľný nesúlad a prvky na zachovanie. GPT Image 1 je užitočný pre konkrétnu postupnosť generovania, úprav vedených referenciami a prípravy podkladov, pričom jeho vlastné štandardné veľkosti a voliteľná vernosť vstupu zostávajú odlíšené od ostatných edícií.

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

openai/gpt-image-1

OpenAI /openai/gpt-image-1

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Obrázky

Dostupné v Ailoot · vstupy a metódy

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

Vstup: text, image
Výstup: image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity openai/gpt-image-1	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Minimálna dĺžka: 1	Predvolené—
Pole`aspect_ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 1:1, 3:2, 2:3, auto	Predvolené—
Pole`quality`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity auto, low, medium, high	Predvolené—
Pole`background`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity auto, transparent, opaque	Predvolené—
Pole`n`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 1 Maximum: 10	Predvolené—
Pole`input_references`	Typ`array`	PožiadavkaVoliteľné	Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 16	Predvolené—
Pole`output_compression`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 0 Maximum: 100	Predvolené—
Pole`provider`	Typ`object`	PožiadavkaVoliteľné	Hodnoty a limity	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`material_types`	Špecifikáciatext, image

Životný cyklus: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.32768 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

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

Prijať a uložiť výsledky

Ailoot Ultra · Obrázky

Stiahnite každý vrátený obrázok alebo 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}

Čítanie ďalšieho obsahu

Čítať existujúce podklady, ktoré vám patria

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.

Uchovať všetky dokončené výsledky

Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.

Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.

Ak treba overiť pôvodnú odpoveď

Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.

Polia odpovede

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

Aliasy

Aliasy modelov

Ailoot Ultra openai/gpt-image-1

Aliasy ciest metód

/v1/images

Súvisiace ID na volanie

openai/gpt-image-1

FAQ · OpenAI: GPT Image 1

Aké vstupy a výsledky sú dostupné?: POST /v1/images/generations · openai/gpt-image-1: text, image → image
Aké polia používa požiadavka?: POST /v1/images/generations · openai/gpt-image-1: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider
Aké limity platia?: 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