Flux.2 API-ді қалай пайдалану керек? Білуіңізге қажеттінің бәрі

FLUX.2 — Black Forest Labs компаниясының кескін жасау және кескінді өңдеу модельдерінің екінші буындағы тобы (2025 жылғы 25 қарашада шығарылған). Ол өндірістік деңгейдегі фотореализмді, 4MP-ке дейінгі көпсілтемелі өңдеуді, құрылымдалған/JSON промптингті және басқарылатын endpoint нұсқаларын (Pro, Flex) әрі ашық салмақты нұсқаларды (Dev) ұсынады.

Жақсы жаңалық — CometAPI Flux.2 API-ін біріктірді. Бұл нұсқаулықта FLUX.2 не екені, API-ді қалай шақыру керектігі және кеңейтілген жұмыс процестері (мәтін→кескін, икемді басқару, көпсілтемелі өңдеу) код мысалдары мен үздік тәжірибелермен түсіндіріледі.

FLUX.2 дегеніміз не және ол неге маңызды?

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

FLUX.2 жеткізуге арналған негізгі нәтижелер

Жарнамаға, өнімдік кескіндерге және UI мокаптарына жарамды фотореалистік нәтижелер.
Кірістегі бірнеше кескіннен элементтерді бір өңдеуде біріктіру, ауыстыру немесе композициялау мүмкіндігі бар жергілікті көпсілтемелі өңдеу.
Әртүрлі қолдану жағдайларына арналған нұсқалар: ашық қолжетімді әзірлеуші модельдері, өндіріске оңтайландырылған Pro endpoint-і және төмен деңгейлі басқаруға арналған Flex endpoint-і.

Жалпы алғанда, FLUX.2 семантикалық негіздеуге арналған vision–language моделімен және нұсқалар арасында ортақ латентті кеңістік беретін жаңадан үйретілген VAE-пен біріктірілген латентті генеративті негізді (flow/transformer архитектурасы) қолданады. Мұндай дизайн модельге генерацияны да, реконструкцияны да (өңдеуді) жоғарырақ дәлдікпен орындауға мүмкіндік береді, сонымен бірге ұсынуды оқыту мен fine-tuning үшін үйренуге қолайлы күйде сақтайды. Ашық VAE әсіресе маңызды, өйткені ол hosted және self-hosted жұмыс процестері үшін латентті кеңістікті стандарттайды.

Бұл неге маңызды: тіл мен латентті flow matching байланысы промптты жақсырақ ұстануды береді (көп бөлімді, композициялық нұсқаулар болжамды орындалады), типографияны жақсартады және бірнеше сілтемесі бар генерация мен өңдеуді қолдайтын бірыңғай архитектура ұсынады. Креаторлар үшін бұл күрделі нұсқаулар мен аралас кірістерге (мәтін + кескіндер) сенімдірек нәтижелер береді.

FLUX.2 API-іне қалай қол жеткіземін?

Ортаны дайындау

CometAPI-ге тіркеліп, жүйеге кіріңіз және профиль панелінен API кілтіңізді алыңыз. Ең дұрысы, сізде әзірлеуші ретінде API туралы белгілі бір білім болғаны жөн (бұл бағытта көмек көрсетеміз, сондықтан алаңдамаңыз).

Сондай-ақ, өзіңізге қажет сұрау әдісін және сәйкес Flux.2 моделін таңдауыңыз керек.

Қандай endpoint-тер мен аутентификация қажет?

