Black Forest Labs: FLUX.3 Image

FLUX 3 Image жазбаша тапсырма және онға дейін референс арқылы сурет жасайды әрі өңдейді. Ол композиция мен жергілікті өзгерістерге арналған промпттық шектеуші қораптарды, веб және кескін арқылы негіздеуді және бес ажыратымдылық класын қосады.

Ailoot Ultra · Суреттер POST /v1/images/generations black-forest-labs/flux-3-image

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

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

FLUX 3 Image — композицияны нақты басқаратын Black Forest Labs кескін генерациясы және өңдеу моделі. Мәтін сипаттамасы жаңа көрініс жасайды; берілген суреттер нысанды, өңделетін көріністі немесе біріктірілетін бірнеше элементті анықтай алады. Шектеуші қораптар тапсырмада әр элементтің орнын және бар суреттің қай бөлігі өзгеруі керегін көрсетуге мүмкіндік береді. Нәтиже — сұралған көрінісі, мәтіні және макеті тексерілетін сурет.

Көрініс жасаңыз немесе өңдеу нұсқауын беріңіз

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

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

Референс суреттерді біріктіріңіз және дайындаңыз

Өндірушінің нақты профилі сурет URL-і не кодталған сурет дерегі арқылы бір–он референс қабылдайды. Әрқайсысы кемінде 256×256 пиксель және 16 мегапиксельден аспауы керек. Референсті орны не көрінетін мазмұны бойынша атап, рөлін түсіндіріңіз: Image 1-дегі адам, Image 2-дегі күртеше және Image 3-тегі бөлме. Сурет референсі — ішіндегі әр қатысы жоқ бөлшекті көшіру нұсқауы емес, көрнекі ақпарат көзі.

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

Элементтерді шектеуші қораптармен орналастырыңыз

Макет промпты сипаттаманы элемент жолдарының JSON массивімен біріктіреді. Сипаттама элементті <cup_1> сияқты маркермен атайды; жолда id, bbox және desc болады. Координаттар — сол жақ жоғарғы бұрыштан өлшенетін, [top, left, bottom, right] ретіндегі 0–1000 бүтін сандары. Мысалы, [0, 0, 500, 500] суреттің пиксель өлшеміне қарамастан сол жақ жоғарғы ширекті сипаттайды. Макет жасалған арақатынасты пайдаланыңыз, өйткені координат торы кадрмен бірге созылады.

Өңдеу жолы идентификатор мен сипаттамаға қоса from, src_bbox және tgt_bbox қолданады. ref_image_0 — бірінші берілген сурет. Бірдей бастапқы және мақсатты қораптар элементті бекітеді; әртүрлі қораптар оны жылжытады не өлшемін өзгертеді. Бастапқы көзі көрсетілмеген жаңа жол сипаттамасын мақсатты орында жасап, қосуға, алмастыруға немесе қайта бояуға мүмкіндік береді. Мақсатты аймағы көрсетілмеген бастапқы жол элементті алып тастайды. Қосу мен алуды жазбаша нұсқауда да, жолдарда да көрсетіп, орнында қалуы тиіс бөлшектерге тірек жолдарды сақтаңыз.

Жазуға жеке қорап беріп, desc ішінде нақты мәтінді тырнақшаға алыңыз. Қораптар орын мен ауқымды бағыттайды; олар қию маскасы емес, сондықтан элемент төртбұрыштан шығуы мүмкін. Өндіруші мысалдарында шамамен 40×25 пиксель қораптардағы жаңа заттар жиі пайда болмағанын хабарлайды. Жеткілікті көрінетін кеңістік қалдырып, өңделген шекараларды тексеріңіз. Мақсаттан тыс пиксельдер әдетте тұрақты, бірақ көлеңкелер, шағылыстар және жақын жарық бәрібір өзгеруі мүмкін.

Негіздеу, шығыс кластары және пайдалы жазбалар

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

Бес ажыратымдылық класы — 768sq, 1k, 1.5k, 2k және 4k, әдепкісі — 1k. Бұлар пиксель ауданы тең деңгейлер, сондықтан нақты ен мен биіктік таңдалған арақатынасқа байланысты. Он бес тұрақты арақатынас 21:9-дан шаршы және тік пішімдер арқылы 9:21-ге дейін созылады. Осы модель профилі өлшемді арақатынас пен ажыратымдылық арқылы басқарады; FLUX.2 сұрау профильдеріндегі seed, width немесе height өрістерін ашпайды. Құжатталған нұсқа таңдағышы қазір жеткізуші салмақтарының күнмен бекітілген сәйкестігін емес, өзгермелі шығарылымды атайды.

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

Ailoot Ultra · Суреттер POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

Бастау

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

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

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

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

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер black-forest-labs/flux-3-image	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 768, 1K, 1.5K, 2K, 4K	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 10	Әдепкі—
Өріс`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.082 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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-3-image', '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-3-image

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

/v1/images

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

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image

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

Black Forest Labs: FLUX.3 Image