Flux.2 API қалай пайдалануға болады? Сіз білуіңіз керек барлық нәрсе

CometAPI
AnnaNov 27, 2025
Flux.2 API қалай пайдалануға болады? Сіз білуіңіз керек барлық нәрсе

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

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

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

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

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

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

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

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

FLUX.2 API интерфейсіне қалай қол жеткізуге болады?

Қоршаған ортаны дайындаңыз

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

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

Қандай соңғы нүктелер, аутентификация қажет?

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} астындағы басқарылатын соңғы нүктелерді көрсетеді және кескін жасау және өңдеу үшін flux-2-pro, flux-2-flex және flux-2-flex сияқты соңғы нүктелерді атайды. Сұраулар үшін API кілті қажет x-key тақырыбы.

Үлгілік отбасы және есептеулер

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

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

FLUX.2 API қалай пайдаланамын?

Сұраныс өмірлік циклі (тапсырма + сауалнама үлгісі)

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

Орналастырылған API асинхронды тапсырма үлгісіне сәйкес келеді:

  1. Жасау сұрауын POST → a қайтарады task id және polling_url плюс болжалды cost.
  2. Сауалнама polling_url дейін status == "Ready", содан кейін сурет нәтижесін шығарып алыңыз (көбінесе base64 немесе орналастырылған URL).

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

import time, requests, os

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

payload = {
    "prompt": "A high-end product photo of a ceramic mug on a wooden desk, soft window light.",
    "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("Result URL:", status)
        break
    elif status in ("Error", "Failed"):
        print("Generation failed:", status)
        break

Бұл үлгі (жіберу → сауалнама немесе веб-ілмек) басқарылатын соңғы нүктелер үшін негізгі синхронды/асинхронды ағын болып табылады.

Кескінді өңдеу — минималды мысал (URL енгізілетін бұралу)

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": "Replace the background with a sunlit seaside boardwalk, keep the person intact and match lighting",
    "input_image": "https://example.com/my-photo.jpg",
    "width": 2048,
    "height": 1536
  }'

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

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

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

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

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

FLUX.2 Pro сенімді, жоғары сапалы шығыстар үшін реттелген. Оны бренд деңгейіндегі тұрақты нәтижелер, жылдам өңдеу және кәсіпорынның SLA талаптары қажет болғанда пайдаланыңыз.

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

  1. Алдын ала өңдеу нұсқаулары: қысқа «ниет» жолын және құрылымдық атрибуттар бөлімін (жарықтандыру, объектив, көңіл-күй, бренд түстеріне арналған түсті он алтылық кодтар) сақтаңыз. FLUX.2 бренд палитраларын сақтауға көмектесу үшін алты қырлы түсті басқаруды қолдайды.
  2. Консервативті әдепкі мәндерден бастаңыз: қадамдар 30–50 және бағдарлау шкаласы 6–9.0; егжей-тегжейлі қадамдарды көбейтіңіз, нәтижелерді нұсқауды қатаңырақ орындау үшін нұсқауларды көбейтіңіз.
  3. Тұқымдарды + детерминирленген сынамаларды пайдаланыңыз A/B сынауында қайталану мүмкіндігі үшін.
  4. Көп реттік таңдау үшін Pro соңғы нүктесін пайдаланыңыз: N вариациясын параллельді түрде сұраңыз және ең жақсысын таңдаңыз — гиперпараметрлерді қолмен реттеуге қарағанда арзанырақ және жылдамырақ.
  5. Постпроцесс: детерминирленген құбыр желісіндегі дыбыссыздандыру, шамалы тонды салыстыру немесе векторлық стильді түрту. Егер сізге жергілікті шығыстан жоғарырақ қажет болса, шағын GAN немесе өте жоғары ажыратымдылық рұқсатын қарастырыңыз.

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

Суреттерді жасау бойынша ең жақсы кеңестер

1. Өндіріс үшін құрылымдық ынталандыру жеңістері. Сұрауларды басымдық бойынша ұйымдастырыңыз: тақырып → әрекет → стиль → контекст. Көптеген кескіндерде детерминирленген композиция қажет болғанда, JSON шақыруын пайдаланыңыз (көрініс, нысандар, камера, жарықтандыру, түстер палитрасы). 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 кейінірек көбейту үшін. Бақылау үшін каталогты салыстыру сұрауын + тұқым → кескінді сақтаңыз.

