Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] — Black Forest Labs’ning matndan tasvir yaratish va namunalar yordamida tahrirlashga mo‘ljallangan ishlab chiqarish modeli. Uning hujjatlashtirilgan profili fotorealistik detallar, matn va rang nazoratini namuna/natija piksellari byudjeti hamda 4 megapikselgacha tasvirlar bilan birlashtiradi.

Ailoot Ultra · Rasmlar POST /v1/images/generations black-forest-labs/flux.2-pro

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

FLUX.2 [pro] — Black Forest Labs’ning ishlab chiqarishga yo‘naltirilgan tasvir yaratish va tahrirlash modeli. Ishlab chiqaruvchi uni FLUX.2 dagi ko‘pchilik vizual vazifalar uchun asosiy tanlov sifatida taqdim etadi: matndan yangi tasvir yaratish yoki vizual namunalar yordamida sahnani qayta ishlash. Oila imkoniyatlari fotorealistik material va yoritish, o‘qiladigan matn, aniq rang ko‘rsatmalari hamda bog‘liq tahrirlarda obyektlarning izchilligini qamrab oladi. Qaytariladigan artefakt — mahsulot sahnasi, tahririy kompozitsiya, dizayn g‘oyasi yoki vizual xabarda ishlatiladigan tasvir.

Ishlab chiqarish topshirig‘ini tayyorlang

Asosiy obyekt, uning harakati yoki joylashuvi, uslub hamda muhit yoki yorug‘likdan boshlang. Ishlab chiqaruvchining topshiriq qo‘llanmasi dastlabki so‘zlarga ko‘proq e’tibor beradi va asosiy obyekt hamda harakatni bezak detallaridan oldin qo‘yishni tavsiya qiladi. Tezkor g‘oyalar uchun 10–30, oddiy loyihalar uchun 30–80 so‘z, murakkab sahnalar uchun esa uzunroq tavsiflar taklif qilinadi. Bu oraliqlar matn konteksti chegarasi emas, topshiriq yozish tavsiyalaridir.

Mustaqil katalog topshirig‘ida iliq kulrang stol ustidagi jilvirlangan po‘lat chiroqni, tugma va qalpog‘i ko‘rinadigan uch chorak rakursda ko‘rsatish mumkin. Mahsulotni tanitadigan sirt, yoritish va ko‘rish nuqtasini belgilang. Infografika yoki marketing tasviri uchun avval ko‘rinadigan so‘zlar va iyerarxiyani hal qiling; aniq sarlavhani qo‘shtirnoqda yozing, joylashuvini, harflar uslubi va o‘lchamini ayting. Yorliqlar, miqdorlar va mahsulot detallarini yakuniy ko‘rsatish o‘lchamida tekshiring.

Oila qo‘llanmasi tabiiy tildagi va JSON tuzilmali topshiriqlarni hujjatlashtiradi. Tuzilmali sahna topshirig‘i obyekt, fon, yorug‘lik va kompozitsiyani alohida maydonlarda saqlab, bitta talabni aniq o‘zgartirishga imkon beradi. U hex rang tavsiflarini ham qo‘llaydi: kodni rang beriladigan aniq obyekt yoki matn bilan bog‘lang. Kerakli ko‘rinishni ijobiy ifodalang, chunki hujjatlashtirilgan FLUX.2 topshiriq jarayoni salbiy topshiriqlarni taqdim etmaydi.

Namunalar va umumiy piksel byudjeti bilan tahrirlang

Aynan [pro] so‘rov profili sakkizta namuna tasviri o‘rnini taklif qiladi; ishlab chiqaruvchining interaktiv interfeysi esa alohida ravishda o‘ntasini qo‘llaydi. Har bir tasvirga obyekt qiyofasi, kiyim, mahsulot dizayni, xona yoki uslub kabi vazifa bering. Mavjud sahnada o‘zgartiriladigan elementni, saqlanishi kerak bo‘lgan kompozitsiya, muhit va vizual detallarni ayting. E’lon qilingan misollarga mebel kompozitlari, fon yoki ob-havo almashishi, obyekt almashtirish va matnni tuzatish kiradi.

Namuna sig‘imi natija o‘lchamiga ham bog‘liq. Ishlab chiqaruvchining [pro] qo‘llanmasi kirish va chiqish uchun jami 9 megapiksellik byudjetni belgilaydi. Misollarda 1 megapikselli natijada sakkizta, 2 megapikselli natijada yettita namuna mumkin; so‘ralgan tasvir kattalashgan sari namuna sig‘imi kamayadi. Eng ko‘p o‘rinlar soni har qanday natija o‘lchamida mavjud deb qarash o‘rniga manbalar to‘plami va natijani birgalikda rejalashtiring. Zarur ma’lumotni belgilaydigan namunalarni ishlating va ularning ko‘zlangan hissasini ayting.

Mahsulot kompozitida birinchi tasvir mahsulotni, ikkinchisi xonani, uchinchisi esa material qoplamasini berishi mumkin. Ular qanday qilib bitta yaxlit sahnaga aylanishini tushuntiring. Natija saqlanishi kerak bo‘lgan shakl, belgi yoki qiyofani o‘zgartirsa, butun topshiriqni almashtirish o‘rniga keyingi murojaatda aynan shu muammoni nishonga oling. Amaliy natija — namunalarga sodiqligi va aniq o‘zgarishi kirishlar bilan taqqoslangan qayta ishlangan tasvir.

Topshiriqni kengaytirish va o‘zgarmas hamda preview profillari

