FLUX 3 API-ді қалай қолдану: Әзірлеушілерге арналған толық нұсқаулық

Жылдам жауап

FLUX 3 — Black Forest Labs-тың синхрондалған аудиомен мәтіннен бейнеге және кескіннен бейнеге генерацияға арналған мультимодальды бейне моделі. CometAPI-де өндірістік модель ID — flux-3. Расталған асинхронды жұмыс ағыны тапсырма жасау үшін POST /v1/videos, оны поллинг жасау үшін GET /v1/videos/{task_id} және аяқталған MP4-ті жүктеп алу үшін GET /v1/videos/{task_id}/content қолданады.

Қолжетімділік жаңартуы (тексерілген: 2026 жылғы 24 қыркүйек): Black Forest Labs FLUX 3 Video-ны шілдедегі Ерте қолжетімділік кезеңінен кейін алға жылжытып, мәтіннен бейнеге және кескіннен бейнеге алғашқы шығарылымын 2026 жылғы 4 тамызда BFL API және таңдалған серіктестер арқылы жалпы қолжетімді етті. CometAPI 2026 жылғы 13 тамызда өзінің Video API пішімінде өндірістік модель ID flux-3 қосты. Қолжетімділік, өрістер және бағалар бойынша ақиқат көзі ретінде BFL релиз анонсын және CometAPI-дің тірі модель бетін пайдаланыңыз.

FLUX 3 Ерте қолжетімділігінен бері не өзгерді?

Ең маңызды өзгеріс — операциялық қолжетімділік. Ертерек қамту шілдедегі өтінімге негізделген шығарылымға шоғырланды, ал BFL-дің тамыздағы релизі шақырылатын бейне endpoint, жарияланған шектеулер және өндірістік баға белгілеуді енгізді. Бұдан кейін CometAPI flux-3-ті өзінің біріктірілген Video API жұмыс ағыны арқылы ұсынды.

CometAPI-дің бұрынғы мақаласы, FLUX 3 API: Қолжетімділік, Ерте қолжетімділік, Видео және Dev, іске қосу тарихы мен шілдедегі алдын ала бағалау үшін пайдалы болып қала береді. Жалпы 2026 жылғы ең үздік AI Video API-лары салыстыруы нарықтық таңдауды қамтиды. Бұл нұсқаулық сол тақырыптарды ықшам ұстап, жұмыс істейтін сұрауларға, поллингке, промпттарға, шығындарды бақылауға және өндірістік өңдеуге назар аударады.

FLUX 3 деген не?

FLUX 3 — бейне, аудио, кескіндер және әрекетке қатысты болжау үшін арналған BFL-дің мультимодальды модельдер отбасы. Қазіргі бейне релиз мәтіннен бейнеге, кескіннен бейнеге және бейнені жалғастыруды бір провайдердің нативті endpoint-і арқылы қолдайды.

Бейне әзірлеушілер үшін басты мүмкіндіктер: 24 кадр/с жылдамдықта 20 секундқа дейін, HD немесе Full HD шығыс, синхрондалған аудио, ерін қимылымен сәйкестендірілген көптілді сөйлеу, бір генерацияда бірнеше шот және кескіннен бейнеге басқару үшін онға дейін бекітілген негізгі кадрлар.

FLUX 3 API спецификациялары

FLUX 3 Video қаншалықты жақсы?

BFL мәтіннен бейнеге арналған all-vs-all Elo көрсеткіші 1135 деп хабарлайды. Сол жарияланған салыстыруда FLUX 3 кескіннен бейнеге преференцияда Seedance 2.0-мен тең болып, қалған тексерілген модельдерден жоғары тұр.

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

FLUX 3 бенчмарк нәтижелері

Дереккөз: Black Forest Labs — FLUX 3 Video, Part 1: Generation.

FLUX 3 API қолданар алдында не қажет

