GPT Image 2 — OpenAI компаниясының мәтін мен визуалдық кірістерден кескін жасау және өңдеу моделі. Ол жазбаша тапсырмадан жаңа кескін жасайды және өңдеу не үлгіге сүйенген жұмыс үшін бастапқы кескіндерді қолдана алады. Практикалық тапсырмаларға иллюстрациялар, тауар тұжырымдамалары, визуалдық композициялар және бар материалды өзгерту кіреді. Бұл — өзінің сапа ауқымы мен кіріс дәлдігі әрекеті бар, GPT Image 2.5 Sunburst және Flare модельдерінен бөлек нұсқа.
Генерация үшін нысанды, көріністі, композицияны, жарық пен қажетті стильді сипаттаңыз. Өңдеу үшін не өзгеруі және не сыртқы көрінісін сақтауы керектігін атаңыз. Тауар тапсырмасы ашық беттегі керамикалық шамды, орталық сұлба мен жазуға орынды сұрай алады; кейінгі өңдеу шам пішіні мен қарау бұрышын сақтап, фонды өзгерте алады. Құжатталған тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрауды қабылдап, бірден онға дейін кескін қайтара алады.
Үлгіге сүйенген өңдеу он алтыға дейін кіріс кескінін қабылдайды. Нысан, фон мен визуалдық өңдеу шатаспау үшін әр үлгінің мақсатын көрсетіңіз. GPT Image 2 әр кескін кірісін автоматты түрде жоғары дәлдікпен өңдейді; input_fidelity берілмеуі тиіс, себебі бұл нұсқада ол реттелмейді. Бұл GPT Image 1 нұсқасының high не low таңдауынан және GPT Image 1 Mini нұсқасының тек low кіріс дәлдігі режимінен өзгеше. Жоғары дәлдікті кіріс өңдеуі бастапқы бөлшектерді қолдайды, бірақ әр бөлшектің өзгеріссіз қайталануына кепілдік бермейді.
Маска өңделетін аймақты анықтай алады. Нұсқаулықтың дайындық талаптары бойынша бастапқы кескін мен масканың пішімі мен өлшемдері бірдей, көлемі 50 МБ-тан кіші болуы тиіс; маскаға альфа-арна да қажет. Бірнеше кіріс кескін берілсе, маскалау біріншісіне қолданылады. Модель масканы қатаң геометриялық шекара емес, сұрауға негізделген бағыттау ретінде қабылдайды. Жергілікті өзгеріс пен сақтау талаптарын сипаттап, кейін көршілес аймақты күтпеген айырмашылықтарға тексеріңіз.
GPT Image 2 low, medium, high және auto сапаны қолдайды, әдепкісі auto. 2.5 топтамасының xhigh және max параметрлері осы нұсқаның сапа ауқымына кірмейді. Өлшем шаршы, көлденең, тік, автоматты немесе жарамды жеке ен мен биіктік бола алады. Өндіруші мысалдарына 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 және 2160 × 3840 пиксель кіреді. Сапа мен өлшемдерді бір басқару деп санамай, бағыт пен бөлшек деңгейін нақты макетке сай таңдаңыз.
Жеке өлшемдер он алты пиксельге еселік болуы тиіс; ең үлкен жағы 3840 пиксель, ұзын жақтың қысқа жаққа арақатынасы 3:1-ден аспайды, ауданы 655 360 пен 8 294 400 пиксель арасында. Бұл шарттар бір мезгілде орындалады. 2560 × 1440 өлшемінен жоғары ажыратымдылықтар эксперименттік деп белгіленген. Бір ережеге сай кадр басқа ережеден өтпеуі мүмкін, сондықтан қолдау көрсетілетін өлшем жұбын таңдап, тапсырмада қиылуға сезімтал элементтерді сипаттаңыз.
Нәтиже әдепкіде PNG, JPEG немесе WebP де қолжетімді. JPEG пен WebP үшін 0-ден 100-ге дейінгі сығу қолдау табады. Фон мөлдір емес не автоматты бола алады; нақты қазіргі анықтама GPT Image 2 мөлдірлігін алдын ала нұсқа мүмкіндігі ретінде сипаттайды. Мөлдірлік сұрағанда альфа-арна сақталуы үшін PNG немесе WebP пайдаланыңыз. Құжатталған ағындық үдеріс дайын кескінге дейін үшке дейін жартылай кескінге рұқсат береді; ілгерілеу көрінісін емес, соңғы материалды сақтаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.
Нақты нәтижеде мәтін анықтығын, заттардың орнын және бастапқы бөлшектердің сақталуын бағалаңыз. GPT Image дәл әріптерде, орналасуға сезімтал композицияларда және бөлек генерациялар арасындағы қайталанатын визуалдық сәйкестікте қиналуы мүмкін. Өңдеулер тізбегінде таңдалған нәтижені келесі түпнұсқа етіп, көрінетін мәселеге байланысты нақты өзгеріс беріңіз. GPT Image 2 моделінің пайдалы нәтижесі — анық генерация не өңдеу тапсырмасымен байланысқан кескін; жоғары дәлдікті кірістері, өлшемдері мен сапасы сол нақты тапсырма үшін таңдалады.
", "aboutText": "GPT Image 2 — OpenAI компаниясының мәтін мен визуалдық кірістерден кескін жасау және өңдеу моделі. Ол жазбаша тапсырмадан жаңа кескін жасайды және өңдеу не үлгіге сүйенген жұмыс үшін бастапқы кескіндерді қолдана алады. Практикалық тапсырмаларға иллюстрациялар, тауар тұжырымдамалары, визуалдық композициялар және бар материалды өзгерту кіреді. Бұл — өзінің сапа ауқымы мен кіріс дәлдігі әрекеті бар, GPT Image 2.5 Sunburst және Flare модельдерінен бөлек нұсқа.\n\nГенерация үшін нысанды, көріністі, композицияны, жарық пен қажетті стильді сипаттаңыз. Өңдеу үшін не өзгеруі және не сыртқы көрінісін сақтауы керектігін атаңыз. Тауар тапсырмасы ашық беттегі керамикалық шамды, орталық сұлба мен жазуға орынды сұрай алады; кейінгі өңдеу шам пішіні мен қарау бұрышын сақтап, фонды өзгерте алады. Құжатталған тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрауды қабылдап, бірден онға дейін кескін қайтара алады.\n\nҮлгіге сүйенген өңдеу он алтыға дейін кіріс кескінін қабылдайды. Нысан, фон мен визуалдық өңдеу шатаспау үшін әр үлгінің мақсатын көрсетіңіз. GPT Image 2 әр кескін кірісін автоматты түрде жоғары дәлдікпен өңдейді; input_fidelity берілмеуі тиіс, себебі бұл нұсқада ол реттелмейді. Бұл GPT Image 1 нұсқасының high не low таңдауынан және GPT Image 1 Mini нұсқасының тек low кіріс дәлдігі режимінен өзгеше. Жоғары дәлдікті кіріс өңдеуі бастапқы бөлшектерді қолдайды, бірақ әр бөлшектің өзгеріссіз қайталануына кепілдік бермейді.\n\nМаска өңделетін аймақты анықтай алады. Нұсқаулықтың дайындық талаптары бойынша бастапқы кескін мен масканың пішімі мен өлшемдері бірдей, көлемі 50 МБ-тан кіші болуы тиіс; маскаға альфа-арна да қажет. Бірнеше кіріс кескін берілсе, маскалау біріншісіне қолданылады. Модель масканы қатаң геометриялық шекара емес, сұрауға негізделген бағыттау ретінде қабылдайды. Жергілікті өзгеріс пен сақтау талаптарын сипаттап, кейін көршілес аймақты күтпеген айырмашылықтарға тексеріңіз.\n\nGPT Image 2 low, medium, high және auto сапаны қолдайды, әдепкісі auto. 2.5 топтамасының xhigh және max параметрлері осы нұсқаның сапа ауқымына кірмейді. Өлшем шаршы, көлденең, тік, автоматты немесе жарамды жеке ен мен биіктік бола алады. Өндіруші мысалдарына 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 және 2160 × 3840 пиксель кіреді. Сапа мен өлшемдерді бір басқару деп санамай, бағыт пен бөлшек деңгейін нақты макетке сай таңдаңыз.\n\nЖеке өлшемдер он алты пиксельге еселік болуы тиіс; ең үлкен жағы 3840 пиксель, ұзын жақтың қысқа жаққа арақатынасы 3:1-ден аспайды, ауданы 655 360 пен 8 294 400 пиксель арасында. Бұл шарттар бір мезгілде орындалады. 2560 × 1440 өлшемінен жоғары ажыратымдылықтар эксперименттік деп белгіленген. Бір ережеге сай кадр басқа ережеден өтпеуі мүмкін, сондықтан қолдау көрсетілетін өлшем жұбын таңдап, тапсырмада қиылуға сезімтал элементтерді сипаттаңыз.\n\nНәтиже әдепкіде PNG, JPEG немесе WebP де қолжетімді. JPEG пен WebP үшін 0-ден 100-ге дейінгі сығу қолдау табады. Фон мөлдір емес не автоматты бола алады; нақты қазіргі анықтама GPT Image 2 мөлдірлігін алдын ала нұсқа мүмкіндігі ретінде сипаттайды. Мөлдірлік сұрағанда альфа-арна сақталуы үшін PNG немесе WebP пайдаланыңыз. Құжатталған ағындық үдеріс дайын кескінге дейін үшке дейін жартылай кескінге рұқсат береді; ілгерілеу көрінісін емес, соңғы материалды сақтаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.\n\nНақты нәтижеде мәтін анықтығын, заттардың орнын және бастапқы бөлшектердің сақталуын бағалаңыз. GPT Image дәл әріптерде, орналасуға сезімтал композицияларда және бөлек генерациялар арасындағы қайталанатын визуалдық сәйкестікте қиналуы мүмкін. Өңдеулер тізбегінде таңдалған нәтижені келесі түпнұсқа етіп, көрінетін мәселеге байланысты нақты өзгеріс беріңіз. GPT Image 2 моделінің пайдалы нәтижесі — анық генерация не өңдеу тапсырмасымен байланысқан кескін; жоғары дәлдікті кірістері, өлшемдері мен сапасы сол нақты тапсырма үшін таңдалады.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "f20770704ccf59ca9d78bd4866652650982d2ab2e23519a857425eb4ec084350", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "gpt-image-2GPT Image 2 мәтін мен визуалдық үлгілерден кескіндер жасайды және өңдейді. Ол икемді кадр өлшемдерін қолдап, кескін кірістерін автоматты түрде жоғары дәлдікпен өңдейді; дайын материал үшін сапа, пішім және фон бөлек басқарылады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
GPT Image 2 — OpenAI компаниясының мәтін мен визуалдық кірістерден кескін жасау және өңдеу моделі. Ол жазбаша тапсырмадан жаңа кескін жасайды және өңдеу не үлгіге сүйенген жұмыс үшін бастапқы кескіндерді қолдана алады. Практикалық тапсырмаларға иллюстрациялар, тауар тұжырымдамалары, визуалдық композициялар және бар материалды өзгерту кіреді. Бұл — өзінің сапа ауқымы мен кіріс дәлдігі әрекеті бар, GPT Image 2.5 Sunburst және Flare модельдерінен бөлек нұсқа.
Генерация үшін нысанды, көріністі, композицияны, жарық пен қажетті стильді сипаттаңыз. Өңдеу үшін не өзгеруі және не сыртқы көрінісін сақтауы керектігін атаңыз. Тауар тапсырмасы ашық беттегі керамикалық шамды, орталық сұлба мен жазуға орынды сұрай алады; кейінгі өңдеу шам пішіні мен қарау бұрышын сақтап, фонды өзгерте алады. Құжатталған тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрауды қабылдап, бірден онға дейін кескін қайтара алады.
Үлгіге сүйенген өңдеу он алтыға дейін кіріс кескінін қабылдайды. Нысан, фон мен визуалдық өңдеу шатаспау үшін әр үлгінің мақсатын көрсетіңіз. GPT Image 2 әр кескін кірісін автоматты түрде жоғары дәлдікпен өңдейді; input_fidelity берілмеуі тиіс, себебі бұл нұсқада ол реттелмейді. Бұл GPT Image 1 нұсқасының high не low таңдауынан және GPT Image 1 Mini нұсқасының тек low кіріс дәлдігі режимінен өзгеше. Жоғары дәлдікті кіріс өңдеуі бастапқы бөлшектерді қолдайды, бірақ әр бөлшектің өзгеріссіз қайталануына кепілдік бермейді.
Маска өңделетін аймақты анықтай алады. Нұсқаулықтың дайындық талаптары бойынша бастапқы кескін мен масканың пішімі мен өлшемдері бірдей, көлемі 50 МБ-тан кіші болуы тиіс; маскаға альфа-арна да қажет. Бірнеше кіріс кескін берілсе, маскалау біріншісіне қолданылады. Модель масканы қатаң геометриялық шекара емес, сұрауға негізделген бағыттау ретінде қабылдайды. Жергілікті өзгеріс пен сақтау талаптарын сипаттап, кейін көршілес аймақты күтпеген айырмашылықтарға тексеріңіз.
GPT Image 2 low, medium, high және auto сапаны қолдайды, әдепкісі auto. 2.5 топтамасының xhigh және max параметрлері осы нұсқаның сапа ауқымына кірмейді. Өлшем шаршы, көлденең, тік, автоматты немесе жарамды жеке ен мен биіктік бола алады. Өндіруші мысалдарына 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 және 2160 × 3840 пиксель кіреді. Сапа мен өлшемдерді бір басқару деп санамай, бағыт пен бөлшек деңгейін нақты макетке сай таңдаңыз.
Жеке өлшемдер он алты пиксельге еселік болуы тиіс; ең үлкен жағы 3840 пиксель, ұзын жақтың қысқа жаққа арақатынасы 3:1-ден аспайды, ауданы 655 360 пен 8 294 400 пиксель арасында. Бұл шарттар бір мезгілде орындалады. 2560 × 1440 өлшемінен жоғары ажыратымдылықтар эксперименттік деп белгіленген. Бір ережеге сай кадр басқа ережеден өтпеуі мүмкін, сондықтан қолдау көрсетілетін өлшем жұбын таңдап, тапсырмада қиылуға сезімтал элементтерді сипаттаңыз.
Нәтиже әдепкіде PNG, JPEG немесе WebP де қолжетімді. JPEG пен WebP үшін 0-ден 100-ге дейінгі сығу қолдау табады. Фон мөлдір емес не автоматты бола алады; нақты қазіргі анықтама GPT Image 2 мөлдірлігін алдын ала нұсқа мүмкіндігі ретінде сипаттайды. Мөлдірлік сұрағанда альфа-арна сақталуы үшін PNG немесе WebP пайдаланыңыз. Құжатталған ағындық үдеріс дайын кескінге дейін үшке дейін жартылай кескінге рұқсат береді; ілгерілеу көрінісін емес, соңғы материалды сақтаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.
Нақты нәтижеде мәтін анықтығын, заттардың орнын және бастапқы бөлшектердің сақталуын бағалаңыз. GPT Image дәл әріптерде, орналасуға сезімтал композицияларда және бөлек генерациялар арасындағы қайталанатын визуалдық сәйкестікте қиналуы мүмкін. Өңдеулер тізбегінде таңдалған нәтижені келесі түпнұсқа етіп, көрінетін мәселеге байланысты нақты өзгеріс беріңіз. GPT Image 2 моделінің пайдалы нәтижесі — анық генерация не өңдеу тапсырмасымен байланысқан кескін; жоғары дәлдікті кірістері, өлшемдері мен сапасы сол нақты тапсырма үшін таңдалады.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер gpt-image-2 | Әдепкі— |
Өріс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 мәндері дәл берілген; жеткізушінің мүмкіндігі сұрауды қабылдаудан бөлек қаралады.
POST /v1/images/generationsAiloot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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", "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\nfrom 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', '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])\nimport 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", "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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /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
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
gpt-image-2GPT Image 2 мәтін мен визуалдық үлгілерден кескіндер жасайды және өңдейді. Ол икемді кадр өлшемдерін қолдап, кескін кірістерін автоматты түрде жоғары дәлдікпен өңдейді; дайын материал үшін сапа, пішім және фон бөлек басқарылады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
GPT Image 2 — OpenAI компаниясының мәтін мен визуалдық кірістерден кескін жасау және өңдеу моделі. Ол жазбаша тапсырмадан жаңа кескін жасайды және өңдеу не үлгіге сүйенген жұмыс үшін бастапқы кескіндерді қолдана алады. Практикалық тапсырмаларға иллюстрациялар, тауар тұжырымдамалары, визуалдық композициялар және бар материалды өзгерту кіреді. Бұл — өзінің сапа ауқымы мен кіріс дәлдігі әрекеті бар, GPT Image 2.5 Sunburst және Flare модельдерінен бөлек нұсқа.
Генерация үшін нысанды, көріністі, композицияны, жарық пен қажетті стильді сипаттаңыз. Өңдеу үшін не өзгеруі және не сыртқы көрінісін сақтауы керектігін атаңыз. Тауар тапсырмасы ашық беттегі керамикалық шамды, орталық сұлба мен жазуға орынды сұрай алады; кейінгі өңдеу шам пішіні мен қарау бұрышын сақтап, фонды өзгерте алады. Құжатталған тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрауды қабылдап, бірден онға дейін кескін қайтара алады.
Үлгіге сүйенген өңдеу он алтыға дейін кіріс кескінін қабылдайды. Нысан, фон мен визуалдық өңдеу шатаспау үшін әр үлгінің мақсатын көрсетіңіз. GPT Image 2 әр кескін кірісін автоматты түрде жоғары дәлдікпен өңдейді; input_fidelity берілмеуі тиіс, себебі бұл нұсқада ол реттелмейді. Бұл GPT Image 1 нұсқасының high не low таңдауынан және GPT Image 1 Mini нұсқасының тек low кіріс дәлдігі режимінен өзгеше. Жоғары дәлдікті кіріс өңдеуі бастапқы бөлшектерді қолдайды, бірақ әр бөлшектің өзгеріссіз қайталануына кепілдік бермейді.
Маска өңделетін аймақты анықтай алады. Нұсқаулықтың дайындық талаптары бойынша бастапқы кескін мен масканың пішімі мен өлшемдері бірдей, көлемі 50 МБ-тан кіші болуы тиіс; маскаға альфа-арна да қажет. Бірнеше кіріс кескін берілсе, маскалау біріншісіне қолданылады. Модель масканы қатаң геометриялық шекара емес, сұрауға негізделген бағыттау ретінде қабылдайды. Жергілікті өзгеріс пен сақтау талаптарын сипаттап, кейін көршілес аймақты күтпеген айырмашылықтарға тексеріңіз.
GPT Image 2 low, medium, high және auto сапаны қолдайды, әдепкісі auto. 2.5 топтамасының xhigh және max параметрлері осы нұсқаның сапа ауқымына кірмейді. Өлшем шаршы, көлденең, тік, автоматты немесе жарамды жеке ен мен биіктік бола алады. Өндіруші мысалдарына 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 және 2160 × 3840 пиксель кіреді. Сапа мен өлшемдерді бір басқару деп санамай, бағыт пен бөлшек деңгейін нақты макетке сай таңдаңыз.
Жеке өлшемдер он алты пиксельге еселік болуы тиіс; ең үлкен жағы 3840 пиксель, ұзын жақтың қысқа жаққа арақатынасы 3:1-ден аспайды, ауданы 655 360 пен 8 294 400 пиксель арасында. Бұл шарттар бір мезгілде орындалады. 2560 × 1440 өлшемінен жоғары ажыратымдылықтар эксперименттік деп белгіленген. Бір ережеге сай кадр басқа ережеден өтпеуі мүмкін, сондықтан қолдау көрсетілетін өлшем жұбын таңдап, тапсырмада қиылуға сезімтал элементтерді сипаттаңыз.
Нәтиже әдепкіде PNG, JPEG немесе WebP де қолжетімді. JPEG пен WebP үшін 0-ден 100-ге дейінгі сығу қолдау табады. Фон мөлдір емес не автоматты бола алады; нақты қазіргі анықтама GPT Image 2 мөлдірлігін алдын ала нұсқа мүмкіндігі ретінде сипаттайды. Мөлдірлік сұрағанда альфа-арна сақталуы үшін PNG немесе WebP пайдаланыңыз. Құжатталған ағындық үдеріс дайын кескінге дейін үшке дейін жартылай кескінге рұқсат береді; ілгерілеу көрінісін емес, соңғы материалды сақтаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.
Нақты нәтижеде мәтін анықтығын, заттардың орнын және бастапқы бөлшектердің сақталуын бағалаңыз. GPT Image дәл әріптерде, орналасуға сезімтал композицияларда және бөлек генерациялар арасындағы қайталанатын визуалдық сәйкестікте қиналуы мүмкін. Өңдеулер тізбегінде таңдалған нәтижені келесі түпнұсқа етіп, көрінетін мәселеге байланысты нақты өзгеріс беріңіз. GPT Image 2 моделінің пайдалы нәтижесі — анық генерация не өңдеу тапсырмасымен байланысқан кескін; жоғары дәлдікті кірістері, өлшемдері мен сапасы сол нақты тапсырма үшін таңдалады.
POST /v1/images/generationstextimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер gpt-image-2 | Әдепкі— |
Өріс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}
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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', '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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
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.\nӘр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.
Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түрі |
Өрісdata[].url | Түрі |
Өрісdata[].b64_json | Түрі |
Өрісusage | Түрі |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images
openai/gpt-image-2GPT Image 2 мәтін мен визуалдық үлгілерден кескіндер жасайды және өңдейді. Ол икемді кадр өлшемдерін қолдап, кескін кірістерін автоматты түрде жоғары дәлдікпен өңдейді; дайын материал үшін сапа, пішім және фон бөлек басқарылады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
GPT Image 2 — OpenAI компаниясының мәтін мен визуалдық кірістерден кескін жасау және өңдеу моделі. Ол жазбаша тапсырмадан жаңа кескін жасайды және өңдеу не үлгіге сүйенген жұмыс үшін бастапқы кескіндерді қолдана алады. Практикалық тапсырмаларға иллюстрациялар, тауар тұжырымдамалары, визуалдық композициялар және бар материалды өзгерту кіреді. Бұл — өзінің сапа ауқымы мен кіріс дәлдігі әрекеті бар, GPT Image 2.5 Sunburst және Flare модельдерінен бөлек нұсқа.
Генерация үшін нысанды, көріністі, композицияны, жарық пен қажетті стильді сипаттаңыз. Өңдеу үшін не өзгеруі және не сыртқы көрінісін сақтауы керектігін атаңыз. Тауар тапсырмасы ашық беттегі керамикалық шамды, орталық сұлба мен жазуға орынды сұрай алады; кейінгі өңдеу шам пішіні мен қарау бұрышын сақтап, фонды өзгерте алады. Құжатталған тікелей генерация және өңдеу үдерістері 32 000 таңбаға дейінгі сұрауды қабылдап, бірден онға дейін кескін қайтара алады.
Үлгіге сүйенген өңдеу он алтыға дейін кіріс кескінін қабылдайды. Нысан, фон мен визуалдық өңдеу шатаспау үшін әр үлгінің мақсатын көрсетіңіз. GPT Image 2 әр кескін кірісін автоматты түрде жоғары дәлдікпен өңдейді; input_fidelity берілмеуі тиіс, себебі бұл нұсқада ол реттелмейді. Бұл GPT Image 1 нұсқасының high не low таңдауынан және GPT Image 1 Mini нұсқасының тек low кіріс дәлдігі режимінен өзгеше. Жоғары дәлдікті кіріс өңдеуі бастапқы бөлшектерді қолдайды, бірақ әр бөлшектің өзгеріссіз қайталануына кепілдік бермейді.
Маска өңделетін аймақты анықтай алады. Нұсқаулықтың дайындық талаптары бойынша бастапқы кескін мен масканың пішімі мен өлшемдері бірдей, көлемі 50 МБ-тан кіші болуы тиіс; маскаға альфа-арна да қажет. Бірнеше кіріс кескін берілсе, маскалау біріншісіне қолданылады. Модель масканы қатаң геометриялық шекара емес, сұрауға негізделген бағыттау ретінде қабылдайды. Жергілікті өзгеріс пен сақтау талаптарын сипаттап, кейін көршілес аймақты күтпеген айырмашылықтарға тексеріңіз.
GPT Image 2 low, medium, high және auto сапаны қолдайды, әдепкісі auto. 2.5 топтамасының xhigh және max параметрлері осы нұсқаның сапа ауқымына кірмейді. Өлшем шаршы, көлденең, тік, автоматты немесе жарамды жеке ен мен биіктік бола алады. Өндіруші мысалдарына 1024 × 1024, 1536 × 1024, 1024 × 1536, 2048 × 2048, 2048 × 1152, 3840 × 2160 және 2160 × 3840 пиксель кіреді. Сапа мен өлшемдерді бір басқару деп санамай, бағыт пен бөлшек деңгейін нақты макетке сай таңдаңыз.
Жеке өлшемдер он алты пиксельге еселік болуы тиіс; ең үлкен жағы 3840 пиксель, ұзын жақтың қысқа жаққа арақатынасы 3:1-ден аспайды, ауданы 655 360 пен 8 294 400 пиксель арасында. Бұл шарттар бір мезгілде орындалады. 2560 × 1440 өлшемінен жоғары ажыратымдылықтар эксперименттік деп белгіленген. Бір ережеге сай кадр басқа ережеден өтпеуі мүмкін, сондықтан қолдау көрсетілетін өлшем жұбын таңдап, тапсырмада қиылуға сезімтал элементтерді сипаттаңыз.
Нәтиже әдепкіде PNG, JPEG немесе WebP де қолжетімді. JPEG пен WebP үшін 0-ден 100-ге дейінгі сығу қолдау табады. Фон мөлдір емес не автоматты бола алады; нақты қазіргі анықтама GPT Image 2 мөлдірлігін алдын ала нұсқа мүмкіндігі ретінде сипаттайды. Мөлдірлік сұрағанда альфа-арна сақталуы үшін PNG немесе WebP пайдаланыңыз. Құжатталған ағындық үдеріс дайын кескінге дейін үшке дейін жартылай кескінге рұқсат береді; ілгерілеу көрінісін емес, соңғы материалды сақтаңыз. Өндіруші интерфейсі пакеттік өңдеуді де қолдайды.
Нақты нәтижеде мәтін анықтығын, заттардың орнын және бастапқы бөлшектердің сақталуын бағалаңыз. GPT Image дәл әріптерде, орналасуға сезімтал композицияларда және бөлек генерациялар арасындағы қайталанатын визуалдық сәйкестікте қиналуы мүмкін. Өңдеулер тізбегінде таңдалған нәтижені келесі түпнұсқа етіп, көрінетін мәселеге байланысты нақты өзгеріс беріңіз. GPT Image 2 моделінің пайдалы нәтижесі — анық генерация не өңдеу тапсырмасымен байланысқан кескін; жоғары дәлдікті кірістері, өлшемдері мен сапасы сол нақты тапсырма үшін таңдалады.
POST /v1/images/generationstext, imageimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер openai/gpt-image-2 | Әдепкі— |
Өріс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 | Әдепкі— |
Өрісbackground | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер auto, 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}
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
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', '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Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
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.\nӘр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.
Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түрі |
Өрісdata[].url | Түрі |
Өрісdata[].b64_json | Түрі |
Өрісusage | Түрі |
Ailoot gpt-image-2
Ailoot Ultra gpt-image-2, openai/gpt-image-2
/v1/images