Aynan [pro] spetsifikatsiyasida topshiriqni kengaytirish odatda yoqilgan. Uning disable_pup boshqaruvi puxta yozilgan ko‘rsatma berilganicha ishlatilishi kerak bo‘lganda kengaytirishni to‘xtatadi. Variantlarni solishtirishda tanlangan sozlamani saqlang, chunki bir xil qisqa g‘oya va kengaytirilgan tavsif turli yaratish kirishlaridir. Bu ishlab chiqaruvchi profilining boshqaruvi bo‘lib, so‘ralgan har bir detal to‘g‘ri paydo bo‘lishiga kafolat emas.

Hujjatlar oddiy [pro] endpointini o‘zgarmas model nusxasi, [pro] Preview ni esa keyingi model yaxshilanishlari kiritiladigan profil deb ajratadi. So‘rov va javob tuzilmalari bir xil, asosiy vaznlari esa farq qiladi. Tanlangan aniq profilni tasvir va namunalar bilan birga saqlang. Tuzatish bir xil hujjatlashtirilgan model tanloviga bog‘liq bo‘lsa, alohida Preview belgisi oddiy [pro] tanlovini indamay almashtirmasligi kerak.

O‘lchamlar, formatlar va tanlangan material

Oila qo‘llanmasi 4 megapikselgacha natijani, kamida 64×64 va 16 ga karrali aniq o‘lchamlarni hujjatlashtiradi. Ko‘pchilik vazifalar uchun 2 megapikselgacha tavsiya qilinadi. Kenglik va balandlik kerakli kadr formatini belgilaydi; kvadrat mahsulot tasviri, vertikal maket va keng tahririy sahna joyni turlicha taqsimlaydi. Aynan shu so‘rov JPEG, PNG va WebP natijalarini, odatiy JPEG formatini va ixtiyoriy seed ni ko‘rsatadi.

[max] profilida alohida qidiruvga tayangan yaratish imkoniyati bor; [flex] namuna olish qadamlari va guidance ni ochadi, [klein] esa kichikroq, to‘rt namunali profilga ega. Bu boshqaruvlarni [pro] ga ko‘chirish o‘rniga nashrni kerakli ishga qarab tanlang. Tanlangan material uchun haqiqiy tasvir, yakuniy topshiriq, namunalar, o‘lchamlar va model belgisini saqlang. Ishlab chiqaruvchining FLUX.2 imzolangan natija havolalari o‘n daqiqadan so‘ng tugaydi, shuning uchun vaqtinchalik manzilga tayanmasdan tasvirni oling. Natijani mijozga ko‘rinadigan materialga joylashtirishdan avval obyekt qiyofasi, ranglar, matn, kompozitsiya va tahrirlangan detallarni tekshiring.

Ailoot Ultra · Rasmlar POST /v1/images/generations black-forest-labs/flux.2-pro

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn · Rasmlar
Natijalar: Rasmlar

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Rasmlar POST /v1/images/generations

Kirish: text, image
Chiqish: image

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar black-forest-labs/flux.2-pro	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Standart—
Maydon`output_format`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar png, jpeg	Standart—
Maydon`n`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 1	Standart—
Maydon`input_references`	Tur`array`	TalabIxtiyoriy	Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 8	Standart—
Maydon`provider`	Tur`object`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt
Parametr`material_types`	Parametr talablaritext, image

Hayot sikli: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariflar

Yakuniy to‘lov qanday hisoblanadi

Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Taqqoslash uchun taxminiy tariflar

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Prognoz miqdori	Hisob birligi	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	Hisob birligi—	To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token
SozlamaChiqish rasmining megapikseli	Tariflar jadvali—	Prognoz miqdori—	Hisob birligichiqish rasmining megapikseli uchun	To‘lov Chiqish · Chiqish rasmining megapikseli · Faqat taqqoslash uchun taxmin $0.06 chiqish rasmining megapikseli uchun
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	Hisob birligi—	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.06 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas.

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

So‘rov namunalari

Ailoot Ultra · Rasmlar

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-pro', '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

Natijalarni olish va saqlash

Ailoot Ultra · Rasmlar

Har bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Boshqa kontentni o‘qish

O‘zingizga tegishli mavjud materiallarni o‘qish

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.

Barcha tayyor natijalarni saqlash

Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.

To‘liq javob va sarlavhalarni, amalda qaytarilgan barcha natijalarni, dastlab qaytarilgan identifikatorlarni hamda barcha usage maydonlarini saqlang. Yaratish so‘rovini qayta yubormasdan dastlabki operatsiyani tiklang.

Asl javobni tekshirish kerak bo‘lsa

Qaytarilgan X-Client-Request-ID ni ma’lumotlarni solishtirib tekshirish uchun saqlang. Faqat amalda qaytarilgan task_id/asset_id qiymatlari bo‘yicha yoki o‘zingizga tegishli media kutubxonasidan ma’lumot o‘qing; operatsiya ID sidan vazifa URL manzilini hech qachon tuzmang va yaratish so‘rovini qayta yubormang.

Javob maydonlari

Maydon	Tur
Maydon`created`	Tur
Maydon`data[].url`	Tur
Maydon`data[].b64_json`	Tur
Maydon`usage`	Tur

Taxalluslar

Model taxalluslari

Ailoot Ultra black-forest-labs/flux.2-pro

Usul yo‘llari taxalluslari

/v1/images

Chaqirish uchun tegishli ID lar

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider
Qanday cheklovlar amal qiladi?: POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Pro