• CometAPI аккаунты және backend орта айнымалысында сақталған API кілті.
• Тақырып, қозғалыс, камера бағыты, атмосфера және қажет аудио немесе диалогты анықтайтын промпт.
• Төзімді жұмыс-тапсырма өңдеу жолы, өйткені бейне генерация асинхронды.
• Итеративті тестке жеткілікті кредит; биллинг жасалған ұзақтық пен ажыратымдылыққа байланысты.

Кілтті CometAPI API dashboard-та жасаңыз. Оны frontend JavaScript-ке, мобильді жинақтарға, ашық репозиторийлерге немесе скриншоттарға орналастырмаңыз.

FLUX 3 модель ID және endpoint-тер

FLUX 3 API-ді CometAPI арқылы қалай пайдалану керек

1-қадам: API кілтіңізді орнатыңыз

macOS немесе Linux-та:

export COMETAPI_KEY="your_api_key"

Windows PowerShell-де:

$env:COMETAPI_KEY="your_api_key"

2-қадам: FLUX 3 бейнесін жасаңыз

Ағымдағы FLUX 3 quickstart model, prompt, seconds және size бар multipart сұрауын қолданады. Бұл мысал бес секундтық 720p клипті сұрайды:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F "model=flux-3" \
  -F "prompt=A paper boat glides across a still pond in soft morning light" \
  -F "seconds=5" \
  -F "size=1280x720"

Бұл сұрау жұмысты бастайды. Қолданбаны сол HTTP жауапта дайын MP4 алуына сүйеніп жобаламаңыз.

3-қадам: Task ID-ні сақтаңыз

Құру сұрауы сәтті болғаннан кейін идентификаторды бірден тұрақтандырыңыз:

{
  "id": "video_task_id",
  "status": "queued"
}

Поллинг басталмай тұрып task ID-ні пайдаланушы немесе жұмыс жазбасымен бірге сақтаңыз. Процестің қайта іске қосылуы әлдеқашан биллинг жасалған генерацияны жоғалтпауы тиіс.

4-қадам: Бейнені статусты поллинг жасау

curl https://api.cometapi.com/v1/videos/{task_id} \
  -H "Authorization: Bearer $COMETAPI_KEY"

Он секунд сияқты орташа интервалдан бастаңыз. completed, succeeded немесе success күйін финалдық сәтті күй ретінде; failed, failure, cancelled немесе canceled күйін финалдық сәтсіздік күйі ретінде қарастырыңыз.

5-қадам: MP4-ті жүктеп алыңыз

curl https://api.cometapi.com/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --output flux3_output.mp4

Аяқталғаннан кейін файлды уақытша провайдер URL-ін тұрақты актив ретінде сақтамай, өзіңіздің объект сақтауыңызға немесе медиа құбырыңызға көшіріңіз.

FLUX 3 бейнесін генерациялау үшін толық Python жұмыс ағыны

Төмендегі мысал жұмысты жасайды, оның ID-сін сақтайды, аяқталғанға дейін поллинг жасайды, сәтсіздік күйлерін тексереді, MP4 сигнатурасын валидтейді және шығысты дискке жазады.

import os
import time
from pathlib import Path

import requests

api_key = os.environ["COMETAPI_KEY"]
base_url = "https://api.cometapi.com"
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.post(
    f"{base_url}/v1/videos",
    headers=headers,
    files={
        "model": (None, "flux-3"),
        "prompt": (
            None,
            "A product bottle rotates slowly on wet black stone, "
            "soft rim lighting, macro lens, realistic reflections.",
        ),
        "seconds": (None, "5"),
        "size": (None, "1280x720"),
    },
    timeout=120,
)
response.raise_for_status()

task = response.json()
data = task.get("data") or {}
task_id = (
    task.get("id")
    or task.get("task_id")
    or data.get("id")
    or data.get("task_id")
)
if not task_id:
    raise RuntimeError(f"Create response has no task ID: {task}")

