A GPT-5 Image Mini az OpenAI GPT-5 Mini és GPT Image 1 Mini modelljeire épülő, kombinált nyelvi és képi profil. Nyelvi komponense egy írásos feladatot és a forrásanyagot értelmezi, míg képi komponense vizuális tartalmat hoz létre vagy dolgoz át. A közzétett profil az utasítások követését, a szöveg képi megjelenítését és a részletes képszerkesztést hangsúlyozza. Olyan célzott vizuális feladatleíráshoz hasznos, amely szöveges értelmezést, magyarázatot vagy kiegészítő szöveget is igényel.
Készítsen feladatleírást a kívánt képi anyaggal, témával, kompozícióval és szükséges szöveggel. Írja le a kép felhasználását, például termékkoncepcióként, egy rövid magyarázatot kísérő illusztrációként vagy egy oldal vizuális vázlataként. Kifejezetten kérje az írásos és vizuális eredményeket, hogy a koncepció magyarázata könnyen elkülönüljön magától a képtől.
Például adja meg egy újrahasználható vizespalack leírását, és kérjen egyszerű termékjelenet-koncepciót rövid képaláírással. Határozza meg a palack látható alakját, a hátteret, a fény irányát és a képen szereplő pontos szavakat. A képaláírás tényeit különítse el a jelenet dekoratív részleteitől. A visszaadott képet és az írott szöveget vesse össze a feladatleírás e két részével.
A dokumentált kombinált profil szöveget, képeket és például PDF-fájlokat fogad. Egy dokumentum követelményeket vagy a vizuális anyag létrehozása előtt értelmezendő tényeket adhat. Egy kép megjelenést, elrendezést vagy szerkesztési forrást szolgáltathat. Nevezze meg minden forrás szerepét, ahelyett hogy feltételezné, hogy minden mellékletnek az eredmény minden részére hatnia kell. Több bemenet esetén a források neve és sorrendje maradjon egyértelmű.
Új képnél határozza meg, minek kell látszania, és hogyan kapcsolódnak egymáshoz a részek. Referenciák alapján végzett szerkesztésnél nevezze meg a változtatást és a megőrzendő részleteket. Egy termékjelenet új környezetet kérhet a tárgy felismerhető alakjának és látható címkéjének megőrzésével. Egy ábra egy összefüggés javítását kérheti, a változatlanul hagyandó szöveg és elemek megnevezésével.
A profil saját közzétett kártyája legfeljebb tizenhat referenciaképet enged meg szerkesztéshez. Válasszon a feladathoz hozzájáruló referenciákat, és magyarázza el a céljukat: a terméket, a szereplőt, a hátteret vagy a képi megjelenítést. Több referencia egymásnak ellentmondó megvilágítást vagy kompozíciót tartalmazhat, ezért egyértelműen nevezze meg a kívánt eredményt. A ténylegesen visszaadott képen vizsgálja meg a téma részleteit, a betűket és a kért módosítás határait.
A szöveg képi megjelenítése dokumentált képesség, de egy vizuális vázlatot továbbra is szóról szóra ellenőrizni kell. Adja meg a pontos szöveget, írásjeleket és elhelyezést, majd a fontos feliratokat és számokat a tervezett megtekintési méretben hasonlítsa össze a feladatleírással. Ismétlődő sorozatnál minden eredménnyel együtt őrizze meg a referenciákat és a vizuális követelményeket, és az elkészült képeket egymással is vesse össze.
A kombinált profil 400 000 tokenes kontextusablakot és legfeljebb 128 000 válaszgenerálási tokent tesz közzé. Ezek a munkakontextus és a válaszgenerálás keretei, elkülönülve a kép képpontméreteitől és a visszaadott képi eredmények számától. A hosszú forrásanyagot a szükséges értelmezés köré rendezze, és hagyjon helyet a válasznak. Egy tömör, releváns referenciákat tartalmazó feladatleírás hasznosabb, mint a feladathoz nem kapcsolódó dokumentumok, amelyek szerepét nem magyarázták el.
Közzétett szöveges kimeneti specifikációja JSON-séma szerinti strukturált eredményeket támogat. Határozza meg a mezőket és típusokat, ha egy írásos eredményt alkalmazásnak kell feldolgoznia, és az értékeket ellenőrizze a megadott bizonyítékok alapján. A kombinált profil nem tesz elérhetővé alkalmazásbeli függvényhívást. A nyelvi komponens képgenerálással együtt történő használata a profil megnevezett képessége; ettől egy önálló GPT-5 Mini felület nem minden funkciója válik e munkafolyamat részévé.
A képbeállításoknak a pontosan használt profilból és felületből kell származniuk. A változatok összehasonlításakor a kiválasztott konfigurációt őrizze meg az utasítással együtt. A közvetlen GPT Image 1 Mini komponens és egy kombinált csevegőprofil kérési felépítése eltér, ezért a komponens méret-, maszk- vagy kimeneti vezérlőinek kifejezetten megadott megfeleltetése szükséges, mielőtt a kombinált profil beállításaiként kezelnék őket.
A dokumentált csevegési kérésséma text és image kimeneti modalitásokat választhat. Dolgozza fel a visszaadott szöveget és minden tényleges képi eredményt, amely a generált választ kíséri. A képeket az eredményben jelzett formátumban mentse el, és az írásos választ őrizze meg az utasítással, a forrásreferenciákkal és a beállításokkal együtt. Egy csak magyarázó szöveget tartalmazó válasz különbözik egy elkészült vizuális eredménytől, ezért elrendezésben történő felhasználás előtt ellenőrizze, mit tartalmaz valójában az eredmény.
A GPT-5 Image Mini különbözik a teljes GPT-5 Image profiltól, amely a GPT-5 és GPT Image 1 modelleket ötvözi. A Mini profilt körülhatárolt nyelvi és vizuális feladatokhoz használja, amelyek feladatleírása és ellenőrzési szempontjai egyértelműek. Ellenőrizze a kompozíciót, a tárgy azonosságát, a képen szereplő szöveget és a kiegészítő prózát, majd kérje a szükséges konkrét javítást. A következő feladatleírásban őrizze meg a sikeres elemeket és a releváns referenciákat, hogy az átdolgozásnak konkrét célja legyen.
", "aboutText": "A GPT-5 Image Mini az OpenAI GPT-5 Mini és GPT Image 1 Mini modelljeire épülő, kombinált nyelvi és képi profil. Nyelvi komponense egy írásos feladatot és a forrásanyagot értelmezi, míg képi komponense vizuális tartalmat hoz létre vagy dolgoz át. A közzétett profil az utasítások követését, a szöveg képi megjelenítését és a részletes képszerkesztést hangsúlyozza. Olyan célzott vizuális feladatleíráshoz hasznos, amely szöveges értelmezést, magyarázatot vagy kiegészítő szöveget is igényel.\n\n### Kapcsolja össze az írásos feladatot és a vizuális eredményt\n\nKészítsen feladatleírást a kívánt képi anyaggal, témával, kompozícióval és szükséges szöveggel. Írja le a kép felhasználását, például termékkoncepcióként, egy rövid magyarázatot kísérő illusztrációként vagy egy oldal vizuális vázlataként. Kifejezetten kérje az írásos és vizuális eredményeket, hogy a koncepció magyarázata könnyen elkülönüljön magától a képtől.\n\nPéldául adja meg egy újrahasználható vizespalack leírását, és kérjen egyszerű termékjelenet-koncepciót rövid képaláírással. Határozza meg a palack látható alakját, a hátteret, a fény irányát és a képen szereplő pontos szavakat. A képaláírás tényeit különítse el a jelenet dekoratív részleteitől. A visszaadott képet és az írott szöveget vesse össze a feladatleírás e két részével.\n\nA dokumentált kombinált profil szöveget, képeket és például PDF-fájlokat fogad. Egy dokumentum követelményeket vagy a vizuális anyag létrehozása előtt értelmezendő tényeket adhat. Egy kép megjelenést, elrendezést vagy szerkesztési forrást szolgáltathat. Nevezze meg minden forrás szerepét, ahelyett hogy feltételezné, hogy minden mellékletnek az eredmény minden részére hatnia kell. Több bemenet esetén a források neve és sorrendje maradjon egyértelmű.\n\n### Hozzon létre és dolgozzon át képeket referenciákkal\n\nÚj képnél határozza meg, minek kell látszania, és hogyan kapcsolódnak egymáshoz a részek. Referenciák alapján végzett szerkesztésnél nevezze meg a változtatást és a megőrzendő részleteket. Egy termékjelenet új környezetet kérhet a tárgy felismerhető alakjának és látható címkéjének megőrzésével. Egy ábra egy összefüggés javítását kérheti, a változatlanul hagyandó szöveg és elemek megnevezésével.\n\nA profil saját közzétett kártyája legfeljebb tizenhat referenciaképet enged meg szerkesztéshez. Válasszon a feladathoz hozzájáruló referenciákat, és magyarázza el a céljukat: a terméket, a szereplőt, a hátteret vagy a képi megjelenítést. Több referencia egymásnak ellentmondó megvilágítást vagy kompozíciót tartalmazhat, ezért egyértelműen nevezze meg a kívánt eredményt. A ténylegesen visszaadott képen vizsgálja meg a téma részleteit, a betűket és a kért módosítás határait.\n\nA szöveg képi megjelenítése dokumentált képesség, de egy vizuális vázlatot továbbra is szóról szóra ellenőrizni kell. Adja meg a pontos szöveget, írásjeleket és elhelyezést, majd a fontos feliratokat és számokat a tervezett megtekintési méretben hasonlítsa össze a feladatleírással. Ismétlődő sorozatnál minden eredménnyel együtt őrizze meg a referenciákat és a vizuális követelményeket, és az elkészült képeket egymással is vesse össze.\n\n### Munkakontextus és vezérlők\n\nA kombinált profil 400 000 tokenes kontextusablakot és legfeljebb 128 000 válaszgenerálási tokent tesz közzé. Ezek a munkakontextus és a válaszgenerálás keretei, elkülönülve a kép képpontméreteitől és a visszaadott képi eredmények számától. A hosszú forrásanyagot a szükséges értelmezés köré rendezze, és hagyjon helyet a válasznak. Egy tömör, releváns referenciákat tartalmazó feladatleírás hasznosabb, mint a feladathoz nem kapcsolódó dokumentumok, amelyek szerepét nem magyarázták el.\n\nKözzétett szöveges kimeneti specifikációja JSON-séma szerinti strukturált eredményeket támogat. Határozza meg a mezőket és típusokat, ha egy írásos eredményt alkalmazásnak kell feldolgoznia, és az értékeket ellenőrizze a megadott bizonyítékok alapján. A kombinált profil nem tesz elérhetővé alkalmazásbeli függvényhívást. A nyelvi komponens képgenerálással együtt történő használata a profil megnevezett képessége; ettől egy önálló GPT-5 Mini felület nem minden funkciója válik e munkafolyamat részévé.\n\nA képbeállításoknak a pontosan használt profilból és felületből kell származniuk. A változatok összehasonlításakor a kiválasztott konfigurációt őrizze meg az utasítással együtt. A közvetlen GPT Image 1 Mini komponens és egy kombinált csevegőprofil kérési felépítése eltér, ezért a komponens méret-, maszk- vagy kimeneti vezérlőinek kifejezetten megadott megfeleltetése szükséges, mielőtt a kombinált profil beállításaiként kezelnék őket.\n\n### Őrizze meg a szöveges és képi eredményeket\n\nA dokumentált csevegési kérésséma text és image kimeneti modalitásokat választhat. Dolgozza fel a visszaadott szöveget és minden tényleges képi eredményt, amely a generált választ kíséri. A képeket az eredményben jelzett formátumban mentse el, és az írásos választ őrizze meg az utasítással, a forrásreferenciákkal és a beállításokkal együtt. Egy csak magyarázó szöveget tartalmazó válasz különbözik egy elkészült vizuális eredménytől, ezért elrendezésben történő felhasználás előtt ellenőrizze, mit tartalmaz valójában az eredmény.\n\nA GPT-5 Image Mini különbözik a teljes GPT-5 Image profiltól, amely a GPT-5 és GPT Image 1 modelleket ötvözi. A Mini profilt körülhatárolt nyelvi és vizuális feladatokhoz használja, amelyek feladatleírása és ellenőrzési szempontjai egyértelműek. Ellenőrizze a kompozíciót, a tárgy azonosságát, a képen szereplő szöveget és a kiegészítő prózát, majd kérje a szükséges konkrét javítást. A következő feladatleírásban őrizze meg a sikeres elemeket és a releváns referenciákat, hogy az átdolgozásnak konkrét célja legyen.", "editorialOverlay": { "copy_fields": { "practical_html": "Technikai példa angolul
Create a labelled refill-bottle scene\n\nCreate a product-scene image of a plain cylindrical blue reusable water bottle with a silver screw cap, standing upright on pale stone. Soft daylight enters from the left. Place the exact word REFILL clearly on the bottle, with no other text, logos, accessories or unsupported product claims. Keep the full bottle visible.One image artifact showing the full specified bottle, left-side daylight and the exact single-word label.Inspect the actual image for bottle shape, cap, complete framing and letter-by-letter spelling of REFILL.openai/gpt-5-image-miniA GPT-5 Image Mini az OpenAI GPT-5 Mini nyelvi képességeit ötvözi a GPT Image 1 Mini modellel vizuális tartalom létrehozásához és referenciák alapján végzett szerkesztéshez. Szöveget, képeket és dokumentumokat fogad, és szöveget, valamint képeket ad vissza, támogatva az írásos választ és képi anyagot egyaránt igénylő munkafolyamatokat.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT-5 Image Mini az OpenAI GPT-5 Mini és GPT Image 1 Mini modelljeire épülő, kombinált nyelvi és képi profil. Nyelvi komponense egy írásos feladatot és a forrásanyagot értelmezi, míg képi komponense vizuális tartalmat hoz létre vagy dolgoz át. A közzétett profil az utasítások követését, a szöveg képi megjelenítését és a részletes képszerkesztést hangsúlyozza. Olyan célzott vizuális feladatleíráshoz hasznos, amely szöveges értelmezést, magyarázatot vagy kiegészítő szöveget is igényel.
Készítsen feladatleírást a kívánt képi anyaggal, témával, kompozícióval és szükséges szöveggel. Írja le a kép felhasználását, például termékkoncepcióként, egy rövid magyarázatot kísérő illusztrációként vagy egy oldal vizuális vázlataként. Kifejezetten kérje az írásos és vizuális eredményeket, hogy a koncepció magyarázata könnyen elkülönüljön magától a képtől.
Például adja meg egy újrahasználható vizespalack leírását, és kérjen egyszerű termékjelenet-koncepciót rövid képaláírással. Határozza meg a palack látható alakját, a hátteret, a fény irányát és a képen szereplő pontos szavakat. A képaláírás tényeit különítse el a jelenet dekoratív részleteitől. A visszaadott képet és az írott szöveget vesse össze a feladatleírás e két részével.
A dokumentált kombinált profil szöveget, képeket és például PDF-fájlokat fogad. Egy dokumentum követelményeket vagy a vizuális anyag létrehozása előtt értelmezendő tényeket adhat. Egy kép megjelenést, elrendezést vagy szerkesztési forrást szolgáltathat. Nevezze meg minden forrás szerepét, ahelyett hogy feltételezné, hogy minden mellékletnek az eredmény minden részére hatnia kell. Több bemenet esetén a források neve és sorrendje maradjon egyértelmű.
Új képnél határozza meg, minek kell látszania, és hogyan kapcsolódnak egymáshoz a részek. Referenciák alapján végzett szerkesztésnél nevezze meg a változtatást és a megőrzendő részleteket. Egy termékjelenet új környezetet kérhet a tárgy felismerhető alakjának és látható címkéjének megőrzésével. Egy ábra egy összefüggés javítását kérheti, a változatlanul hagyandó szöveg és elemek megnevezésével.
A profil saját közzétett kártyája legfeljebb tizenhat referenciaképet enged meg szerkesztéshez. Válasszon a feladathoz hozzájáruló referenciákat, és magyarázza el a céljukat: a terméket, a szereplőt, a hátteret vagy a képi megjelenítést. Több referencia egymásnak ellentmondó megvilágítást vagy kompozíciót tartalmazhat, ezért egyértelműen nevezze meg a kívánt eredményt. A ténylegesen visszaadott képen vizsgálja meg a téma részleteit, a betűket és a kért módosítás határait.
A szöveg képi megjelenítése dokumentált képesség, de egy vizuális vázlatot továbbra is szóról szóra ellenőrizni kell. Adja meg a pontos szöveget, írásjeleket és elhelyezést, majd a fontos feliratokat és számokat a tervezett megtekintési méretben hasonlítsa össze a feladatleírással. Ismétlődő sorozatnál minden eredménnyel együtt őrizze meg a referenciákat és a vizuális követelményeket, és az elkészült képeket egymással is vesse össze.
A kombinált profil 400 000 tokenes kontextusablakot és legfeljebb 128 000 válaszgenerálási tokent tesz közzé. Ezek a munkakontextus és a válaszgenerálás keretei, elkülönülve a kép képpontméreteitől és a visszaadott képi eredmények számától. A hosszú forrásanyagot a szükséges értelmezés köré rendezze, és hagyjon helyet a válasznak. Egy tömör, releváns referenciákat tartalmazó feladatleírás hasznosabb, mint a feladathoz nem kapcsolódó dokumentumok, amelyek szerepét nem magyarázták el.
Közzétett szöveges kimeneti specifikációja JSON-séma szerinti strukturált eredményeket támogat. Határozza meg a mezőket és típusokat, ha egy írásos eredményt alkalmazásnak kell feldolgoznia, és az értékeket ellenőrizze a megadott bizonyítékok alapján. A kombinált profil nem tesz elérhetővé alkalmazásbeli függvényhívást. A nyelvi komponens képgenerálással együtt történő használata a profil megnevezett képessége; ettől egy önálló GPT-5 Mini felület nem minden funkciója válik e munkafolyamat részévé.
A képbeállításoknak a pontosan használt profilból és felületből kell származniuk. A változatok összehasonlításakor a kiválasztott konfigurációt őrizze meg az utasítással együtt. A közvetlen GPT Image 1 Mini komponens és egy kombinált csevegőprofil kérési felépítése eltér, ezért a komponens méret-, maszk- vagy kimeneti vezérlőinek kifejezetten megadott megfeleltetése szükséges, mielőtt a kombinált profil beállításaiként kezelnék őket.
A dokumentált csevegési kérésséma text és image kimeneti modalitásokat választhat. Dolgozza fel a visszaadott szöveget és minden tényleges képi eredményt, amely a generált választ kíséri. A képeket az eredményben jelzett formátumban mentse el, és az írásos választ őrizze meg az utasítással, a forrásreferenciákkal és a beállításokkal együtt. Egy csak magyarázó szöveget tartalmazó válasz különbözik egy elkészült vizuális eredménytől, ezért elrendezésben történő felhasználás előtt ellenőrizze, mit tartalmaz valójában az eredmény.
A GPT-5 Image Mini különbözik a teljes GPT-5 Image profiltól, amely a GPT-5 és GPT Image 1 modelleket ötvözi. A Mini profilt körülhatárolt nyelvi és vizuális feladatokhoz használja, amelyek feladatleírása és ellenőrzési szempontjai egyértelműek. Ellenőrizze a kompozíciót, a tárgy azonosságát, a képen szereplő szöveget és a kiegészítő prózát, majd kérje a szükséges konkrét javítást. A következő feladatleírásban őrizze meg a sikeres elemeket és a releváns referenciákat, hogy az átdolgozásnak konkrét célja legyen.
POST /v1/chat/completionstexttext| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/gpt-5-image-mini | Alapértelmezett— |
Mezőmessages | Típusmessage[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 | Alapértelmezett— |
Mezőmessages[].role | Típusstring | KövetelményKötelező | Értékek és korlátok Példák: system, user, assistant, tool, function Feltételek: Ezeket a szerepeket a forráskód kompatibilitási típusai kifejezetten reprezentálják; a pontos szerepkészlet továbbra is modellspecifikus. Modelltől függ | Alapértelmezett— |
Mezőmessages[].content | Típusstring|content_part[]|null | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőmessages[].tool_calls | Típustool_call[] | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőmessages[].tool_call_id | Típusstring | KövetelményOpcionális | Értékek és korlátok Akkor alkalmazandó, ha: role=tool; használja a ténylegesen visszaadott ID-t | Alapértelmezett— |
Mezőmessages[].name | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőmessages[].reasoning_content | Típusstring | KövetelményOpcionális | Értékek és korlátok Akkor alkalmazandó, ha: Küldje vissza a ténylegesen visszaadott gondolkodási tartalmat, ha ez a modell használja | Alapértelmezett— |
Mezőmessages[].reasoning_details | Típusobject|array | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőmax_tokens | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Modelltől függ | Alapértelmezett— |
Mezőmax_completion_tokens | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Modelltől függ | Alapértelmezett— |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok | Alapértelmezettfalse |
Mezőstream_options.include_usage | Típusboolean | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőtemperature | Típusnumber | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőtop_p | Típusnumber | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőstop | Típusstring|string[] | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőtools | Típusfunction_tool[] | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőtools[].type | Típusstring | KövetelményOpcionális | Értékek és korlátok function Modelltől függ | Alapértelmezett— |
Mezőtools[].function.name | Típusstring | KövetelményKötelező | Értékek és korlátok Akkor alkalmazandó, ha: Függvényeszköz megadva | Alapértelmezett— |
Mezőtools[].function.description | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtools[].function.parameters | TípusJSON_schema | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtool_choice | Típusstring|object | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőparallel_tool_calls | Típusboolean | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőresponse_format | Típusobject | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőreasoning_effort | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőreasoning | Típusobject | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőservice_tier | Típusstring | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőinstructions | Típusstring | KövetelményOpcionális | Értékek és korlátok Kompatibilitási mező | Alapértelmezett— |
Mezőfunctions | Típusfunction[] | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőfunction_call | Típusstring|object | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőprompt_cache_options | Típusobject | KövetelményOpcionális | Értékek és korlátok Modelltől függ | Alapértelmezett— |
Mezőmodalities | Típusstring[] | KövetelményOpcionális | Értékek és korlátok text | Alapértelmezett— |
Mezőprovider | Típusobject | KövetelményOpcionális | Értékek és korlátok Feltételek: A provider.options elutasításra kerül ezen az Ultra szöveges útvonalon | Alapértelmezett— |
Mezőcache_control.ttl | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: Az 1h elutasításra kerül a tényleges prompt-gyorsítótárazási helyeken | Alapértelmezett— |
Szöveg · UTF8 szöveg
messages[].content
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, messages |
Paramétermaterial_types | Szerződéstext |
Paramétermessages | Szerződésüzenettömb role/content szerkezettel |
Paraméterfile_material | Szerződésa tényleges UTF-8 dokumentum szó szerinti szövegként beillesztve; nincs kikövetkeztetett fájlazonosító |
Paraméteroptional_controls | Szerződésstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Paramétercontrol_scope | Szerződésmodellspecifikus; a felhasználói függvényeszközök eltérnek a hosztolt eszközöktől |
Paraméteroutput_modalities | Szerződéstext |
Paraméterhosted_operations | Szerződésfalse |
Paramétermultimodal_input_binding | Szerződésnull |
Életciklus: synchronous_or_streamed
Küldje el a pontos modellazonosítót a messages mellett.
A kontextushossz nem kimeneti felső korlát.
Egy szövegfájl szó szerinti szöveget adhat meg; a kép-/hang-/fájlobjektum-bemenetek pontos hozzárendelést igényelnek.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.005 / 1K token Kimenet · Kimeneti tokenek $0.004 / 1K token Bemenet · Gyorsítótár olvasása $0.0005 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token Kimenet · Kimeneti képtokenek $0.016 / 1K képtoken |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.005 / 1K token Kimenet · Kimeneti tokenek $0.004 / 1K token Bemenet · Gyorsítótár olvasása $0.0005 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításOpenAI: GPT-5 Image Mini · Alapértelmezett beállítások | Elszámolási feltételekAlapértelmezett konfiguráció | Díj Bemenet · Bemeneti tokenek 0,005 USD / 1K token Kimenet · Kimeneti tokenek 0,004 USD / 1K token Kimenet · Kimeneti kép 0,016 USD / 1K token Kimenet · Webes keresés 0,02 USD keresésenként Bemenet · Gyorsítótár olvasása 0,0005 USD / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "openai/gpt-5-image-mini", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson vagy SSE
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg az összes válaszváltozatot és azok tartalmát/eszközhívásait/gondolkodási tartalmát. SSE esetén válaszváltozat- és eszközindex szerint állítsa össze a részleges frissítéseket, és tartsa meg a végső befejezési okot és a használati adatokat.
Őrizze meg a kérés-/válaszazonosítókat és a fejléceket. Nincs megadva általános URL a szöveges feladatok lekéréséhez.
| Mező | Típus |
|---|---|
Mezőchoices[].index | Típusinteger |
Mezőchoices[].message.content | Típusstring|null |
Mezőchoices[].message.tool_calls | Típustool_call[] |
Mezőchoices[].message.reasoning_content | Típusstring |
Mezőchoices[].message.reasoning_details | Típusobject|array |
Mezőchoices[].finish_reason | Típusstring|null |
Mezőusage | Típusobject |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Ailoot Ultra openai/gpt-5-image-mini
/v1/images
openai/gpt-5-image-miniA GPT-5 Image Mini az OpenAI GPT-5 Mini nyelvi képességeit ötvözi a GPT Image 1 Mini modellel vizuális tartalom létrehozásához és referenciák alapján végzett szerkesztéshez. Szöveget, képeket és dokumentumokat fogad, és szöveget, valamint képeket ad vissza, támogatva az írásos választ és képi anyagot egyaránt igénylő munkafolyamatokat.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT-5 Image Mini az OpenAI GPT-5 Mini és GPT Image 1 Mini modelljeire épülő, kombinált nyelvi és képi profil. Nyelvi komponense egy írásos feladatot és a forrásanyagot értelmezi, míg képi komponense vizuális tartalmat hoz létre vagy dolgoz át. A közzétett profil az utasítások követését, a szöveg képi megjelenítését és a részletes képszerkesztést hangsúlyozza. Olyan célzott vizuális feladatleíráshoz hasznos, amely szöveges értelmezést, magyarázatot vagy kiegészítő szöveget is igényel.
Készítsen feladatleírást a kívánt képi anyaggal, témával, kompozícióval és szükséges szöveggel. Írja le a kép felhasználását, például termékkoncepcióként, egy rövid magyarázatot kísérő illusztrációként vagy egy oldal vizuális vázlataként. Kifejezetten kérje az írásos és vizuális eredményeket, hogy a koncepció magyarázata könnyen elkülönüljön magától a képtől.
Például adja meg egy újrahasználható vizespalack leírását, és kérjen egyszerű termékjelenet-koncepciót rövid képaláírással. Határozza meg a palack látható alakját, a hátteret, a fény irányát és a képen szereplő pontos szavakat. A képaláírás tényeit különítse el a jelenet dekoratív részleteitől. A visszaadott képet és az írott szöveget vesse össze a feladatleírás e két részével.
A dokumentált kombinált profil szöveget, képeket és például PDF-fájlokat fogad. Egy dokumentum követelményeket vagy a vizuális anyag létrehozása előtt értelmezendő tényeket adhat. Egy kép megjelenést, elrendezést vagy szerkesztési forrást szolgáltathat. Nevezze meg minden forrás szerepét, ahelyett hogy feltételezné, hogy minden mellékletnek az eredmény minden részére hatnia kell. Több bemenet esetén a források neve és sorrendje maradjon egyértelmű.
Új képnél határozza meg, minek kell látszania, és hogyan kapcsolódnak egymáshoz a részek. Referenciák alapján végzett szerkesztésnél nevezze meg a változtatást és a megőrzendő részleteket. Egy termékjelenet új környezetet kérhet a tárgy felismerhető alakjának és látható címkéjének megőrzésével. Egy ábra egy összefüggés javítását kérheti, a változatlanul hagyandó szöveg és elemek megnevezésével.
A profil saját közzétett kártyája legfeljebb tizenhat referenciaképet enged meg szerkesztéshez. Válasszon a feladathoz hozzájáruló referenciákat, és magyarázza el a céljukat: a terméket, a szereplőt, a hátteret vagy a képi megjelenítést. Több referencia egymásnak ellentmondó megvilágítást vagy kompozíciót tartalmazhat, ezért egyértelműen nevezze meg a kívánt eredményt. A ténylegesen visszaadott képen vizsgálja meg a téma részleteit, a betűket és a kért módosítás határait.
A szöveg képi megjelenítése dokumentált képesség, de egy vizuális vázlatot továbbra is szóról szóra ellenőrizni kell. Adja meg a pontos szöveget, írásjeleket és elhelyezést, majd a fontos feliratokat és számokat a tervezett megtekintési méretben hasonlítsa össze a feladatleírással. Ismétlődő sorozatnál minden eredménnyel együtt őrizze meg a referenciákat és a vizuális követelményeket, és az elkészült képeket egymással is vesse össze.
A kombinált profil 400 000 tokenes kontextusablakot és legfeljebb 128 000 válaszgenerálási tokent tesz közzé. Ezek a munkakontextus és a válaszgenerálás keretei, elkülönülve a kép képpontméreteitől és a visszaadott képi eredmények számától. A hosszú forrásanyagot a szükséges értelmezés köré rendezze, és hagyjon helyet a válasznak. Egy tömör, releváns referenciákat tartalmazó feladatleírás hasznosabb, mint a feladathoz nem kapcsolódó dokumentumok, amelyek szerepét nem magyarázták el.
Közzétett szöveges kimeneti specifikációja JSON-séma szerinti strukturált eredményeket támogat. Határozza meg a mezőket és típusokat, ha egy írásos eredményt alkalmazásnak kell feldolgoznia, és az értékeket ellenőrizze a megadott bizonyítékok alapján. A kombinált profil nem tesz elérhetővé alkalmazásbeli függvényhívást. A nyelvi komponens képgenerálással együtt történő használata a profil megnevezett képessége; ettől egy önálló GPT-5 Mini felület nem minden funkciója válik e munkafolyamat részévé.
A képbeállításoknak a pontosan használt profilból és felületből kell származniuk. A változatok összehasonlításakor a kiválasztott konfigurációt őrizze meg az utasítással együtt. A közvetlen GPT Image 1 Mini komponens és egy kombinált csevegőprofil kérési felépítése eltér, ezért a komponens méret-, maszk- vagy kimeneti vezérlőinek kifejezetten megadott megfeleltetése szükséges, mielőtt a kombinált profil beállításaiként kezelnék őket.
A dokumentált csevegési kérésséma text és image kimeneti modalitásokat választhat. Dolgozza fel a visszaadott szöveget és minden tényleges képi eredményt, amely a generált választ kíséri. A képeket az eredményben jelzett formátumban mentse el, és az írásos választ őrizze meg az utasítással, a forrásreferenciákkal és a beállításokkal együtt. Egy csak magyarázó szöveget tartalmazó válasz különbözik egy elkészült vizuális eredménytől, ezért elrendezésben történő felhasználás előtt ellenőrizze, mit tartalmaz valójában az eredmény.
A GPT-5 Image Mini különbözik a teljes GPT-5 Image profiltól, amely a GPT-5 és GPT Image 1 modelleket ötvözi. A Mini profilt körülhatárolt nyelvi és vizuális feladatokhoz használja, amelyek feladatleírása és ellenőrzési szempontjai egyértelműek. Ellenőrizze a kompozíciót, a tárgy azonosságát, a képen szereplő szöveget és a kiegészítő prózát, majd kérje a szükséges konkrét javítást. A következő feladatleírásban őrizze meg a sikeres elemeket és a releváns referenciákat, hogy az átdolgozásnak konkrét célja legyen.
POST /v1/images/generationstext, imageimage| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/gpt-5-image-mini | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 1:1, 3:2, 2:3, auto | Alapértelmezett— |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, low, medium, high | Alapértelmezett— |
Mezőbackground | Típusstring | KövetelményOpcionális | Értékek és korlátok auto, transparent, opaque | Alapértelmezett— |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 Maximum: 10 | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 16 | Alapértelmezett— |
Mezőoutput_compression | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 0 Maximum: 100 | Alapértelmezett— |
Mezőprovider | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paramétermaterial_types | Szerződéstext, image |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · A ténylegesen visszaadott task_id vagy a médiatár bejegyzése
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.065536 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-5-image-mini', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nTöltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nMentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Őrizze meg a teljes választ és a fejléceket, minden tényleges kimenetet, az eredetileg visszaadott azonosítókat és az összes használati adatmezőt. Az eredeti műveletet állítsa helyre, a létrehozási kérés újbóli beküldése nélkül.
Őrizze meg a visszaadott X-Client-Request-ID értéket az egyeztetéshez. Csak a ténylegesen visszaadott task_id/asset_id értékekkel kérdezzen le, vagy használja a saját médiatárat; soha ne állítson össze feladat-URL-t a műveletazonosítóból, és soha ne küldje be újra a létrehozási kérést.
| Mező | Típus |
|---|---|
Mezőcreated | Típus |
Meződata[].url | Típus |
Meződata[].b64_json | Típus |
Mezőusage | Típus |
Ailoot Ultra openai/gpt-5-image-mini
/v1/images
openai/gpt-5-image-miniA GPT-5 Image Mini az OpenAI GPT-5 Mini nyelvi képességeit ötvözi a GPT Image 1 Mini modellel vizuális tartalom létrehozásához és referenciák alapján végzett szerkesztéshez. Szöveget, képeket és dokumentumokat fogad, és szöveget, valamint képeket ad vissza, támogatva az írásos választ és képi anyagot egyaránt igénylő munkafolyamatokat.
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A GPT-5 Image Mini az OpenAI GPT-5 Mini és GPT Image 1 Mini modelljeire épülő, kombinált nyelvi és képi profil. Nyelvi komponense egy írásos feladatot és a forrásanyagot értelmezi, míg képi komponense vizuális tartalmat hoz létre vagy dolgoz át. A közzétett profil az utasítások követését, a szöveg képi megjelenítését és a részletes képszerkesztést hangsúlyozza. Olyan célzott vizuális feladatleíráshoz hasznos, amely szöveges értelmezést, magyarázatot vagy kiegészítő szöveget is igényel.
Készítsen feladatleírást a kívánt képi anyaggal, témával, kompozícióval és szükséges szöveggel. Írja le a kép felhasználását, például termékkoncepcióként, egy rövid magyarázatot kísérő illusztrációként vagy egy oldal vizuális vázlataként. Kifejezetten kérje az írásos és vizuális eredményeket, hogy a koncepció magyarázata könnyen elkülönüljön magától a képtől.
Például adja meg egy újrahasználható vizespalack leírását, és kérjen egyszerű termékjelenet-koncepciót rövid képaláírással. Határozza meg a palack látható alakját, a hátteret, a fény irányát és a képen szereplő pontos szavakat. A képaláírás tényeit különítse el a jelenet dekoratív részleteitől. A visszaadott képet és az írott szöveget vesse össze a feladatleírás e két részével.
A dokumentált kombinált profil szöveget, képeket és például PDF-fájlokat fogad. Egy dokumentum követelményeket vagy a vizuális anyag létrehozása előtt értelmezendő tényeket adhat. Egy kép megjelenést, elrendezést vagy szerkesztési forrást szolgáltathat. Nevezze meg minden forrás szerepét, ahelyett hogy feltételezné, hogy minden mellékletnek az eredmény minden részére hatnia kell. Több bemenet esetén a források neve és sorrendje maradjon egyértelmű.
Új képnél határozza meg, minek kell látszania, és hogyan kapcsolódnak egymáshoz a részek. Referenciák alapján végzett szerkesztésnél nevezze meg a változtatást és a megőrzendő részleteket. Egy termékjelenet új környezetet kérhet a tárgy felismerhető alakjának és látható címkéjének megőrzésével. Egy ábra egy összefüggés javítását kérheti, a változatlanul hagyandó szöveg és elemek megnevezésével.
A profil saját közzétett kártyája legfeljebb tizenhat referenciaképet enged meg szerkesztéshez. Válasszon a feladathoz hozzájáruló referenciákat, és magyarázza el a céljukat: a terméket, a szereplőt, a hátteret vagy a képi megjelenítést. Több referencia egymásnak ellentmondó megvilágítást vagy kompozíciót tartalmazhat, ezért egyértelműen nevezze meg a kívánt eredményt. A ténylegesen visszaadott képen vizsgálja meg a téma részleteit, a betűket és a kért módosítás határait.
A szöveg képi megjelenítése dokumentált képesség, de egy vizuális vázlatot továbbra is szóról szóra ellenőrizni kell. Adja meg a pontos szöveget, írásjeleket és elhelyezést, majd a fontos feliratokat és számokat a tervezett megtekintési méretben hasonlítsa össze a feladatleírással. Ismétlődő sorozatnál minden eredménnyel együtt őrizze meg a referenciákat és a vizuális követelményeket, és az elkészült képeket egymással is vesse össze.
A kombinált profil 400 000 tokenes kontextusablakot és legfeljebb 128 000 válaszgenerálási tokent tesz közzé. Ezek a munkakontextus és a válaszgenerálás keretei, elkülönülve a kép képpontméreteitől és a visszaadott képi eredmények számától. A hosszú forrásanyagot a szükséges értelmezés köré rendezze, és hagyjon helyet a válasznak. Egy tömör, releváns referenciákat tartalmazó feladatleírás hasznosabb, mint a feladathoz nem kapcsolódó dokumentumok, amelyek szerepét nem magyarázták el.
Közzétett szöveges kimeneti specifikációja JSON-séma szerinti strukturált eredményeket támogat. Határozza meg a mezőket és típusokat, ha egy írásos eredményt alkalmazásnak kell feldolgoznia, és az értékeket ellenőrizze a megadott bizonyítékok alapján. A kombinált profil nem tesz elérhetővé alkalmazásbeli függvényhívást. A nyelvi komponens képgenerálással együtt történő használata a profil megnevezett képessége; ettől egy önálló GPT-5 Mini felület nem minden funkciója válik e munkafolyamat részévé.
A képbeállításoknak a pontosan használt profilból és felületből kell származniuk. A változatok összehasonlításakor a kiválasztott konfigurációt őrizze meg az utasítással együtt. A közvetlen GPT Image 1 Mini komponens és egy kombinált csevegőprofil kérési felépítése eltér, ezért a komponens méret-, maszk- vagy kimeneti vezérlőinek kifejezetten megadott megfeleltetése szükséges, mielőtt a kombinált profil beállításaiként kezelnék őket.
A dokumentált csevegési kérésséma text és image kimeneti modalitásokat választhat. Dolgozza fel a visszaadott szöveget és minden tényleges képi eredményt, amely a generált választ kíséri. A képeket az eredményben jelzett formátumban mentse el, és az írásos választ őrizze meg az utasítással, a forrásreferenciákkal és a beállításokkal együtt. Egy csak magyarázó szöveget tartalmazó válasz különbözik egy elkészült vizuális eredménytől, ezért elrendezésben történő felhasználás előtt ellenőrizze, mit tartalmaz valójában az eredmény.
A GPT-5 Image Mini különbözik a teljes GPT-5 Image profiltól, amely a GPT-5 és GPT Image 1 modelleket ötvözi. A Mini profilt körülhatárolt nyelvi és vizuális feladatokhoz használja, amelyek feladatleírása és ellenőrzési szempontjai egyértelműek. Ellenőrizze a kompozíciót, a tárgy azonosságát, a képen szereplő szöveget és a kiegészítő prózát, majd kérje a szükséges konkrét javítást. A következő feladatleírásban őrizze meg a sikeres elemeket és a releváns referenciákat, hogy az átdolgozásnak konkrét célja legyen.
POST /v1/messagestextjson, sse| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/gpt-5-image-mini | Alapértelmezett— |
Mezőmessages | Típusmessage[] | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőmessages[].role | Típusstring | KövetelményKötelező | Értékek és korlátok user, assistant | Alapértelmezett— |
Mezőmessages[].content | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőmax_tokens | Típusinteger | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok | Alapértelmezettfalse |
Szöveg · UTF-8 szöveg
messages[].content karakterlánc
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, messages, max_tokens |
Paraméteroptional_controls | Szerződésstream |
Paramétermaterial_types | Szerződéstext |
Paramétertext_file_material | SzerződésOlvassa el a tényleges UTF-8 dokumentumot, és tegye a szövegét a jelzett bemeneti karakterláncba vagy az üzenettartalom karakterláncába. |
Életciklus: synchronous_or_streamed
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Kontextustokenek, több mint | Kontextustokenek, legfeljebb | Díj |
|---|---|---|---|---|
| BeállításTokenenkénti alapárak | DíjtáblázatAlapdíj | Kontextustokenek, több mint— | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.005 / 1K token Kimenet · Kimeneti tokenek $0.004 / 1K token Bemenet · Gyorsítótár olvasása $0.0005 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token Kimenet · Kimeneti képtokenek $0.016 / 1K képtoken |
| BeállításA kéréshossz szerinti 1. ársáv | Díjtáblázat— | Kontextustokenek, több mint0 | Kontextustokenek, legfeljebbNincs felső korlát | Díj Bemenet · Bemeneti tokenek $0.005 / 1K token Kimenet · Kimeneti tokenek $0.004 / 1K token Bemenet · Gyorsítótár olvasása $0.0005 / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
{\n "model": "openai/gpt-5-image-mini",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'openai/gpt-5-image-mini', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'openai/gpt-5-image-mini', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON vagy SSE
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg az összes tartalomblokkot, a gondolkodási tartalom aláírásait és a tényleges eszközhasználati ID-kat. Állítsa össze az összes SSE-blokk részleges frissítését; az első szövegblokk nem a teljes kimenet.
Őrizze meg a kérés-/válaszazonosítókat és a fejléceket. Nincs megadva általános URL a szöveges feladatok lekéréséhez.
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőmodel | Típusstring |
Mezőcontent[] | Típustext|thinking|tool_use|other content block |
Mezőstop_reason | Típusstring|null |
Mezőusage | Típusobject |
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Ailoot Ultra openai/gpt-5-image-mini
/v1/images
Technikai példa angolul
Create a labelled refill-bottle scene\n\nCreate a product-scene image of a plain cylindrical blue reusable water bottle with a silver screw cap, standing upright on pale stone. Soft daylight enters from the left. Place the exact word REFILL clearly on the bottle, with no other text, logos, accessories or unsupported product claims. Keep the full bottle visible.One image artifact showing the full specified bottle, left-side daylight and the exact single-word label.Inspect the actual image for bottle shape, cap, complete framing and letter-by-letter spelling of REFILL.