Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B — мәтін бойынша жасауға және төртке дейін референспен өңдеуге арналған Black Forest Labs ықшам, қадамдары дистилляцияланған кескін моделі. Төрт қадамдық құрылымы интерактивті көрнекі жұмысты қолдайды және дистилляцияланбаған Base 4B нұсқасынан бөлек.

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

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

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

FLUX.2 [klein] 4B — мәтін сипаттамасынан сурет жасауға және көрнекі референстермен сурет өңдеуге арналған Black Forest Labs ықшам моделі. Оның төрт миллиард параметрлі rectified-flow трансформері генерация мен өңдеуді бір архитектураға біріктіреді. Аталған 4B нұсқасының қадамдары дистилляцияланған, өндірушінің анықтамалық мысалы төрт шығару қадамын қолданады.

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

Шағын референс жиынымен өңдеу

Құжатталған 4B профилі төртке дейін кіріс сурет қабылдайды. Әрқайсысына анық рөл беріңіз: өнім келбеті, кейіпкер, орта не стиль. Бір сурет өңделетін көрініс болса, оны атап, өзгерісті де, сақталатын бөлшектерді де көрсетіңіз. Мысалы, бірінші суреттен кесе сұлбасы мен бетін сақтап, екіншісінен бөлмені алып, тек дастарқанды алмастырыңыз. Референс реті мен нақты өзгеріс нұсқауы жалпы жақсарту өтінішінен айқынырақ түзету мақсатын береді.

Өндіруші осы ықшам референс лимитін үлкен FLUX.2 нұсқаларынан ажыратады. Ол [klein]-де промпт кеңейту жоқ екенін де айтады. Қысқа атаудың автоматты кеңеюіне сенбей, маңызды сипаттаманы, соның ішінде референс заттар арасындағы байланысты өзіңіз беріңіз. Серия үшін әр жолы бір көрініс шешімін өзгертіп, бірдей нысан референсін және көрнекі талаптарды сақтаңыз.

Шығыс параметрлері және нұсқа шекаралары

Өндірушінің нақты 4B профилі JPEG, PNG және WebP нәтижесін, әдепкі JPEG-ті көрсетеді. Нақты ен мен биіктік мәндерінің әрқайсысы кемінде 64 пиксель деп құжатталған; модель карточкасының анықтамалық мысалы 1024×1024 суретті қолданады. Бұл мысал — әр тапсырма шаршы болуы керек немесе 1024 пиксель модель максимумы деген тұжырым емес, іріктеу конфигурациясы. Көрнекі тапсырмадан бұрын қажетті қиынды мен көрсету пішімін таңдап, ұсақ жазу мен белгілерді сол өлшемде салыстырыңыз.

Жарияланған төрт қадамдық мысал guidance_scale 1.0 қолданады. Осы дистилляцияланған нұсқаны бейімдеуге, LoRA оқытуына және зерттеуге арналған дистилляцияланбаған оқыту сигналы бар FLUX.2 [klein] Base 4B-ден бөлек ұстаңыз. Base 4B және 9B модельдері — дайындық пен іріктеу ерекшеліктері әртүрлі бөлек таңдаулар. Ықшам модельдің стандартты басқаруы [flex] реттелетін қадамдары мен guidance-ынан да өзгеше; [max]-та өзіндік іздеумен негіздеу бар.

Суретте тексерілетін бөлшектер

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

Тексерілген ресурс үшін бастапқы референстерді, соңғы мәтінді және таңдалған модель тұлғасын суретпен бірге сақтаңыз. Шығарылым құжаттамасы анықтамалық кодтағы мысал пиксельдік сутаңбаны өндірушінің орналастырылған шығыс ағынындағы C2PA шығу тегі метадерегінен ажыратады. Қайтарылған шығу тегі дерегін сақтау ресурс қайдан шыққанын түсіндіруге көмектеседі; бұл сұралған көрнекі өзгерістің сәттілігін тексеруден бөлек.

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

black-forest-labs/flux.2-klein-4b

Black Forest Labs /black-forest-labs/flux.2-klein-4b

Бастау

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

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

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

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

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

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-klein-4b', '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-klein-4b

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

/v1/images

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

black-forest-labs/flux.2-klein-4b

FAQ · Black Forest Labs: FLUX.2 Klein 4B

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

Black Forest Labs: FLUX.2 Klein 4B