Replicate Predictions API стандартты Replicate форматы арқылы Black Forest Labs ұсынатын әртүрлі FLUX модельдерімен жоғары сапалы кескіндер жасауға қол жеткізуге мүмкіндік береді. Бұл API FLUX модельдерінің кең ауқымын қолдайды, олардың әрқайсысы жылдам прототиптеуден бастап кәсіби деңгейдегі кескін генерациясына дейін әртүрлі қолдану жағдайларына оңтайландырылған. Пайдаланушылар URL жолындағы модель атауын ғана өзгерту арқылы әртүрлі модельдер арасында оңай ауыса алады (https://api.cometapi.com/replicate/v1/models/{models}/predictions), бұл оны әртүрлі шығармашылық және коммерциялық қолданбалар үшін икемді етеді.

CometAPI https://api.cometapi.com/flux/v1/{model} астында басқарылатын endpoint-терді ұсынады және кескін жасау мен өңдеуге арналған endpoint атаулары ретінде flux-2-pro, flux-2-flex және flux-2-flex пайдаланады. Сұраулар x-key header-інде API кілтін талап етеді.

Модельдер тобы және есептеу ымыралары

FLUX.2 (ашық салмақтар) — Жергілікті бақылау, зерттеу эксперименттері немесе инференсті өз инфрақұрылымыңызда іске қосу қажет болса пайдаланыңыз. Dev — ашық салмақты (32B) және зерттеу мен fine-tuning үшін өте қолайлы. Ол көбірек конфигурациялауға мүмкіндік береді, бірақ инфрақұрылым мен оңтайландыру сіздің жауапкершілігіңізде.
FLUX.2 pro — Өндіріс үшін жылдамдық, сапа және құн арасындағы ең жақсы тепе-теңдік. Pro болжамды кідіріске, промптты бірізді ұстануға, жоғары өткізу қабілетіне бапталған және API арқылы 8-ге дейін сілтеме кескінін қолдайды (API арқылы жалпы 9MP). Оны жоғары көлемді өңдеу және сенімділік пен болжамды баға қажет болғанда пайдаланыңыз.
FLUX.2 (басқарылатын + бақылау мүмкіндігі) — Төмен деңгейлі генерация басқаруларын (steps, guidance сияқты) ашады және көбірек сілтемені (10-ға дейін) әрі сәл жоғарырақ сапа/детальды қолдайды, бірақ кідіріс пен құн жоғары болады. Typography дәлдігі, нақты түстер немесе өте егжей-тегжейлі композициялық түзетулер сияқты соңғы креативті бақылау қажет болса Flex пайдаланыңыз.

Прототиптеуді Dev немесе арзан Pro жоспарында бастап, кейін ауқымдау үшін Pro-ға немесе жоғары бақылаумен финалдық рендер үшін Flex-ке көшіңіз.

FLUX.2 API-ін қалай қолданамын?

Сұрау өмірлік циклі (task + polling моделі)

Өңдеу/генерация сұрауларына жауаптар polling_url және id қамтитын task object түрінде қайтарылады; сіз сұрауды жасайсыз, содан кейін қол қойылған нәтиже URL-ін алу үшін poll жасайсыз (немесе webhook қолданасыз). Қол қойылған URL-дер қысқа мерзімге жарамды (әдетте шамамен 10 минут), сондықтан нәтижелерді тез жүктеп алыңыз.

Hosted API асинхронды task моделін ұстанады:

Генерация сұрауын POST арқылы жіберу → task id, polling_url және болжалды cost қайтарады.
status == "Ready" болғанша polling_url-ді poll жасау, содан кейін кескін нәтижесін алу (көбіне base64 немесе hosted URL).

Мысал: Python (requests) — жіберу және poll жасау

import time, requests, os

API_KEY = os.environ
API_URL = "https://api.cometapi.com/flux/v1/flux-2-pro"

payload = {
    "prompt": "Жұмсақ терезе жарығымен ағаш үстел үстіндегі керамикалық кружканың жоғары деңгейлі өнімдік фотосы.",
    "width": 1024, "height": 1024, "seed": 42
}

r = requests.post(API_URL, headers={"x-key": API_KEY, "accept":"application/json"}, json=payload)
r.raise_for_status()
task = r.json()
polling_url = task

while True:
    time.sleep(0.5)
    status_r = requests.get(polling_url, headers={"x-key": API_KEY})
    status_r.raise_for_status()
    status = status_r.json()
    if status == "Ready":
        print("Нәтиже URL-і:", status)
        break
    elif status in ("Error", "Failed"):
        print("Генерация сәтсіз аяқталды:", status)
        break

Бұл үлгі (жіберу → poll немесе webhook) — басқарылатын endpoint-тер үшін негізгі синхронды/асинхронды ағын.

Кескінді өңдеу — ең аз мысал (енгізу URL-імен curl)

curl -X POST "https://api.cometapi.com/flux/v1/flux-2-pro" \
  -H "accept: application/json" \
  -H "x-key: $CometAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Фонды күн сәулесі түскен теңіз жағалауындағы тақтай жолақпен ауыстырыңыз, адамды сол күйі сақтап, жарықты сәйкестендіріңіз",
    "input_image": "https://example.com/my-photo.jpg",
    "width": 2048,
    "height": 1536
  }'

Көпсілтемелі өңдеу үшін input_image, input_image_2, input_image_3, … пайдаланыңыз (Pro API арқылы 8-ге дейін сілтемені қолдайды; Flex 10-ға дейін; Dev үшін жадқа байланысты ұсынылатын максимум шамамен 6).

Қандай негізгі параметрлерді жіберуім керек?

Маңызды request body өрістері (кескінді өңдеу / генерация) мыналарды қамтиды:

guidance және steps — егжей-тегжейлі басқаруға мүмкіндік береді.
prompt (string) — 32K токенге дейін; егжей-тегжейлі табиғи тіл немесе құрылымдалған JSON.
input_image (string) — өңдеу үшін міндетті (URL немесе base64).
input_image_2 … input_image_9 — көпсілтемелі кескіндер.
width / height — 16-ның еселігі; шығыс максимум 4MP.
seed — қайта өндіру үшін бүтін сан.
safety_tolerance — модерация деңгейі.

