Black Forest Labs: FLUX.2 Pro

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

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

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

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

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

Өндірістік тапсырманы дайындаңыз

Нысаннан, оның әрекеті не орналасуынан, стильден және орта не жарықтан бастаңыз. Өндірушінің промпт нұсқаулығы алғашқы сөздерге көбірек мән беріп, негізгі нысан мен әрекетті әшекей бөлшектерден бұрын қоюды ұсынады. Жылдам тұжырымдамаларға 10–30 сөз, кәдімгі жобаларға 30–80 сөз, күрделі көріністерге ұзағырақ сипаттама ұсынады. Бұл аралықтар — промпт жазу бағдары, мәтін контекстінің шегі емес.

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

Топ нұсқаулығы табиғи тілдегі және JSON құрылымындағы промпттарды құжаттайды. Құрылымды көрініс тапсырмасы нысанды, фонды, жарықты және композицияны бөлек өрістерде ұстап, бір талапты анық өзгертуге мүмкіндік береді. Ол он алтылық түс сипаттамасын да қолдайды: кодты боялатын нақты затпен не мәтінмен байланыстырыңыз. Қажетті келбетті оң түрде сипаттаңыз, өйткені құжатталған FLUX.2 промпт ағынында теріс промпт жоқ.

Референстермен және ортақ пиксель лимитімен өңдеңіз

Нақты [pro] сұрау профилі сегіз референс сурет орнын береді; өндірушінің интерактивті интерфейсі бөлек онды қолдайды. Әр суретке нысан келбеті, киім, өнім дизайны, бөлме не стиль сияқты рөл тағайындаңыз. Бар көріністе өзгеретін элементті және сақталатын композицияны, айналаны әрі көрнекі бөлшектерді атаңыз. Жарияланған мысалдарға жиһаз композициялары, фон не ауа райы өзгерістері, зат алмастыру және мәтін түзетулері кіреді.

Референс сыйымдылығы шығыс өлшеміне де байланысты. Өндірушінің [pro] нұсқаулығы кіріс пен шығысқа ортақ 9 мегапиксель лимитін белгілейді. Мысалдарында 1 мегапиксель нәтижеге сегіз, 2 мегапиксель нәтижеге жеті референс рұқсат етіледі; сұралған нәтиже үлкейген сайын референс сыйымдылығы азаяды. Ең көп орын саны әр шығыс өлшеміне қолжетімді деп қарамай, бастапқы жиын мен нәтижені бірге жоспарлаңыз. Қажетті ақпаратты беретін референстерді пайдаланып, әрқайсысының үлесін атаңыз.

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

Промпт кеңейту және тұрақты не Preview профильдері

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

Құжаттама жай [pro] endpoint-ін тұрақты snapshot ретінде, [pro] Preview-ді кейінгі модель жақсартулары енгізілетін нұсқа ретінде ажыратады. Сұрау мен жауап құрылымы бірдей, ал астындағы салмақтар өзгеше. Таңдалған нақты профильді суретпен және референстермен бірге сақтаңыз. Түзету бірдей құжатталған модельге тәуелді болса, бөлек Preview белгісі жай [pro] таңдауын үнсіз алмастырмауы керек.

Өлшемдер, пішімдер және таңдалған ресурс

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

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

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

black-forest-labs/flux.2-pro

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

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер black-forest-labs/flux.2-pro	Әдепкі—
Өріс`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.06 шығыс суретінің мегапикселі үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.06 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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-pro', '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-pro

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

/v1/images

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

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro