{ "aboutHtml": "

Recraft V4 — Recraft V4 буынындағы стандартты растрлық модель. Өндіруші дизайн пайымын: теңгерімді композицияны, үйлесімді түс байланыстарын және визуалдық ниетті қолдайтын бөлшектерді атап көрсетеді. Ол стильденген иллюстрациялармен, фотографиялық көріністермен және графикалық дизайн тұжырымдамаларымен жұмыс істей алады. Тапсырма эстетикалық таңдау мен сұрау дәлдігін біріктіретін кескінді қажет еткенде, қысқа бағыттан көңіл күйді іздестіру үшін де, ойластырылған орналасуды егжей-тегжейлі көрсету үшін де оны пайдаланыңыз.

Нақты модель коды — recraftv4. Өндіруші анықтамасында шығынсыз WebP немесе PNG пішіміндегі 1K растрлық нәтиже берілген. Шаршы кескін 1024 × 1024 пиксель, 16:9 өлшемі 1344 × 768, 2:3 өлшемі 832 × 1280; басқа қолдау көрсетілетін арақатынастар өз өлшемдерін қолданады. V4 Pro — бөлек 2K растрлық нұсқа, ал V4 Vector және Pro Vector өңделетін SVG қайтарады. Осы әртүрлі нәтиже қасиеттерін біріктірмей, қажетті материалға сай нақты V4 нұсқасын таңдаңыз.

Өндіруші нұсқаулығы қысқа, түсіндіруге ерік беретін сұраулар мен құрылымды шығармашылық бағытты ажыратады. Қысқа тіркес пішінді, көңіл күй мен кадрлауды зерттеуге орын қалдырады. Құрылымды тапсырма нысанды, ортаны, қалыпты, материалды, қосымша элементтерді, жарық пен визуалдық иерархияны атай алады. Оқиғалы иллюстрация үшін шағын көпірден өтіп бара жатқан велосипедшіні, батыл ықшам пішіндерді, жылы бәсең түстерді және солдан оңға анық қозғалысты сипаттаңыз. Бұл мазмұн мен композиция шешімдері қатыссыз стиль сын есімдерінің ұзын тізімінен гөрі іске жарамды.

V4 ауқымына иллюстрация, көлемді бейнелер және фотореалистік кескіндер кіреді. Нұсқаулық иллюстрация үшін сурет салу логикасын, 3D тәрізді кескін үшін материалды, жарықты, камера мен тереңдікті сипаттауды ұсынады. Соңғысы өңделетін тор емес, растрлық кескін болып қалады. Постер немесе қаптама тұжырымдамасында қай сөздер негізгі екенін, олардың қайда орналасатынын және кескін мен типографияның қалай байланысатынын көрсетіңіз. Өндіруші оқылатын қысқа және орташа ұзындықтағы мәтінді атап өтеді; қолданар алдында алынған кескіндегі нақты сөздер мен орналасуды тексеріңіз.

Генерация 10 000 таңбаға дейінгі сұрауды, кездейсоқ seed мәнін, бірден алтыға дейін нәтижені, қалаулы түстер мен қажетті фон түсін қолдайды. Қосымша үйлесімді жеке стильдер мен үлгі кескіндер икемді не дәл сәйкестендіру арқылы визуалдық өңдеуді бағыттай алады. Таза үлгіні немесе бір визуалдық әлемге жататын жиынтықты таңдап, жаңа нысан мен көріністі сұрауда сипаттаңыз. Үлгі мен нәтиже түстерінің сәйкестігіне кепілдік жоқ, сондықтан қажетті палитраны нақты беріп, нәтижемен салыстырыңыз. Үлгі стилімен генерациялау үшін PNG, JPG немесе WebP пішіміндегі бірден онға дейін кескін пайдаланыңыз: жалпы көлемі 64 МБ-тан аспасын, әрқайсысы 20 МБ-тан кіші болсын. Әр үлгінің қысқа жағы кемінде 256 пиксель, ұзын жағы 4 096 пиксельден аспайтын, ажыратымдылығы 16 мегапиксельден аспайтын болуы керек. Осы үлгілерді немесе үйлесімді сақталған стильді пайдаланыңыз, екеуін бірге бермеңіз.

Құжатталған image-to-image операциясы бар кескін мен сұрауды біріктіреді; 0-ден 1-ге дейінгі strength мәні жаңа нәтиженің түпнұсқадан қаншалықты ауытқитынын анықтайды. Ол бұл операцияда V4 стиль басқару параметрлерін қабылдамайды. Қазіргі генерация анықтамасы дайын стиль атаулары, negative_prompt, text_layout, artistic_level және no_text параметрлерін де қамтымайды. Қажетті нәтижені оң сипаттамамен дайындап, материалды мақсатты композицияда бағалаңыз. Стандартты V4 нақты нұсқасы, пішімі және нәтиже өлшемі бар маманданған растрлық дизайн түсіндірмесін ұсынады. Image-to-image үшін 20 МБ-тан кіші, 16 мегапиксельден аспайтын, екі жағы да 256–4 096 пиксель аралығындағы PNG, JPG, WebP немесе SVG беріңіз.

", "aboutText": "Recraft V4 — Recraft V4 буынындағы стандартты растрлық модель. Өндіруші дизайн пайымын: теңгерімді композицияны, үйлесімді түс байланыстарын және визуалдық ниетті қолдайтын бөлшектерді атап көрсетеді. Ол стильденген иллюстрациялармен, фотографиялық көріністермен және графикалық дизайн тұжырымдамаларымен жұмыс істей алады. Тапсырма эстетикалық таңдау мен сұрау дәлдігін біріктіретін кескінді қажет еткенде, қысқа бағыттан көңіл күйді іздестіру үшін де, ойластырылған орналасуды егжей-тегжейлі көрсету үшін де оны пайдаланыңыз.\n\nНақты модель коды — recraftv4. Өндіруші анықтамасында шығынсыз WebP немесе PNG пішіміндегі 1K растрлық нәтиже берілген. Шаршы кескін 1024 × 1024 пиксель, 16:9 өлшемі 1344 × 768, 2:3 өлшемі 832 × 1280; басқа қолдау көрсетілетін арақатынастар өз өлшемдерін қолданады. V4 Pro — бөлек 2K растрлық нұсқа, ал V4 Vector және Pro Vector өңделетін SVG қайтарады. Осы әртүрлі нәтиже қасиеттерін біріктірмей, қажетті материалға сай нақты V4 нұсқасын таңдаңыз.\n\nӨндіруші нұсқаулығы қысқа, түсіндіруге ерік беретін сұраулар мен құрылымды шығармашылық бағытты ажыратады. Қысқа тіркес пішінді, көңіл күй мен кадрлауды зерттеуге орын қалдырады. Құрылымды тапсырма нысанды, ортаны, қалыпты, материалды, қосымша элементтерді, жарық пен визуалдық иерархияны атай алады. Оқиғалы иллюстрация үшін шағын көпірден өтіп бара жатқан велосипедшіні, батыл ықшам пішіндерді, жылы бәсең түстерді және солдан оңға анық қозғалысты сипаттаңыз. Бұл мазмұн мен композиция шешімдері қатыссыз стиль сын есімдерінің ұзын тізімінен гөрі іске жарамды.\n\nV4 ауқымына иллюстрация, көлемді бейнелер және фотореалистік кескіндер кіреді. Нұсқаулық иллюстрация үшін сурет салу логикасын, 3D тәрізді кескін үшін материалды, жарықты, камера мен тереңдікті сипаттауды ұсынады. Соңғысы өңделетін тор емес, растрлық кескін болып қалады. Постер немесе қаптама тұжырымдамасында қай сөздер негізгі екенін, олардың қайда орналасатынын және кескін мен типографияның қалай байланысатынын көрсетіңіз. Өндіруші оқылатын қысқа және орташа ұзындықтағы мәтінді атап өтеді; қолданар алдында алынған кескіндегі нақты сөздер мен орналасуды тексеріңіз.\n\nГенерация 10 000 таңбаға дейінгі сұрауды, кездейсоқ seed мәнін, бірден алтыға дейін нәтижені, қалаулы түстер мен қажетті фон түсін қолдайды. Қосымша үйлесімді жеке стильдер мен үлгі кескіндер икемді не дәл сәйкестендіру арқылы визуалдық өңдеуді бағыттай алады. Таза үлгіні немесе бір визуалдық әлемге жататын жиынтықты таңдап, жаңа нысан мен көріністі сұрауда сипаттаңыз. Үлгі мен нәтиже түстерінің сәйкестігіне кепілдік жоқ, сондықтан қажетті палитраны нақты беріп, нәтижемен салыстырыңыз. Үлгі стилімен генерациялау үшін PNG, JPG немесе WebP пішіміндегі бірден онға дейін кескін пайдаланыңыз: жалпы көлемі 64 МБ-тан аспасын, әрқайсысы 20 МБ-тан кіші болсын. Әр үлгінің қысқа жағы кемінде 256 пиксель, ұзын жағы 4 096 пиксельден аспайтын, ажыратымдылығы 16 мегапиксельден аспайтын болуы керек. Осы үлгілерді немесе үйлесімді сақталған стильді пайдаланыңыз, екеуін бірге бермеңіз.\n\nҚұжатталған image-to-image операциясы бар кескін мен сұрауды біріктіреді; 0-ден 1-ге дейінгі strength мәні жаңа нәтиженің түпнұсқадан қаншалықты ауытқитынын анықтайды. Ол бұл операцияда V4 стиль басқару параметрлерін қабылдамайды. Қазіргі генерация анықтамасы дайын стиль атаулары, negative_prompt, text_layout, artistic_level және no_text параметрлерін де қамтымайды. Қажетті нәтижені оң сипаттамамен дайындап, материалды мақсатты композицияда бағалаңыз. Стандартты V4 нақты нұсқасы, пішімі және нәтиже өлшемі бар маманданған растрлық дизайн түсіндірмесін ұсынады. Image-to-image үшін 20 МБ-тан кіші, 16 мегапиксельден аспайтын, екі жағы да 256–4 096 пиксель аралығындағы PNG, JPG, WebP немесе SVG беріңіз.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c5bde682c5ff443a90cdaa418bcdeb9cffa91afddbc3cd4246cbc95d4a05a6b4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "

•

Recraft: Recraft V4

Recraft /recraft/recraft-v4

Бастау

Recraft V4 композицияға, түс байланыстарына және егжей-тегжейлі шығармашылық бағытқа назар аударып, 1K растрлық кескіндер жасайды. Ол иллюстрацияны, фотореалистік көріністер мен графикалық дизайн тұжырымдамаларын қамтиды; қосымша стиль кірістері және бөлек image-to-image үдерісі бар.

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

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

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

Recraft V4 — Recraft V4 буынындағы стандартты растрлық модель. Өндіруші дизайн пайымын: теңгерімді композицияны, үйлесімді түс байланыстарын және визуалдық ниетті қолдайтын бөлшектерді атап көрсетеді. Ол стильденген иллюстрациялармен, фотографиялық көріністермен және графикалық дизайн тұжырымдамаларымен жұмыс істей алады. Тапсырма эстетикалық таңдау мен сұрау дәлдігін біріктіретін кескінді қажет еткенде, қысқа бағыттан көңіл күйді іздестіру үшін де, ойластырылған орналасуды егжей-тегжейлі көрсету үшін де оны пайдаланыңыз.

Нақты модель коды — recraftv4. Өндіруші анықтамасында шығынсыз WebP немесе PNG пішіміндегі 1K растрлық нәтиже берілген. Шаршы кескін 1024 × 1024 пиксель, 16:9 өлшемі 1344 × 768, 2:3 өлшемі 832 × 1280; басқа қолдау көрсетілетін арақатынастар өз өлшемдерін қолданады. V4 Pro — бөлек 2K растрлық нұсқа, ал V4 Vector және Pro Vector өңделетін SVG қайтарады. Осы әртүрлі нәтиже қасиеттерін біріктірмей, қажетті материалға сай нақты V4 нұсқасын таңдаңыз.

Өндіруші нұсқаулығы қысқа, түсіндіруге ерік беретін сұраулар мен құрылымды шығармашылық бағытты ажыратады. Қысқа тіркес пішінді, көңіл күй мен кадрлауды зерттеуге орын қалдырады. Құрылымды тапсырма нысанды, ортаны, қалыпты, материалды, қосымша элементтерді, жарық пен визуалдық иерархияны атай алады. Оқиғалы иллюстрация үшін шағын көпірден өтіп бара жатқан велосипедшіні, батыл ықшам пішіндерді, жылы бәсең түстерді және солдан оңға анық қозғалысты сипаттаңыз. Бұл мазмұн мен композиция шешімдері қатыссыз стиль сын есімдерінің ұзын тізімінен гөрі іске жарамды.

V4 ауқымына иллюстрация, көлемді бейнелер және фотореалистік кескіндер кіреді. Нұсқаулық иллюстрация үшін сурет салу логикасын, 3D тәрізді кескін үшін материалды, жарықты, камера мен тереңдікті сипаттауды ұсынады. Соңғысы өңделетін тор емес, растрлық кескін болып қалады. Постер немесе қаптама тұжырымдамасында қай сөздер негізгі екенін, олардың қайда орналасатынын және кескін мен типографияның қалай байланысатынын көрсетіңіз. Өндіруші оқылатын қысқа және орташа ұзындықтағы мәтінді атап өтеді; қолданар алдында алынған кескіндегі нақты сөздер мен орналасуды тексеріңіз.

Генерация 10 000 таңбаға дейінгі сұрауды, кездейсоқ seed мәнін, бірден алтыға дейін нәтижені, қалаулы түстер мен қажетті фон түсін қолдайды. Қосымша үйлесімді жеке стильдер мен үлгі кескіндер икемді не дәл сәйкестендіру арқылы визуалдық өңдеуді бағыттай алады. Таза үлгіні немесе бір визуалдық әлемге жататын жиынтықты таңдап, жаңа нысан мен көріністі сұрауда сипаттаңыз. Үлгі мен нәтиже түстерінің сәйкестігіне кепілдік жоқ, сондықтан қажетті палитраны нақты беріп, нәтижемен салыстырыңыз. Үлгі стилімен генерациялау үшін PNG, JPG немесе WebP пішіміндегі бірден онға дейін кескін пайдаланыңыз: жалпы көлемі 64 МБ-тан аспасын, әрқайсысы 20 МБ-тан кіші болсын. Әр үлгінің қысқа жағы кемінде 256 пиксель, ұзын жағы 4 096 пиксельден аспайтын, ажыратымдылығы 16 мегапиксельден аспайтын болуы керек. Осы үлгілерді немесе үйлесімді сақталған стильді пайдаланыңыз, екеуін бірге бермеңіз.

Құжатталған image-to-image операциясы бар кескін мен сұрауды біріктіреді; 0-ден 1-ге дейінгі strength мәні жаңа нәтиженің түпнұсқадан қаншалықты ауытқитынын анықтайды. Ол бұл операцияда V4 стиль басқару параметрлерін қабылдамайды. Қазіргі генерация анықтамасы дайын стиль атаулары, negative_prompt, text_layout, artistic_level және no_text параметрлерін де қамтымайды. Қажетті нәтижені оң сипаттамамен дайындап, материалды мақсатты композицияда бағалаңыз. Стандартты V4 нақты нұсқасы, пішімі және нәтиже өлшемі бар маманданған растрлық дизайн түсіндірмесін ұсынады. Image-to-image үшін 20 МБ-тан кіші, 16 мегапиксельден аспайтын, екі жағы да 256–4 096 пиксель аралығындағы PNG, JPG, WebP немесе SVG беріңіз.

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер recraft/recraft-v4	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 6	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 4:3, 3:4, 16:9, 9:16, auto	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 1	Әдепкі—

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

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

reference_guided_image · Міндетті: prompt, actual image reference

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

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image
Параметр`optional_controls`	Параметр талаптарыn, aspect_ratio, input_references
Параметр`n`	Параметр талаптары{"minimum":1,"maximum":6}
Параметр`reference_images`	Параметр талаптары{"minimum":0,"maximum":1,"source":"клиент ұсынған нақты материал"}
Параметр`provider_specific_options`	Параметр талаптарыТек нақты эндпоинт үшін сақталған рұқсат тізіміндегі style/controls/text_layout; жорамал құрылымдар қолданылмайды.

Әдістің балама атаулары: /v1/images

Өмірлік цикл: 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}