Кәсіби мәтіннен кескін генерациясы үшін FLUX.2 Pro-ды қалай пайдалана аламын?

FLUX.2 Pro сенімді, жоғары сапалы нәтижелерге бапталған. Бренд деңгейіндегі бірізді нәтижелер, жылдам айналым уақыты және enterprise SLA қажет болса, оны пайдаланыңыз.

Жұмыс процесінің рецепті — өндірістік кескіндер

Промпттарды алдын ала өңдеу: қысқа “intent” жолын және құрылымдалған атрибуттар бөлімін сақтаңыз (жарық, объектив, көңіл күй, бренд түстеріне арналған hex түстер кодтары). FLUX.2 бренд палитраларын сақтауға көмектесу үшін hex түстер арқылы басқаруды қолдайды.
Сақтықпен әдепкі мәндерден бастаңыз: steps 30–50 және guidance scale 6–9.0; деталь үшін steps санын арттырыңыз, нәтижелер промптқа қатаңырақ сай болуы үшін guidance-ты көтеріңіз.
Қайта өндіру үшін seeds + deterministic sampling пайдаланыңыз, әсіресе A/B тестілеуде.
Көп нұсқалы таңдауға арналған Pro endpoint-ін қолданыңыз: параллель түрде N нұсқа сұратып, ең жақсысын таңдаңыз — бұл қолмен гиперпараметр баптаудан арзан әрі жылдам.
Кейінгі өңдеу: детерминистік pipeline ішінде denoise, шағын tone mapping немесе vector-style touchup қолданыңыз. Егер жергілікті шығыс сапасынан жоғары қажет болса, шағын GAN немесе super-resolution кезеңін қарастырыңыз.

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

Кескін генерациясына арналған үздік кеңестер

1. Өндіріс үшін құрылымдалған промптинг тиімді. Промпттарды басымдық бойынша ұйымдастырыңыз: нысан → әрекет → стиль → контекст. Көп кескінде детерминистік композиция қажет болса, JSON промптингті (scene, subjects, camera, lighting, color_palette) пайдаланыңыз. Псевдо JSON схемасының мысалы:

{
  "scene": "product shot",
  "subjects": [
    {"type":"mug","pose":"center","style":"ceramic, matte"},
    {"type":"background","style":"wooden desk, window light"}
  ],
  "camera": {"focal_length":"85mm","aperture":"f2.8","angle":"slightly above"}
}

2. Қайта өндіру: Кейін қайта жасау үшін seed беріңіз. Бақылау үшін prompt + seed → image сәйкестік каталогын сақтаңыз.

3. Batch және оркестрация: Үлкен өндірістік жүктемелерде Pro-ға көптеген сұрауды параллель жіберіңіз, бірақ throttling болмас үшін rate-limit қойыңыз; болжамды кідіріс үшін Pro endpoint-ін таңдаңыз. Дайын болғанда қол қойылған нәтижелерді тез жүктеу үшін job queue және worker pool қолданыңыз.

4. Модерация және қауіпсіздік: Модерация қатаңдығын басқару үшін safety_tolerance пайдаланыңыз. Pro endpoint-тері usage policy және content moderation hooks қамтиды; жариялауға дейін server-side тексерулерді біріктіріңіз.

5. Кейінгі өңдеу: Pro нәтижелері жоғары сапалы, бірақ кейде шағын түзетулер қажет болады. Pipeline-ыңызға автоматтандырылған postprocess қадамын (crop, color-grade, composite) енгізіп, брендке сезімтал активтер үшін адам тексеруін сақтаңыз.

FLUX.2 Flex endpoint-і арқылы нәтижелерді қалай баптай аламын?

Flex — “хирургиялық құрал” нұсқасы: нәтижені дәл қалыптастыру үшін steps, guidance, negative prompts, tile sizes және reference count параметрлерін баптайды.

Flex қашан таңдау керек

Сізге дәл типографиялық рендеринг керек (UI мокаптары, жапсырмалар).
Бірнеше сілтемені поза мен жарықты басқара отырып композициялау қажет.
Кеңейтілген prompt техникасын сынап жүрсіз (құрылымдалған промпттар, шектеулер тізбегі).

Мысал — Flex басқару кілттері және олардың әсері

steps — қадам көп болған сайын деталь жақсырақ болады (бірақ кідіріс артады).
guidance_scale — жоғары болса мәтіндік промптқа жақынырақ, төмен болса шығармашылық еркіндігі көбірек.
negative_prompt — элементтерді нақты алып тастау (мысалы, “no watermark, no extra fingers”).
tile_size / tiled_inference — өте жоғары ажыратымдылықтағы генерация үшін жадты жылдамдыққа айырбастап, инференс кеңістігін плиткаларға бөледі.
reference_weights — кейбір endpoint-терде қай кескін позаны, қайсысы стильді басқаратынын ығыстыру үшін сілтемелердің салмағын беруге болады.

