Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] реттелетін іріктеу қадамдары мен guidance арқылы кескін типографикасына және ұсақ көрнекі бөлшектерге маманданады. Нұсқауды орындау мен шынайылық теңгерімін сақтап, постерлер, өнім макеттері немесе дәл түзетулер жасау үшін мәтін мен сурет референстерін қолданыңыз.

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

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

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

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

Жазу және ұсақ бөлшектер

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

Егжей-тегжейлі өнім көрінісінде нәтижені пайдалы ететін бөліктерді атаңыз: циферблат, басқару жапсырмасы, тігіс, материал жиегі немесе қаптама белгісі. Оқылатын референс беріп, қай белгіні анықтайтынын түсіндіріңіз. Жалпы ұқсас көрініс маңызды таңбаны не компонентті бәрібір өзгерте алады, сондықтан жасалған бөлшекті мақсатты көрсету өлшемінде салыстырыңыз. Модельдің мамандануы — дәл талап беруге себеп, мәтін не визуалдық тексеру қажет болмайтынына кепіл емес.

Қадамдар мен guidance әртүрлі мақсатқа қызмет етеді

Өндірушінің нақты профилі бір–елу шығару қадамын қабылдайды, әдепкісі — елу. Сипаттама көбірек қадамды жоғары бөлшек және шынайылықпен байланыстырады. Guidance аралығы — 1.5–10, әдепкісі — 5. Жоғары guidance промптты орындауды күшейтеді, бірақ шынайылықты азайтуы мүмкін. Сондықтан нақты дизайн нұсқауы бар сурет пен табиғи фото келбет іздейтін сурет осы профиль ішінде әртүрлі таңдауды талап етуі мүмкін.

Параметр өзгерісін салыстырғанда мәтінді, референстерді және шығыс пішімін тұрақты ұстаңыз. Өзгеріске себеп болған белгіні қараңыз: әріп пішіні, зат орны немесе материал текстурасы. Үлкен санды автоматты түрде жақсы деп қарамай, параметрді нақты көрнекі себеппен өзгертіңіз. Бұлар — өндірушінің іріктеу басқаруы; төрт қадамдық дистилляцияланған [klein] профилі мен [pro] не [max] стандартты басқаруы — басқа модель таңдаулары.

[flex] сипаттамасында промпт кеңейту әдепкіде қосулы және өз prompt_upsampling басқаруымен өшіріледі. Бұл қажет кезде егжей-тегжейлі тапсырманы берілген мәтін күйінде қалдырады. Өндірушінің ортақ нұсқаулығы негізгі нысан мен маңызды әрекетті қосалқы әшекейден бұрын орналастыруды ұсынып, табиғи тіл тапсырмаларымен бірге JSON құрылымды промпттарды сипаттайды. Қажетті байланыстарды ең жеңіл белгілеуге мүмкіндік беретін құрылымды пайдаланыңыз.

Референске сүйенген түзетулер

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

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

Өлшем, түс және қайтарылған сурет

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

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

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

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

black-forest-labs/flux.2-flex

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

Бастау

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

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

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

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

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

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

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

/v1/images

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

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex