{ "aboutHtml": "

GPT Image 2.5 Flare — OpenAI компаниясының күнделікті жылдам әрі сапалы жұмысқа арналған кескін генерациялау және өңдеу нұсқасы. Ол мәтін мен кескіндерді қабылдап, кескін нәтижелерін қайтарады. Тапсырма жедел пайдаланылатын кескінге айналуы тиіс визуалдық нобайлар, иллюстрациялар, тауар тұжырымдамалары мен қайталанатын шығармашылық жұмыстар үшін оны пайдаланыңыз. Flare өңдеу дәлдігіне басымдық беретін Sunburst нұсқасынан бөлек. Күнделікті кескін жасау үшін Flare, дәл өңдеу басым болса Sunburst таңдаңыз.

Негізгі нысаннан, әрекеттен, ортадан, композиция мен визуалдық өңдеуден бастаңыз. Науқан иллюстрациясы үшін жылы кешкі жарықта шағын көпірден өтіп бара жатқан велосипедшіні, айқын сұлба мен кейінгі мәтінге ашық аспанды сұраңыз. Ықшам ізденіс тапсырмасы эстетикалық шешімдерді ашық қалдыра алады; өндірістік тапсырма маңызды бөлшектер мен орынды атауы тиіс. Тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрау мен бірден онға дейін нәтижеге рұқсат етеді, сондықтан бірнеше нұсқаны бір мақсатпен салыстыру пайдалы.

Өңдеуге он алтыға дейін үлгі кескін беруге болады. Модель кескін нысан сәйкестігін, ортаны не стильді білдіретінін өзі шешеді деп күтпей, әр үлгіге анық рөл беріңіз. Маска аймақтағы өзгерісті бағыттай алады; бірнеше кескінде ол біріншісіне қолданылады. Кескін мен масканың пішімі мен өлшемдері сәйкес болуы, ал маскада альфа-арна болуы керек. Нұсқаулық түпнұсқа мен масканың 50 МБ-тан кіші болуын талап етеді. Маска — дәл шекара сақталуына уәде емес, бағыттау құралы, сондықтан қажетті өзгерісті де, танылатын күйде қалуы тиіс нәрсені де көрсетіңіз.

Flare low, medium, high, xhigh, max және автоматты сапаны қолдайды, әдепкісі auto. Төмен сапа жылдам визуалдық нобайға жарайды; соңғы материал бөлшектері үшін жоғары параметрлерді салыстыруға болады. Сапа өлшем мен нәтиже сығуынан тәуелсіз. Стандартты өлшемдерге 1024 × 1024, 1536 × 1024 және 1024 × 1536 кіреді; автоматты немесе жеке өлшемдер де қолжетімді. Бағытты соңғы орналасу мен көріністегі пайдалы кеңістікке қарай таңдаңыз.

Жеке ен мен биіктік он алтыға еселік болып, екі жағы да 3840 пиксельден аспауы тиіс. Рұқсат етілген арақатынас 1:3-тен 3:1-ге дейін, ал жалпы аудан кемінде 655 360 және ең көбі 8 294 400 пиксель болуы керек. Төрт шарт бірге қолданылады. Нұсқаулық 2560 × 1440 өлшемінен жоғары ажыратымдылықтарды эксперименттік деп атайды. Ірі ажыратымдылықты автоматты орналасу жақсаруы деп санамай, композицияға сай жарамды кадрды қолданып, қиылуға сезімтал бөлшектерді тапсырмаға қосыңыз.

Нәтиже пішімі әдепкіде PNG, баламалары — JPEG және WebP. JPEG пен WebP 0-ден 100-ге дейінгі сығуға рұқсат етеді. Мөлдір фон үшін PNG немесе WebP таңдаңыз; мөлдір емес және автоматты фондар да қолдау табады. Мөлдір материалды кейінгі макетке орналастыруға болады, ал мөлдір емес кескін өз фонын қамтиды. Пішім, фон және сығуды нақты жеткізу қажеттілігіне сай таңдап, аяқталған файлды тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.

Өндіруші тікелей кескін генерациясы мен өңдеуді, сондай-ақ таңдалған нәтижелерді кейінгі өзгерістерге сақтай алатын диалогтық кескін құралын құжаттайды. Бұл үдерісте контексте кескін болса, әрекет автоматты, мәжбүрлі генерация немесе мәжбүрлі өңдеу бола алады. Ағындық жеткізу соңғы нәтижеге дейін үшке дейін жартылай кескін көрсете алады. Бұл алдын ала көріністер қосымша дайын материал емес, ілгерілеуді көрсетеді. Итерациялық жұмыста таңдалған кескіннен жалғастырып, бір нысанды жылжыту немесе түс өңдеуін реттеу сияқты көрінетін өзгерісті сипаттаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.

Кескіннің жазуларын, заттардың орнын, нысан бөлшектері мен композициясын жоспарланған өлшемде тексеріңіз. GPT Image нақты мәтін орналастыруда, құрылымды макеттерде және генерациялар арасында қайталанатын визуалдық сәйкестікте әлі қиналуы мүмкін. Қабылданған нұсқаны келесі үлгі ретінде сақтап, кейінгі өңдеуді маңызды мәселемен шектеңіз. Flare нұсқасының күнделікті генерация рөлі тапсырма, визуалдық баламалар, таңдау және жетілдірудің анық тізбегіне пайдалы; соңғы материал нақты шығармашылық мақсатпен бағаланады.

", "aboutText": "GPT Image 2.5 Flare — OpenAI компаниясының күнделікті жылдам әрі сапалы жұмысқа арналған кескін генерациялау және өңдеу нұсқасы. Ол мәтін мен кескіндерді қабылдап, кескін нәтижелерін қайтарады. Тапсырма жедел пайдаланылатын кескінге айналуы тиіс визуалдық нобайлар, иллюстрациялар, тауар тұжырымдамалары мен қайталанатын шығармашылық жұмыстар үшін оны пайдаланыңыз. Flare өңдеу дәлдігіне басымдық беретін Sunburst нұсқасынан бөлек. Күнделікті кескін жасау үшін Flare, дәл өңдеу басым болса Sunburst таңдаңыз.\n\nНегізгі нысаннан, әрекеттен, ортадан, композиция мен визуалдық өңдеуден бастаңыз. Науқан иллюстрациясы үшін жылы кешкі жарықта шағын көпірден өтіп бара жатқан велосипедшіні, айқын сұлба мен кейінгі мәтінге ашық аспанды сұраңыз. Ықшам ізденіс тапсырмасы эстетикалық шешімдерді ашық қалдыра алады; өндірістік тапсырма маңызды бөлшектер мен орынды атауы тиіс. Тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрау мен бірден онға дейін нәтижеге рұқсат етеді, сондықтан бірнеше нұсқаны бір мақсатпен салыстыру пайдалы.\n\nӨңдеуге он алтыға дейін үлгі кескін беруге болады. Модель кескін нысан сәйкестігін, ортаны не стильді білдіретінін өзі шешеді деп күтпей, әр үлгіге анық рөл беріңіз. Маска аймақтағы өзгерісті бағыттай алады; бірнеше кескінде ол біріншісіне қолданылады. Кескін мен масканың пішімі мен өлшемдері сәйкес болуы, ал маскада альфа-арна болуы керек. Нұсқаулық түпнұсқа мен масканың 50 МБ-тан кіші болуын талап етеді. Маска — дәл шекара сақталуына уәде емес, бағыттау құралы, сондықтан қажетті өзгерісті де, танылатын күйде қалуы тиіс нәрсені де көрсетіңіз.\n\nFlare low, medium, high, xhigh, max және автоматты сапаны қолдайды, әдепкісі auto. Төмен сапа жылдам визуалдық нобайға жарайды; соңғы материал бөлшектері үшін жоғары параметрлерді салыстыруға болады. Сапа өлшем мен нәтиже сығуынан тәуелсіз. Стандартты өлшемдерге 1024 × 1024, 1536 × 1024 және 1024 × 1536 кіреді; автоматты немесе жеке өлшемдер де қолжетімді. Бағытты соңғы орналасу мен көріністегі пайдалы кеңістікке қарай таңдаңыз.\n\nЖеке ен мен биіктік он алтыға еселік болып, екі жағы да 3840 пиксельден аспауы тиіс. Рұқсат етілген арақатынас 1:3-тен 3:1-ге дейін, ал жалпы аудан кемінде 655 360 және ең көбі 8 294 400 пиксель болуы керек. Төрт шарт бірге қолданылады. Нұсқаулық 2560 × 1440 өлшемінен жоғары ажыратымдылықтарды эксперименттік деп атайды. Ірі ажыратымдылықты автоматты орналасу жақсаруы деп санамай, композицияға сай жарамды кадрды қолданып, қиылуға сезімтал бөлшектерді тапсырмаға қосыңыз.\n\nНәтиже пішімі әдепкіде PNG, баламалары — JPEG және WebP. JPEG пен WebP 0-ден 100-ге дейінгі сығуға рұқсат етеді. Мөлдір фон үшін PNG немесе WebP таңдаңыз; мөлдір емес және автоматты фондар да қолдау табады. Мөлдір материалды кейінгі макетке орналастыруға болады, ал мөлдір емес кескін өз фонын қамтиды. Пішім, фон және сығуды нақты жеткізу қажеттілігіне сай таңдап, аяқталған файлды тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.\n\nӨндіруші тікелей кескін генерациясы мен өңдеуді, сондай-ақ таңдалған нәтижелерді кейінгі өзгерістерге сақтай алатын диалогтық кескін құралын құжаттайды. Бұл үдерісте контексте кескін болса, әрекет автоматты, мәжбүрлі генерация немесе мәжбүрлі өңдеу бола алады. Ағындық жеткізу соңғы нәтижеге дейін үшке дейін жартылай кескін көрсете алады. Бұл алдын ала көріністер қосымша дайын материал емес, ілгерілеуді көрсетеді. Итерациялық жұмыста таңдалған кескіннен жалғастырып, бір нысанды жылжыту немесе түс өңдеуін реттеу сияқты көрінетін өзгерісті сипаттаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.\n\nКескіннің жазуларын, заттардың орнын, нысан бөлшектері мен композициясын жоспарланған өлшемде тексеріңіз. GPT Image нақты мәтін орналастыруда, құрылымды макеттерде және генерациялар арасында қайталанатын визуалдық сәйкестікте әлі қиналуы мүмкін. Қабылданған нұсқаны келесі үлгі ретінде сақтап, кейінгі өңдеуді маңызды мәселемен шектеңіз. Flare нұсқасының күнделікті генерация рөлі тапсырма, визуалдық баламалар, таңдау және жетілдірудің анық тізбегіне пайдалы; соңғы материал нақты шығармашылық мақсатпен бағаланады.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f7c47ea4f3f35199757e1a0f6318e548272f560f2b00c24f1d751e5f62365d5e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "

O

OpenAI: GPT Image 2.5 Flare

OpenAI /gpt-image-2.5-flare

Бастау

GPT Image 2.5 Flare күнделікті жылдам визуалдық жасауға бағытталып, мәтін мен үлгілерден кескіндер жасайды және өңдейді. Ол нобайлар, иллюстрациялар мен науқан материалдары үшін жеке өлшемдерді, мөлдір фонды, маскаларды және max деңгейіне дейінгі сапаны қолдайды.

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Суреттер

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

GPT Image 2.5 Flare — OpenAI компаниясының күнделікті жылдам әрі сапалы жұмысқа арналған кескін генерациялау және өңдеу нұсқасы. Ол мәтін мен кескіндерді қабылдап, кескін нәтижелерін қайтарады. Тапсырма жедел пайдаланылатын кескінге айналуы тиіс визуалдық нобайлар, иллюстрациялар, тауар тұжырымдамалары мен қайталанатын шығармашылық жұмыстар үшін оны пайдаланыңыз. Flare өңдеу дәлдігіне басымдық беретін Sunburst нұсқасынан бөлек. Күнделікті кескін жасау үшін Flare, дәл өңдеу басым болса Sunburst таңдаңыз.

Негізгі нысаннан, әрекеттен, ортадан, композиция мен визуалдық өңдеуден бастаңыз. Науқан иллюстрациясы үшін жылы кешкі жарықта шағын көпірден өтіп бара жатқан велосипедшіні, айқын сұлба мен кейінгі мәтінге ашық аспанды сұраңыз. Ықшам ізденіс тапсырмасы эстетикалық шешімдерді ашық қалдыра алады; өндірістік тапсырма маңызды бөлшектер мен орынды атауы тиіс. Тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрау мен бірден онға дейін нәтижеге рұқсат етеді, сондықтан бірнеше нұсқаны бір мақсатпен салыстыру пайдалы.

Өңдеуге он алтыға дейін үлгі кескін беруге болады. Модель кескін нысан сәйкестігін, ортаны не стильді білдіретінін өзі шешеді деп күтпей, әр үлгіге анық рөл беріңіз. Маска аймақтағы өзгерісті бағыттай алады; бірнеше кескінде ол біріншісіне қолданылады. Кескін мен масканың пішімі мен өлшемдері сәйкес болуы, ал маскада альфа-арна болуы керек. Нұсқаулық түпнұсқа мен масканың 50 МБ-тан кіші болуын талап етеді. Маска — дәл шекара сақталуына уәде емес, бағыттау құралы, сондықтан қажетті өзгерісті де, танылатын күйде қалуы тиіс нәрсені де көрсетіңіз.

Flare low, medium, high, xhigh, max және автоматты сапаны қолдайды, әдепкісі auto. Төмен сапа жылдам визуалдық нобайға жарайды; соңғы материал бөлшектері үшін жоғары параметрлерді салыстыруға болады. Сапа өлшем мен нәтиже сығуынан тәуелсіз. Стандартты өлшемдерге 1024 × 1024, 1536 × 1024 және 1024 × 1536 кіреді; автоматты немесе жеке өлшемдер де қолжетімді. Бағытты соңғы орналасу мен көріністегі пайдалы кеңістікке қарай таңдаңыз.

Жеке ен мен биіктік он алтыға еселік болып, екі жағы да 3840 пиксельден аспауы тиіс. Рұқсат етілген арақатынас 1:3-тен 3:1-ге дейін, ал жалпы аудан кемінде 655 360 және ең көбі 8 294 400 пиксель болуы керек. Төрт шарт бірге қолданылады. Нұсқаулық 2560 × 1440 өлшемінен жоғары ажыратымдылықтарды эксперименттік деп атайды. Ірі ажыратымдылықты автоматты орналасу жақсаруы деп санамай, композицияға сай жарамды кадрды қолданып, қиылуға сезімтал бөлшектерді тапсырмаға қосыңыз.

Нәтиже пішімі әдепкіде PNG, баламалары — JPEG және WebP. JPEG пен WebP 0-ден 100-ге дейінгі сығуға рұқсат етеді. Мөлдір фон үшін PNG немесе WebP таңдаңыз; мөлдір емес және автоматты фондар да қолдау табады. Мөлдір материалды кейінгі макетке орналастыруға болады, ал мөлдір емес кескін өз фонын қамтиды. Пішім, фон және сығуды нақты жеткізу қажеттілігіне сай таңдап, аяқталған файлды тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.

Өндіруші тікелей кескін генерациясы мен өңдеуді, сондай-ақ таңдалған нәтижелерді кейінгі өзгерістерге сақтай алатын диалогтық кескін құралын құжаттайды. Бұл үдерісте контексте кескін болса, әрекет автоматты, мәжбүрлі генерация немесе мәжбүрлі өңдеу бола алады. Ағындық жеткізу соңғы нәтижеге дейін үшке дейін жартылай кескін көрсете алады. Бұл алдын ала көріністер қосымша дайын материал емес, ілгерілеуді көрсетеді. Итерациялық жұмыста таңдалған кескіннен жалғастырып, бір нысанды жылжыту немесе түс өңдеуін реттеу сияқты көрінетін өзгерісті сипаттаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.

Кескіннің жазуларын, заттардың орнын, нысан бөлшектері мен композициясын жоспарланған өлшемде тексеріңіз. GPT Image нақты мәтін орналастыруда, құрылымды макеттерде және генерациялар арасында қайталанатын визуалдық сәйкестікте әлі қиналуы мүмкін. Қабылданған нұсқаны келесі үлгі ретінде сақтап, кейінгі өңдеуді маңызды мәселемен шектеңіз. Flare нұсқасының күнделікті генерация рөлі тапсырма, визуалдық баламалар, таңдау және жетілдірудің анық тізбегіне пайдалы; соңғы материал нақты шығармашылық мақсатпен бағаланады.

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot · Суреттер POST /v1/images/generations

Кіріс: text
Шығыс: image
Шығыс пішімі: Сурет файлы

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер gpt-image-2.5-flare	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1	Әдепкі1
Өріс`response_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер url, b64_json	Әдепкі—
Өріс`stream`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкіfalse
Өріс`size`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`quality`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`background`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`output_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`output_compression`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`moderation`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`input_fidelity`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`style`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—
Өріс`partial_images`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Модельге байланысты	Әдепкі—

Кіріс материалдарының үйлесімдері

Мәтіннен сурет жасау · Міндетті: prompt

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`material_types`	Параметр талаптарыtext
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`optional_controls`	Параметр талаптарыnull
Параметр`content_type`	Параметр талаптарыapplication/json

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.

Тарифтер

Ailoot әдістерінің мөлшерлемелері

Ailoot СуреттерPOST /v1/images/generations

Мәтіндік кіріс: 0,005 $ / 1K
Кіріс, сурет: 0,008 $ / 1K tokens
Шығыс, сурет: 0,03 $ / 1K tokens

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot · Суреттер

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\n

from openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\n

import OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n  if(!encoded && uri.startsWith("data:image/")) {\n    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n    encoded=uri.slice(comma+1);\n  }\n  if(encoded) {\n    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n    raw=Buffer.from(encoded,"base64");\n  } else if(uri) {\n    const u=new URL(uri,"https://api.ailoot.ai");\n    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n    if(!response.ok) throw new Error("Image content download failed: "+response.status);\n    raw=Buffer.from(await response.arrayBuffer());\n  } else throw new Error("Image has neither bytes nor URL");\n  if(!raw.length) throw new Error("Empty image result");\n  const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n  writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n

Нәтижелерді алу және сақтау

Ailoot · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

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

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.

Бастапқы жауапты тексеру қажет болса

Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түріinteger
Өріс`data[].url`	Түріstring
Өріс`data[].b64_json`	Түріbase64 string
Өріс`usage`	Түріobject

Қателер және келесі қадамдар

Жауап	Шарт	Келесі қадам
Жауап400 · `invalid_request_error`	ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате	Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.
Жауап`server_error`	ШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген	Келесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.

Балама атаулар

Модельдердің балама атаулары

Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-flare", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|gpt-image-2.5-flare", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Міндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате", "http_status": 400, "recovery": "Жаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.", "type": "invalid_request_error" }, { "code": null, "condition": "Қайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген", "http_status": null, "recovery": "Бастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз." }, "material_combinations": [ { "content_types": [ "application/json", "multipart/form-data" ], "file_id_supported": false, "mode": "text_to_image", "multipart_part_read_limit_bytes": 20971520, "optional_mask": { "json": "mask.image_url", "multipart": "mask" }, "reference_representations": { "json": "images[].image_url", "multipart": [ "image", "image[]", "image[index]" ] }, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "quality", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "background", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_format", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_compression", "required": false, "type": "integer" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "moderation", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_fidelity", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "style", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id" ] }, "hints": [ "Әдіс құрылымдары мен ID мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Нақты қайтарылған task_id немесе медиатека жазбасы", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: \"${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}\"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"gpt-image-2.5-flare\", \"prompt\": \"\"}')\nf=Path(os.environ[\"AILOOT_PROMPT_FILE\"])\nif not f.is_file():raise SystemExit(\"Choose your actual UTF-8 brief\")\np['prompt']=f.read_text(encoding=\"utf-8\")\nif not p['prompt'].strip():raise SystemExit(\"Brief must contain text\")\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\"O

OpenAI: GPT Image 2.5 Flare

OpenAI /gpt-image-2.5-flare

Модель ID

Бастау

GPT Image 2.5 Flare күнделікті жылдам визуалдық жасауға бағытталып, мәтін мен үлгілерден кескіндер жасайды және өңдейді. Ол нобайлар, иллюстрациялар мен науқан материалдары үшін жеке өлшемдерді, мөлдір фонды, маскаларды және max деңгейіне дейінгі сапаны қолдайды.

Қабылданатын кіріс деректері: Мәтін
Нәтижелер: Суреттер

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

GPT Image 2.5 Flare — OpenAI компаниясының күнделікті жылдам әрі сапалы жұмысқа арналған кескін генерациялау және өңдеу нұсқасы. Ол мәтін мен кескіндерді қабылдап, кескін нәтижелерін қайтарады. Тапсырма жедел пайдаланылатын кескінге айналуы тиіс визуалдық нобайлар, иллюстрациялар, тауар тұжырымдамалары мен қайталанатын шығармашылық жұмыстар үшін оны пайдаланыңыз. Flare өңдеу дәлдігіне басымдық беретін Sunburst нұсқасынан бөлек. Күнделікті кескін жасау үшін Flare, дәл өңдеу басым болса Sunburst таңдаңыз.

Негізгі нысаннан, әрекеттен, ортадан, композиция мен визуалдық өңдеуден бастаңыз. Науқан иллюстрациясы үшін жылы кешкі жарықта шағын көпірден өтіп бара жатқан велосипедшіні, айқын сұлба мен кейінгі мәтінге ашық аспанды сұраңыз. Ықшам ізденіс тапсырмасы эстетикалық шешімдерді ашық қалдыра алады; өндірістік тапсырма маңызды бөлшектер мен орынды атауы тиіс. Тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрау мен бірден онға дейін нәтижеге рұқсат етеді, сондықтан бірнеше нұсқаны бір мақсатпен салыстыру пайдалы.

Өңдеуге он алтыға дейін үлгі кескін беруге болады. Модель кескін нысан сәйкестігін, ортаны не стильді білдіретінін өзі шешеді деп күтпей, әр үлгіге анық рөл беріңіз. Маска аймақтағы өзгерісті бағыттай алады; бірнеше кескінде ол біріншісіне қолданылады. Кескін мен масканың пішімі мен өлшемдері сәйкес болуы, ал маскада альфа-арна болуы керек. Нұсқаулық түпнұсқа мен масканың 50 МБ-тан кіші болуын талап етеді. Маска — дәл шекара сақталуына уәде емес, бағыттау құралы, сондықтан қажетті өзгерісті де, танылатын күйде қалуы тиіс нәрсені де көрсетіңіз.

Flare low, medium, high, xhigh, max және автоматты сапаны қолдайды, әдепкісі auto. Төмен сапа жылдам визуалдық нобайға жарайды; соңғы материал бөлшектері үшін жоғары параметрлерді салыстыруға болады. Сапа өлшем мен нәтиже сығуынан тәуелсіз. Стандартты өлшемдерге 1024 × 1024, 1536 × 1024 және 1024 × 1536 кіреді; автоматты немесе жеке өлшемдер де қолжетімді. Бағытты соңғы орналасу мен көріністегі пайдалы кеңістікке қарай таңдаңыз.

Жеке ен мен биіктік он алтыға еселік болып, екі жағы да 3840 пиксельден аспауы тиіс. Рұқсат етілген арақатынас 1:3-тен 3:1-ге дейін, ал жалпы аудан кемінде 655 360 және ең көбі 8 294 400 пиксель болуы керек. Төрт шарт бірге қолданылады. Нұсқаулық 2560 × 1440 өлшемінен жоғары ажыратымдылықтарды эксперименттік деп атайды. Ірі ажыратымдылықты автоматты орналасу жақсаруы деп санамай, композицияға сай жарамды кадрды қолданып, қиылуға сезімтал бөлшектерді тапсырмаға қосыңыз.

Нәтиже пішімі әдепкіде PNG, баламалары — JPEG және WebP. JPEG пен WebP 0-ден 100-ге дейінгі сығуға рұқсат етеді. Мөлдір фон үшін PNG немесе WebP таңдаңыз; мөлдір емес және автоматты фондар да қолдау табады. Мөлдір материалды кейінгі макетке орналастыруға болады, ал мөлдір емес кескін өз фонын қамтиды. Пішім, фон және сығуды нақты жеткізу қажеттілігіне сай таңдап, аяқталған файлды тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.

Өндіруші тікелей кескін генерациясы мен өңдеуді, сондай-ақ таңдалған нәтижелерді кейінгі өзгерістерге сақтай алатын диалогтық кескін құралын құжаттайды. Бұл үдерісте контексте кескін болса, әрекет автоматты, мәжбүрлі генерация немесе мәжбүрлі өңдеу бола алады. Ағындық жеткізу соңғы нәтижеге дейін үшке дейін жартылай кескін көрсете алады. Бұл алдын ала көріністер қосымша дайын материал емес, ілгерілеуді көрсетеді. Итерациялық жұмыста таңдалған кескіннен жалғастырып, бір нысанды жылжыту немесе түс өңдеуін реттеу сияқты көрінетін өзгерісті сипаттаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.

Кескіннің жазуларын, заттардың орнын, нысан бөлшектері мен композициясын жоспарланған өлшемде тексеріңіз. GPT Image нақты мәтін орналастыруда, құрылымды макеттерде және генерациялар арасында қайталанатын визуалдық сәйкестікте әлі қиналуы мүмкін. Қабылданған нұсқаны келесі үлгі ретінде сақтап, кейінгі өңдеуді маңызды мәселемен шектеңіз. Flare нұсқасының күнделікті генерация рөлі тапсырма, визуалдық баламалар, таңдау және жетілдірудің анық тізбегіне пайдалы; соңғы материал нақты шығармашылық мақсатпен бағаланады.

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер gpt-image-2.5-flare	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең үлкен ұзындық: 32 000	Әдепкі—
Өріс`size`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер Шарттар: auto немесе екі өлшемі де 16 санына бөлінетін WIDTHxHEIGHT мәнін пайдаланыңыз. Ең ұзын жағы 3,840 пиксельден, ал жалпы өлшемі 8,300,000 пиксельден аспауы керек.	Әдепкіauto
Өріс`background`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер transparent, opaque, auto	Әдепкіauto
Өріс`moderation`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер low, auto Шарттар: Мазмұнның стандартты модерациясы үшін auto қолданыңыз.	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 10	Әдепкі1
Өріс`quality`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер auto, high, medium, low	Әдепкіauto
Өріс`output_compression`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 0 Ең көбі: 100 Шарттар: JPEG және WebP шығысына қолданылады; құжатталған бүтін сан мәнін жіберіңіз.	Әдепкі100
Өріс`output_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер webp, png, jpeg	Әдепкіpng
Өріс`stream`	Түрі`boolean`	ТалапМіндетті емес	Мәндер мен шектеулер false Шарттар: Бұл маршрут бір толық аяқталған JSON жауабын қайтарады.	Әдепкіfalse

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыprompt, model
Параметр`material_types`	Параметр талаптарыtext
Параметр`optional`	Параметр талаптарыsize, background, moderation, n, quality, output_compression, output_format, stream
Параметр`conditions`	Параметр талаптарыМөлдір фон үшін PNG немесе WebP қажет., Шығысты сығу JPEG немесе WebP үшін қолданылады., Таңдалған әдіс мәтіннен генерация жасайды. Өндіруші сипаттаған өңдеу және ағынмен беру параметрлері бөлек мүмкіндіктерге жатады.

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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\n

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /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.\n

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-flare", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|gpt-image-2.5-flare", "ordinal": 1, "rawMethod": { "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз." }, "outputs": { "all_results": "Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "maxLength": 32000, "maximum_length": 32000, "name": "prompt", "required": true, "type": "string" }, { "conditions": "auto немесе екі өлшемі де 16 санына бөлінетін WIDTHxHEIGHT мәнін пайдаланыңыз. Ең ұзын жағы 3,840 пиксельден, ал жалпы өлшемі 8,300,000 пиксельден аспауы керек.", "default": "auto", "default_known": true, "description": "Use auto or WIDTHxHEIGHT with both dimensions divisible by 16. The longest side is at most 3,840 pixels and total size at most 8,300,000 pixels.", "name": "size", "required": false, "type": "string" }, { "default": "auto", "default_known": true, "enum": [ "transparent", "opaque", "auto" ], "enum_known": true, "name": "background", "required": false, "type": "string" }, { "conditions": "Мазмұнның стандартты модерациясы үшін auto қолданыңыз.", "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "enum_known": true, "name": "moderation", "required": false, "type": "string" }, { "default": 1, "default_known": true, "maximum": 10, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "default": "auto", "default_known": true, "enum": [ "auto", "high", "medium", "low" ], "enum_known": true, "name": "quality", "required": false, "type": "string" }, { "conditions": "JPEG және WebP шығысына қолданылады; құжатталған бүтін сан мәнін жіберіңіз.", "default": 100, "default_known": true, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "name": "output_compression", "required": false, "type": "integer" }, { "default": "png", "default_known": true, "enum": [ "webp", "png", "jpeg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "Бұл маршрут бір толық аяқталған JSON жауабын қайтарады.", "default": false, "default_known": true, "description": "This route returns one completed JSON response.", "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "request_schema": { "properties": { "background": { "default": "auto", "enum": [ "transparent", "opaque", "auto" ], "type": "string" }, "model": { "enum": [ "gpt-image-2.5-flare" ], "type": "string" }, "moderation": { "description": "Use auto for standard content moderation.", "enum": [ "low", "auto" ], "type": "string" }, "n": { "default": 1, "maximum": 10, "minimum": 1, "type": "integer" }, "output_compression": { "default": 100, "description": "Applies to JPEG and WebP output; send the documented integer value.", "maximum": 100, "minimum": 0, "type": "integer" }, "output_format": { "default": "png", "enum": [ "webp", "png", "jpeg" ], "type": "string" }, "prompt": { "maxLength": 32000, "type": "string" }, "quality": { "default": "auto", "enum": [ "auto", "high", "medium", "low" ], "type": "string" }, "size": { "default": "auto", "description": "Use auto or WIDTHxHEIGHT with both dimensions divisible by 16. The longest side is at most 3,840 pixels and total size at most 8,300,000 pixels.", "type": "string" }, "stream": { "default": false, "description": "This route returns one completed JSON response.", "enum": [ false ], "type": "boolean" } }, "required": [ "prompt", "model" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "background": "auto", "model": "gpt-image-2.5-flare", "moderation": "auto", "n": 1, "output_format": "png", "prompt": "A cute baby sea otter", "size": "1024x1024" }, "content_type": "application/json" } }, "input": { "conditions": [ "Мөлдір фон үшін PNG немесе WebP қажет.", "Шығысты сығу JPEG немесе WebP үшін қолданылады.", "Таңдалған әдіс мәтіннен генерация жасайды. Өндіруші сипаттаған өңдеу және ағынмен беру параметрлері бөлек мүмкіндіктерге жатады." ], "content_type": "application/json", "material_types": [ "text" ], "optional": [ "size", "background", "moderation", "n", "quality", "output_compression", "output_format", "stream" ], "required": [ "prompt", "model" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Нақты қайтарылған task_id немесе медиатека жазбасы", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.24576", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.24576", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\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\"O

OpenAI: GPT Image 2.5 Flare

OpenAI /openai/gpt-image-2.5-flare

Модель ID

Бастау

GPT Image 2.5 Flare күнделікті жылдам визуалдық жасауға бағытталып, мәтін мен үлгілерден кескіндер жасайды және өңдейді. Ол нобайлар, иллюстрациялар мен науқан материалдары үшін жеке өлшемдерді, мөлдір фонды, маскаларды және max деңгейіне дейінгі сапаны қолдайды.

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

GPT Image 2.5 Flare — OpenAI компаниясының күнделікті жылдам әрі сапалы жұмысқа арналған кескін генерациялау және өңдеу нұсқасы. Ол мәтін мен кескіндерді қабылдап, кескін нәтижелерін қайтарады. Тапсырма жедел пайдаланылатын кескінге айналуы тиіс визуалдық нобайлар, иллюстрациялар, тауар тұжырымдамалары мен қайталанатын шығармашылық жұмыстар үшін оны пайдаланыңыз. Flare өңдеу дәлдігіне басымдық беретін Sunburst нұсқасынан бөлек. Күнделікті кескін жасау үшін Flare, дәл өңдеу басым болса Sunburst таңдаңыз.

Негізгі нысаннан, әрекеттен, ортадан, композиция мен визуалдық өңдеуден бастаңыз. Науқан иллюстрациясы үшін жылы кешкі жарықта шағын көпірден өтіп бара жатқан велосипедшіні, айқын сұлба мен кейінгі мәтінге ашық аспанды сұраңыз. Ықшам ізденіс тапсырмасы эстетикалық шешімдерді ашық қалдыра алады; өндірістік тапсырма маңызды бөлшектер мен орынды атауы тиіс. Тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрау мен бірден онға дейін нәтижеге рұқсат етеді, сондықтан бірнеше нұсқаны бір мақсатпен салыстыру пайдалы.

Өңдеуге он алтыға дейін үлгі кескін беруге болады. Модель кескін нысан сәйкестігін, ортаны не стильді білдіретінін өзі шешеді деп күтпей, әр үлгіге анық рөл беріңіз. Маска аймақтағы өзгерісті бағыттай алады; бірнеше кескінде ол біріншісіне қолданылады. Кескін мен масканың пішімі мен өлшемдері сәйкес болуы, ал маскада альфа-арна болуы керек. Нұсқаулық түпнұсқа мен масканың 50 МБ-тан кіші болуын талап етеді. Маска — дәл шекара сақталуына уәде емес, бағыттау құралы, сондықтан қажетті өзгерісті де, танылатын күйде қалуы тиіс нәрсені де көрсетіңіз.

Flare low, medium, high, xhigh, max және автоматты сапаны қолдайды, әдепкісі auto. Төмен сапа жылдам визуалдық нобайға жарайды; соңғы материал бөлшектері үшін жоғары параметрлерді салыстыруға болады. Сапа өлшем мен нәтиже сығуынан тәуелсіз. Стандартты өлшемдерге 1024 × 1024, 1536 × 1024 және 1024 × 1536 кіреді; автоматты немесе жеке өлшемдер де қолжетімді. Бағытты соңғы орналасу мен көріністегі пайдалы кеңістікке қарай таңдаңыз.

Жеке ен мен биіктік он алтыға еселік болып, екі жағы да 3840 пиксельден аспауы тиіс. Рұқсат етілген арақатынас 1:3-тен 3:1-ге дейін, ал жалпы аудан кемінде 655 360 және ең көбі 8 294 400 пиксель болуы керек. Төрт шарт бірге қолданылады. Нұсқаулық 2560 × 1440 өлшемінен жоғары ажыратымдылықтарды эксперименттік деп атайды. Ірі ажыратымдылықты автоматты орналасу жақсаруы деп санамай, композицияға сай жарамды кадрды қолданып, қиылуға сезімтал бөлшектерді тапсырмаға қосыңыз.

Нәтиже пішімі әдепкіде PNG, баламалары — JPEG және WebP. JPEG пен WebP 0-ден 100-ге дейінгі сығуға рұқсат етеді. Мөлдір фон үшін PNG немесе WebP таңдаңыз; мөлдір емес және автоматты фондар да қолдау табады. Мөлдір материалды кейінгі макетке орналастыруға болады, ал мөлдір емес кескін өз фонын қамтиды. Пішім, фон және сығуды нақты жеткізу қажеттілігіне сай таңдап, аяқталған файлды тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.

Өндіруші тікелей кескін генерациясы мен өңдеуді, сондай-ақ таңдалған нәтижелерді кейінгі өзгерістерге сақтай алатын диалогтық кескін құралын құжаттайды. Бұл үдерісте контексте кескін болса, әрекет автоматты, мәжбүрлі генерация немесе мәжбүрлі өңдеу бола алады. Ағындық жеткізу соңғы нәтижеге дейін үшке дейін жартылай кескін көрсете алады. Бұл алдын ала көріністер қосымша дайын материал емес, ілгерілеуді көрсетеді. Итерациялық жұмыста таңдалған кескіннен жалғастырып, бір нысанды жылжыту немесе түс өңдеуін реттеу сияқты көрінетін өзгерісті сипаттаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.

Кескіннің жазуларын, заттардың орнын, нысан бөлшектері мен композициясын жоспарланған өлшемде тексеріңіз. GPT Image нақты мәтін орналастыруда, құрылымды макеттерде және генерациялар арасында қайталанатын визуалдық сәйкестікте әлі қиналуы мүмкін. Қабылданған нұсқаны келесі үлгі ретінде сақтап, кейінгі өңдеуді маңызды мәселемен шектеңіз. Flare нұсқасының күнделікті генерация рөлі тапсырма, визуалдық баламалар, таңдау және жетілдірудің анық тізбегіне пайдалы; соңғы материал нақты шығармашылық мақсатпен бағаланады.

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер openai/gpt-image-2.5-flare	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto	Әдепкі—
Өріс`quality`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер auto, low, medium, high, xhigh, max	Әдепкі—
Өріс`background`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер auto, transparent, opaque	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 10	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 16	Әдепкі—
Өріс`output_compression`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 0 Ең көбі: 100	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

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-image-2.5-flare', '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\n

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /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.\n

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare

", "method_identity": { "effective_request_model_id": "openai/gpt-image-2.5-flare", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "openai/gpt-image-2.5-flare", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|openai%2Fgpt-image-2.5-flare", "ordinal": 2, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз." }, "outputs": { "all_results": "Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] }, "parameters": [ { "enum": [ "openai/gpt-image-2.5-flare" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "enum": [ "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" }, { "enum": [ "auto", "transparent", "opaque" ], "enum_known": true, "name": "background", "required": false, "type": "string" }, { "maximum": 10, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maximum_items": 16, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" }, { "maximum": 100, "minimum": 0, "name": "output_compression", "required": false, "type": "integer" }, { "name": "provider", "required": false, "type": "object" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9", "auto" ], "type": "string" }, "background": { "enum": [ "auto", "transparent", "opaque" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 16, "minItems": 0, "type": "array" }, "model": { "enum": [ "openai/gpt-image-2.5-flare" ], "type": "string" }, "n": { "maximum": 10, "minimum": 1, "type": "integer" }, "output_compression": { "maximum": 100, "minimum": 0, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" }, "provider": { "description": "Exact image provider preferences from the documented image request schema.", "type": "object" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "openai/gpt-image-2.5-flare", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json" } }, "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Нақты қайтарылған task_id немесе медиатека жазбасы", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the returned X-Client-Request-ID for reconciliation. Read only actual returned task_id/asset_id values or the owned media library; never build a task URL from the operation ID and never resubmit creation." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "output": { "all_results": "Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.", "family": "image", "fields": [ { "description": null, "name": "created", "type": null }, { "description": null, "name": "data[].url", "type": null }, { "description": null, "name": "data[].b64_json", "type": null }, { "description": null, "name": "usage", "type": null } ] } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.24576", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.24576", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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-image-2.5-flare', '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\"