Black Forest Labs: FLUX.2 Max

FLUX.2 [max] — сапасына жоғары талап қойылатын дайын материалдар мен бірізді өңдеулерге арналған Black Forest Labs кескін моделі. Құжатталған профиль көрнекі референстерді, егжей-тегжейлі көрініс басқаруын және өзекті нысандарды веб арқылы негіздеуді 4 мегапиксельге дейінгі нәтижемен біріктіреді.

Ailoot Ultra · Суреттер POST /v1/images/generations black-forest-labs/flux.2-max

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

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

FLUX.2 [max] — Black Forest Labs FLUX.2 кескін жасау және өңдеу тобының ең жоғары сапалы мүшесі. Өндіруші оны сапасына жоғары талап қойылатын дайын материалдарға, күрделі тапсырманы дәл орындауға және өңдеулер арасындағы бірізділікке арнайды. Ол жазбаша сипаттамадан сурет жасайды немесе берілген суреттерді көрнекі референс ретінде қолданады. Топтағы айрықша мүмкіндігі — негіздеуші іздеу: сұрау тек промпттағы көрініске емес, өзекті ақпаратқа да сүйене алады.

Нақты әлем ақпараты және көрнекі тапсырма

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

Жарияланған FLUX.2 салыстыруында бұл іздеу мүмкіндігі [max]-қа тиесілі. Басқа аталған мүшелердің өз рөлі бар: [pro] өндіріс үшін, [flex] реттелетін іріктеу мен типографика үшін, [klein] ықшам интерактивті генерация үшін. Кейінгі түзету негізделетін профильді басқа нұсқамен үнсіз алмастырмас үшін таңдалған модель атауын нәтижемен бірге сақтаңыз.

Жоғары талап қойылатын өңдеулерге арналған референстер

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

Топ мысалдары фон өзгерісін, зат ауыстыруды, жиһаз композицияларын, мәтін өңдеуін және тұрақты кейіпкерлерді қамтиды. Дайын материалға арналған авторлық тапсырма берілген сағатты қара бүктелген матаға қойып, циферблат пен бау дизайнын сақтап, тек жарықты жұмсақ жанамаға өзгерте алады. Әр белгіні қай көз беретінін атап, нәтижедегі циферблатты, белгілерді, материалды және шағылыстарды бірге тексеріңіз. Сақтау нұсқауы мақсатты белгілейді; қайтарылған сурет — сонымен салыстыратын дәлел.

Мәтін, түстер және промпт түсіндіру

FLUX.2 нұсқаулығы маңызды элементтерді алдыға қоятын нысан–әрекет–стиль–контекст құрылымын ұсынады. Жылдам тұжырымдамаға 10–30 сөз, кәдімгі жобаға 30–80 сөз, күрделі көрініске ұзағырақ сипаттама ұсынылады. Бұл — қатаң контекст шектері емес, жазу ұсыныстары. Табиғи тіл және JSON құрылымды көрініс сипаттамасы нысандарды, орналасуды, жарықты және стильді ұйымдастырудың құжатталған тәсілдері. Құрылымды промпт — құрылымды мәтіндік жауап уәдесі емес, сурет тапсырмасы.

Көрінетін жазуға нақты мәтінді тырнақшаға алып, орнын және типографиялық иерархиясын сипаттаңыз. Әр он алтылық түсті нақты затпен не мәтін элементімен байланыстырыңыз; нысаны аталмаған түс коды екіұшты. Өндіруші нұсқаулығы теріс промпт механизмінің орнына оң сипаттамаларды қолданады. Тақырыпқа бос орын қажет өнім көрінісінде сол бос аумақты және орнын тікелей сипаттаңыз.

Нақты [max] сұрау сипаттамасында промпт кеңейту әдепкіде қолданылады. disable_pup басқаруы мұқият жазылған тапсырманы берілген күйінде пайдалану керек болса, кеңейтуді өшіреді. Бұл соңғы суретте әр сөз өзгермей көрінеді деген тұжырымнан бөлек. Күтпеген көрнекі шешім нұсқаудан ба әлде оны түсіндіруден бе екенін бағалағанда нақты тапсырма мен таңдалған параметрді нәтижемен бірге сақтаңыз.

Нәтиже және пайдалануға дайын материал

Топ нұсқаулығы 4 мегапиксельге дейін суреттерді, нақты өлшемдердің кемінде 64×64 және 16-ға еселі болуын құжаттайды. Кәдімгі қолдануға 2 мегапиксельге дейін ұсынылады. Нақты [max] профилі JPEG, PNG және WebP, әдепкі JPEG және қосымша кездейсоқ seed береді. Композицияны орналастырмас бұрын шығыс пішімін қолданылатын орынға сай таңдаңыз. Модель генерациясы дайын ресурстың өлшемін өзгертуден бөлек.

Соңғы нұсқаны таңдағанда суретті, референстерді, промптты, өлшемдерді және модель тұлғасын сақтаңыз. Өндірушінің FLUX.2 нұсқаулығы қол қойылған нәтиже сілтемесінің уақытша екенін, алу терезесі он минут екенін ескертеді. Ұсақ мәтінді, зат тұлғасын, макетті, жарықты және іздеуден алынған фактілерді жоспарланған көрсету өлшемінде тексеріңіз. Пайдалы артефакт — маңызды бөлшектері тапсырмамен мүлде салыстырылмаған көрініс емес, нақты түзетуді жалғастыруға жеткілікті контексті бар таңдалған көрнекі нәтиже.

Ailoot Ultra · Суреттер POST /v1/images/generations black-forest-labs/flux.2-max

black-forest-labs/flux.2-max

Black Forest Labs /black-forest-labs/flux.2-max

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер black-forest-labs/flux.2-max	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Әдепкі—
Өріс`output_format`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер png, jpeg	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 8	Әдепкі—
Өріс`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.14 шығыс суретінің мегапикселі үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.14 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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

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

Ailoot Ultra · Суреттер

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-max', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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

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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

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

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

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

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

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

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

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

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

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

Ailoot Ultra black-forest-labs/flux.2-max

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

/v1/images

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

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Қандай шектеулер қолданылады?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max