Тек промпт қолданылатын мысал ресми ImageGenerationRequest құрылымын сақтайды.

Қайтарылған әрбір суретті және толық жауапты сақтаңыз; шығыс саны сұралған n бойынша емес, нақты нәтиже бойынша анықталады.

Тарифтер

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

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

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

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

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

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

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

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

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

Анықтамалық тариф мәліметтері

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.

Суреттердің баға конфигурациялары

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

Баптау	Төлемді есептеу шарттары	Төлем
БаптауШығыс суреті	Төлемді есептеу шарттарыБаға нұсқасы мәлімделмеген.	Төлем Шығыс · Шығыс кескін $0.08 сурет үшін Баламалы жазбалар бір төлемді сипаттайды; олар екінші алым қоспайды.

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

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': 'recraft/recraft-v4', '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

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\nrequest={'model': 'recraft/recraft-v4', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting"};\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 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}

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

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

Әрбір дерек элементін және пайдалану деректерін толық сақтаңыз; нақты қайтарылған барлық суретті өз иелігіңізге алып, сақтаңыз. URL мекенжайларын немесе ID мәндерін ойдан қоспаңыз.

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

Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы 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 Ultra recraft/recraft-v4

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

/v1/images

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

recraft/recraft-v4

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4", "ordinal": 0, "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 every data item and complete usage; own and save all actual returned images. No invented URLs or IDs.", "errors": [ { "code": null, "condition": "Міндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате", "http_status": 400, "recovery": "Жаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.", "type": "invalid_request_error" }, { "code": null, "condition": "Қайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген", "http_status": null, "recovery": "Бастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.", "type": "server_error" } ], "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": "Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "required": [ "prompt" ] }, { "content_type": "application/json", "maximum_references": 1, "mode": "reference_guided_image", "required": [ "prompt", "actual image reference" ] } ], "outputs": { "all_results": "Әрбір дерек элементін және пайдалану деректерін толық сақтаңыз; нақты қайтарылған барлық суретті өз иелігіңізге алып, сақтаңыз. URL мекенжайларын немесе ID мәндерін ойдан қоспаңыз.", "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", "enum": [ "recraft/recraft-v4" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "saved_exact_supplier_endpoint", "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "availability": "saved_exact_supplier_endpoint", "items": { "image_url": { "url": "actual HTTP(S) image URL or base64 data URI" }, "type": "image_url" }, "maximum_items": 1, "minimum_items": 0, "name": "input_references", "required": false, "type": "array" } ], "request_schema": { "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "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": 1, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "prompt": { "minLength": 1, "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "body": { "model": "recraft/recraft-v4", "prompt": "a red panda astronaut floating in space, studio lighting" }, "content_type": "application/json", "parameter_source": "parameters + request_schema; no fabricated reference URL" } }, "hints": [ "Тек промпт қолданылатын мысал ресми ImageGenerationRequest құрылымын сақтайды.", "Қайтарылған әрбір суретті және толық жауапты сақтаңыз; шығыс саны сұралған n бойынша емес, нақты нәтиже бойынша анықталады." ], "input": { "content_type": "application/json", "material_types": [ "text", "image" ], "n": { "maximum": 6, "minimum": 1 }, "optional_controls": [ "n", "aspect_ratio", "input_references" ], "provider_specific_options": "Тек нақты эндпоинт үшін сақталған рұқсат тізіміндегі style/controls/text_layout; жорамал құрылымдар қолданылмайды.", "reference_images": { "maximum": 1, "minimum": 0, "source": "клиент ұсынған нақты материал" }, "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" }, "method_aliases": [ "/v1/images" ], "operation_modes": [ "text_to_image", "reference_guided_image" ], "output": { "all_results": true, "family": "image", "format": "actual validated raster MIME", "result": "every actual owned URL or b64_json" } }, "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" } ] }, { "dimensions": { "quantity_basis": "actual returned output images", "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.08", "amount_unit": "usd_per_output_image", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.08", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.08", "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.08", "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': 'recraft/recraft-v4', '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\"