Практикалық кеңес: Күрделі композициялар үшін алдымен қысқа, төмен guidance preview жасап композицияны тексеріңіз, содан кейін көбірек steps және жоғары guidance-пен upscale жасаңыз. Бұл екі өтімді әдіс құнды азайтып, нақты финалдық нәтижелер береді.

Мысал: steps және guidance-пен Flex сұрауы

curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "prompt": "Кинематографиялық фильм постері, жоғарыда қалың типография, негізгі кейіпкер ортасында, драмалық контурлық жарық",
    "width": 1536, "height": 2048,
    "steps": 50,
    "guidance": 7.5,
    "seed": 99999
  }'

Кеңес: Соңғы креативті бекіту кезеңінде Flex, ал ауқымды әрі жылдам pipeline үшін Pro қолданыңыз. Типография мен микро-деталь тапсырмаларында Flex айтарлықтай жақсырақ басқарылады.

Өндірістік қолдануға арналған үздік тәжірибелер

Төменде FLUX.2-ні ауқымды түрде біріктіруге арналған тексерілген үлгілер мен практикалық кеңестер берілген.

1) Мегапиксельді бақылау және кэштеу арқылы құнды басқарыңыз

FLUX.2 тарификациясы кіріс + шығыс мегапиксельдеріне негізделеді. Жоғары көлемді генерацияда шағын preview render-лерді (төмен ажыратымдылық, қысқа қадамдар) пайдаланып, тек соңғы кезеңде жоғары MP рендерлерге көшіңіз. Бірдей тапсырмаларды қайта рендерлемеу үшін рендерленген активтерді кэштеңіз (немесе diff-терді сақтаңыз). Жауаптардағы cost мәнін әрқашан көрсетіп, әр сұрау бойынша журналға жазыңыз.

2) Деңгейлерді дұрыс пайдаланыңыз: preview және final-render бөлінісі

Прототиптеу немесе көптеген нұсқалар үшін жылдам, аз қадамды Pro render-лерді іске қосыңыз.
Дәлдік маңызды соңғы бекітілген нәтижелер үшін Flex немесе жоғары MP Pro қолданыңыз. Бұл гибридті тәсіл өткізу қабілеті мен соңғы кескін сапасы арасында тепе-теңдік береді.

3) Prompt engineering → құрылымдалған промпттар және JSON

Детерминистік композиция қажет болғанда (сахна объектілері, камера, позалар, hex түсті үлгілер) FLUX.2-нің құрылымдалған JSON prompting мүмкіндігін пайдаланыңыз. Бұл қайталама промпттау циклдерін азайтады және топтамалардың қайта өндірілуін жақсартады. Cloudflare мысалдары multipart form ішінде ендірілген JSON промпттарын көрсетеді.

4) Қайта өндіру үшін seed + versioning

Қайта өндіруге болатын нәтижелер қажет болса, seed беріп, metadata ішінде модель нұсқасын/уақыт белгісін тіркеңіз. Детерминистік актив pipeline-дары үшін manifest сақтаңыз: prompt, seed, модель нұсқасы, ажыратымдылық, reference image hash-тері. Бұл бақылауды және rollback мүмкіндіктерін жақсартады.

Қорытынды

FLUX.2 “әсерлі демо” мен “өндірістік креативті құрал” арасындағы алшақтықты жабуға тікелей бағытталған. Көпсілтемелі өңдеу, жоғары ажыратымдылықтағы нәтижелер және hosted endpoint-тер жиынтығымен (сонымен бірге ашық инференс коды және квантталған consumer build-тер) ол командаларға көптеген практикалық мүмкіндік береді: зерттеу мен баптау үшін жергілікті іске қосу немесе тұрақты өндірістік pipeline үшін hosted Pro/Flex endpoint-терін пайдалану.

Әзірлеушілер Flux.2 Dev API, Flux.2 Flex API және Flux.2 Pro API қызметтеріне CometAPI арқылы қол жеткізе алады. Бастау үшін Playground ішінде CometAPI модель мүмкіндіктерін зерттеп, егжей-тегжейлі нұсқаулар үшін API guide қараңыз. Қол жеткізер алдында CometAPI-ге кіріп, API кілтін алғаныңызға көз жеткізіңіз. CometAPI интеграциялауға көмектесу үшін ресми бағадан әлдеқайда төмен баға ұсынады.

Бастауға дайынсыз ба?→ Бүгін CometAPI-ге тіркеліңіз !

AI туралы көбірек кеңестерді, нұсқаулықтарды және жаңалықтарды білгіңіз келсе, бізді VK, X және Discord желілерінде қадағалаңыз!