3. Топтама және оркестрлеу: Үлкен өндірістер үшін көптеген сұрауларды Pro бағдарламасына параллель түрде жіберіңіз, бірақ төмендетпеу үшін жылдамдықты шектеңіз; болжамды кідіріс үшін Pro соңғы нүктесін таңдаңыз. Дайын болғаннан кейін қол қойылған нәтижелерді жылдам жүктеп алу үшін жұмыс кезегі мен жұмысшы пулдарын пайдаланыңыз.

4. Модерация және қауіпсіздік: пайдалану safety_tolerance модерацияның қатаңдығын бақылау. Pro соңғы нүктелері пайдалану саясаттарын және мазмұнды модерациялау ілмектерін қамтиды; жариялау алдында серверлік тексерулерді біріктіріңіз.

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

FLUX.2 Flex соңғы нүктесімен шығыстарды қалай теңшеуге болады?

Flex – «хирургиялық құрал» нұсқасы: шығысты дәл пішімдеу үшін қадамдарды, нұсқауларды, теріс нұсқауларды, тақтайша өлшемдерін және сілтеме сандарын реттеңіз.

Flex қашан таңдалады

  • Сізге дәл типографиялық көрсету қажет (UI макеттері, белгілер).
  • Поза мен жарықтандыруды басқара отырып, бірнеше сілтемелерді біріктіру керек.
  • Сіз кеңейтілген жедел әдістермен тәжірибе жасап жатырсыз (құрылымдық шақырулар, шектеулер тізбегі).

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

  • steps — қосымша қадамдар = егжей-тегжейлі (кідіріс құны бойынша).
  • guidance_scale — жоғары = мәтіндік нұсқауға жақынырақ, төмен = көбірек шығармашылық.
  • negative_prompt — элементтерді анық жою (мысалы, «су белгісі жоқ, қосымша саусақтар жоқ»).
  • tile_size / tiled_inference — өте жоғары ажыратымдылықты генерациялау үшін, жылдамдық үшін жадты саудалау үшін плитка шығару кеңістігі.
  • reference_weights — кейбір соңғы нүктелер кескін дискілерінің поза мен стильге сәйкестігін анықтауға мүмкіндік береді.

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

Мысал: қадамдары мен нұсқаулары бар икемді сұрау

curl -X POST "https://api.bfl.ai/v1/flux-2-flex" \
  -H "Content-Type: application/json" \
  -H "x-key: $BFL_API_KEY" \
  -d '{
    "prompt": "Cinematic movie poster, bold typography at top, main character centered, dramatic rim lighting",
    "width": 1536, "height": 2048,
    "steps": 50,
    "guidance": 7.5,
    "seed": 99999
  }'

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

Өндірістегі ең жақсы тәжірибелер

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

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

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

2) Деңгейлерді ақылмен пайдаланыңыз: алдын ала қарау және соңғы көрсету бөлу

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

3) Жедел инженерия → құрылымдық шақырулар және JSON

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

4) Тұқым + репродуктивтілік үшін нұсқалау

Қайталанатын нәтижелер қажет болғанда, а seed және метадеректерге үлгі нұсқасын/уақыт белгісін жазыңыз. Детерминирленген актив конвейерлері үшін манифест сақтаңыз: жедел, тұқымдық, үлгі нұсқасы, ажыратымдылық, анықтамалық кескін хэштері. Бұл бақылау және кері қайтару опцияларын жақсартады.

қорытынды

FLUX.2 тікелей «әсерлі демонстрация» мен «өндірістік шығармашылық құрал» арасындағы алшақтықты жоюға бағытталған. Көп анықтамалық өңдеумен, жоғары ажыратымдылықтағы шығыстармен және орналастырылған соңғы нүктелер жиынтығымен (плюс ашық қорытынды коды және квантталған тұтынушы құрастырулары) ол командаларға көптеген практикалық опцияларды береді: зерттеу және теңшеу үшін жергілікті түрде іске қосыңыз немесе тұрақты өндіріс құбырлары үшін орналастырылған Pro/Flex соңғы нүктелерін пайдаланыңыз.

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

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

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

Толығырақ оқу

500+ модель бір API-да

20%-ға дейін жеңілдік