while True:
    response = requests.get(
        f"{base_url}/v1/videos/{task_id}",
        headers=headers,
        timeout=60,
    )
    response.raise_for_status()
    task = response.json()
    data = task.get("data") or {}
    status = str(task.get("status") or data.get("status") or "").lower()
    progress = task.get("progress") or data.get("progress") or "unknown"
    print(f"Status: {status or 'unknown'}; progress: {progress}")

    if status in {"failed", "failure", "cancelled", "canceled"}:
        raise RuntimeError(f"Video generation failed: {task}")
    if status in {"completed", "succeeded", "success"} or progress == "100%":
        break
    time.sleep(10)

response = requests.get(
    f"{base_url}/v1/videos/{task_id}/content",
    headers=headers,
    timeout=300,
)
response.raise_for_status()
video = response.content

if len(video) < 12 or video[4:8] != b"ftyp":
    raise RuntimeError("Content response is not a non-empty MP4 file")

output_dir = Path("output")
output_dir.mkdir(parents=True, exist_ok=True)
output_path = output_dir / f"{task_id}.mp4"
output_path.write_bytes(video)
print(f"Saved: {output_path} ({len(video)} bytes)")

Кескіннен бейнеге және негізгі кадрларды қалай пайдалану керек

CometAPI-дің FLUX 3 беті кескіннен бейнеге қолдауды көрсетеді. Оның ағымдағы ашық үлгісі мәтіннен бейнені демонстрациялайды, сондықтан басқа модельден reference-image өрісін көшіру өзгеріссіз жұмыс істейді деп болжымай тұрып, gateway құжаттамасының тірі нұсқасын тексеріңіз.

BFL-дің нативті API-і айқын: кескіннен бейнеге i2v режимі және keyframes өрісі арқылы жүзеге асады. Бір кескін бастапқы кадрды бекітеді, екі кескін басын және соңын бекіте алады, ал онға дейін уақытталған кескін үздіксіз клиптің storyboard-ын жасай алады.

BFL-негізгі негізгі кадр мысалы

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "i2v",
    "prompt": "They sprint through the lantern-lit alley as the camera tracks behind them.",
    "keyframes": [
      [0, "data:image/png;base64,<first-frame>"],
      [8, "data:image/png;base64,<last-frame>"]
    ],
    "duration": 8
  }'

Провайдер-негізгі және gateway параметрлерін бөлек адаптерлерде ұстаңыз. BFL mode, keyframes, start_video, resolution және draft сияқты өрістерді қолданады; CometAPI-дің расталған үлгісі model, prompt, seconds және size қолданады.

FLUX 3 API параметрлері түсіндірілді

FLUX 3 промпттарын қалай жақсырақ жазуға болады

BFL-дің бейне промпттарын жазу жөніндегі нұсқаулығы пән мен әрекетке, камераға, сахна мен атмосфераға, қозғалыс сапасына және үздіксіздікке қатысты нақты нұсқауды ұсынады. Аудиоға негізделген сахналар үшін диалог, дауыс, дыбыс эффектілері және амбиентті көрсетіңіз.

Практикалық промпт құрылымы

Subject + Environment + Action + Camera + Lighting
+ Dialogue/Voice + Sound Effects + Ambience + Constraints

Кинематографиялық промпт

A lone cyclist rides through a rain-soaked neon street at midnight.
The camera begins low beside the rear wheel, then rises into a smooth tracking shot.
Reflections stretch across wet asphalt under moving cyan and magenta light.
Audio: steady rainfall, chain noise, distant traffic, no music, no dialogue.
Keep the same rider, bicycle, jacket, and weather throughout the shot.

Өнімге арналған бейне промпты

A premium stainless-steel espresso machine stands on a dark stone counter.
Begin with a macro close-up of water droplets on the metal housing.
Orbit clockwise as the machine brews; steam catches warm side light.
Finish on a clean three-quarter hero angle with the cup in the foreground.
Audio: pump vibration, steam hiss, ceramic contact, quiet cafe ambience.
Do not change the product shape, logo placement, material, or color.

Диалог және нативті аудио промпты

A young chef works alone in a compact Tokyo ramen shop at night.
Start close on boiling broth, then pull back as the chef sets down a bowl.
Warm tungsten lighting, natural reflections, documentary handheld motion.
The chef quietly says in Japanese: 「お待たせしました。」
Audio: bubbling broth, soft rain outside, distant street traffic.
No subtitles and no background music.

“make a cinematic ramen shop video” сияқты промпт қозғалысты, кадрлауды, дыбысты және үздіксіздікті анықтамайды. Нақты нұсқау тестіленетін өндірістік техникалық тапсырманы жасайды.

FLUX 3 API бағалары

BFL баға белгілеуі жұмыс ағынына тәуелді: толық мәтіннен бейнеге және кескіннен бейнеге рендерлер HD-да $0.17/с немесе FHD-да $0.29/с, ал HD Draft Mode $0.06/с тұрады. Бейнені жалғастыру HD-да $0.43/с немесе FHD-да $0.54/с, HD draft — $0.12/с. CometAPI қазіргі уақытта flux-3 үшін 720p-да $0.136/с және 1080p-да $0.232/с тізімдейді. Үлкен партия алдында тірі бағаларды тексеріңіз.

Соңғы екі бағанды оқу: мәндер алдымен HD/720p, содан кейін FHD/1080p ретінде көрсетілген.

Итерация шығындарын қалай азайтуға болады

• Таңдалған промптты 1080p-ға көшер алдында 720p-да прототиптеңіз.
• Композицияны, қозғалысты және промпт интерпретациясын растау үшін бес секундтық клиптерді қолданыңыз.
• Бір уақытта бір негізгі промпт айнымалысын өзгертіңіз.
• BFL нативті API-ін пайдаланғанда, толық сапалы рендерге дейін Draft Mode-ты тексеріңіз.
• Сәтті промпттар мен анықтамалық шешімдерді қолданба метадеректерінде сақтаңыз.

FLUX 3 vs Wan 3.0 vs Seedance 2.5

FLUX 3, Wan 3.0 және Seedance 2.5-ті бір әмбебап жеңімпаз іздеуден гөрі жұмыс ағыны бойынша салыстырыңыз. Беделді спецификация сілтемелері төмендегі кесте тақырыбында қалады.

Баға ескертпесі: Бастапқы бағалар сапа немесе ажыратымдылық бойынша тікелей салыстыру емес. Бюджеттеу үшін әр тірі модель бетінің ажыратымдылық-спецификалық кестесін пайдаланңыз.

Қай Video API-ды таңдау керек?

• FLUX 3 таңдаңыз — реалистік қозғалыс, синхронды дыбыс, көпшот логикасы, нативті негізгі кадрлар немесе жалғастыру қажет болғанда.
• Wan 3.0 таңдаңыз — жұмыс ағыны көп кіріс түрлерімен басталғанда және 30 секундтық генерация маңызды болса.
• Seedance 2.5 таңдаңыз — ұзақ, референске бай сторителлинг, айқын сәйкестік, өнім және стиль бақылауы керек болса.

FLUX 3 API өндірістік үздік тәжірибелері

Асинхронды жұмыстарды тұрақты күй ретінде сақтаңыз

Жібергеннен кейін task ID-ні бірден сақтаңыз. Серверді қайта іске қосу немесе worker-дің қайта әрекеті қолданбаның бастапқы тапсырманы жоғалтуына байланысты пайдаланушыны тағы бір генерация үшін төлеуге мәжбүр етпеуі керек.

Тығыз поллингтен аулақ болыңыз

Тірі құжаттама басқаша ұсынбаса, он секундқа жуық интервалдан бастаңыз. Әр секунд сайын поллинг жасау сұрау қысымын арттырады, бірақ тәжірибені айтарлықтай жақсартпайды.

Жүктеп алуды валидтеңіз

Активті толық деп белгілемес бұрын контент ұзындығын және MP4 сигнатурасын тексеріңіз. Сәтті HTTP жауап әрқашан дененің жарамды бейне екенін білдірмейді.

Нативті және gateway схемаларды бөліңіз

BFL-негізгі және CometAPI сұраулары үшін бөлек адаптерлерді сақтаңыз. Бұл mode, keyframes және start_video сияқты нативті өрістердің model, prompt, seconds және size күтетін gateway қоңырауына өтіп кетпеуін қамтамасыз етеді.

Толық сәтсіздік контекстін сақтаңыз

HTTP статусын, жауап денесін, task ID, model ID, промпт нұсқасын, size, duration және ішкі job ID-ні логтаңыз. API кілтін жасырыңыз.

Шиппинг алдында шағын бағалау жиынтығын қолданыңыз

Камера қозғалысы, адамдар, өнімдер, типография, диалог, жоғары қозғалысты сахналар және қажет аспект қатынастарын қамтитын 10–30 өкілдік промпттар жасаңыз. Модель немесе интеграция нұсқасы өзгергенде сол жиынтықты іске қосыңыз және маңызды промпттарды қайталаңыз, өйткені бейне генерация стохастикалық.

Жиі қойылатын сұрақтар

CometAPI-дегі FLUX 3 модель ID қандай?

Ағымдағы модель ID — flux-3.

FLUX 3 қай CometAPI endpoint-ін қолданады?

Расталған Video API жұмыс ағыны POST /v1/videos, содан кейін GET /v1/videos/{task_id} және GET /v1/videos/{task_id}/content қолданады.

FLUX 3 синхронды ма?

Жоқ. Оны асинхронды жұмыс ретінде қарастырыңыз: жіберіңіз, task ID-ні сақтаңыз, поллинг жасаңыз және жүктеп алыңыз.

FLUX 3 қанша уақыт генерациялай алады?

BFL T2V/I2V үшін 5–20 секунд және жалғастыру үшін 5–15 секунд деп құжаттайды.

FLUX 3 аудио генерациялай ма?

Иә. BFL өзінің нативті API-інде синхрондалған аудио әдепкі бойынша қосулы екенін құжаттайды.

FLUX 3 кескіннен бейнеге қолдай ма?

Иә. CometAPI кескіннен бейнеге қолдауды тізімдейді, ал BFL-дің нативті API-і оны i2v режимі және keyframes арқылы жүзеге асырады.

BFL негізгі кадрларын CometAPI арқылы өзгеріссіз қолдана аламын ба?

Олай деп болжауға болмайды. Сұрау схемалары әртүрлі; gateway reference-image жұмыс ағынын жеткізер алдында CometAPI-дің ағымдағы quickstart-ын тексеріңіз.

CometAPI-де бес секундтық FLUX 3 бейнесі қанша тұрады?

Қазіргі тізімделген CometAPI бағаларында бес секунд 720p-да $0.68 немесе 1080p-да $1.16 тұрады. Жоғарыдағы біріктірілген баға кестесіндегі тірі сілтемені қараңыз.

FLUX 3 Wan 3.0 немесе Seedance 2.5-тен жақсы ма?

Жұмыс ағынына байланысты. FLUX 3 қозғалысы үйлесімді аудиовизуалды шоттар және BFL-негізгі негізгі кадр немесе жалғастыру бақылауы үшін әсерлі; Wan 3.0 кіріс ауқымын баса көрсетеді; Seedance 2.5 ұзақ, референске бай сторителлингке ерекше назар аударады.

Қорытынды

FLUX 3 енді CometAPI-де жұмыс істейтін асинхронды Video API жолына ие, ал BFL-дің нативті құжаттамасы негізгі кадрлар, жалғастыру, аудио және Draft Mode үшін тереңірек басқаруды ашады.

Қауіпсіз интеграция жолы қарапайым: қысқа 720p мәтіннен бейнеге сұраудан бастаңыз, task ID-ні сақтаңыз, сақ поллинг жасаңыз, MP4-ті жүктеп алып, валидтеңіз, содан кейін промпт шаблондары, сақтау, қайта әрекет ету логикасы және қайталанатын бағалау жиынтығын қосыңыз. Нативті және gateway схемаларды бөлек ұстаңыз және өрістер мен бағаларды қатты кодтамас бұрын тірі модель бетін тексеріңіз.