Black Forest Labs: FLUX.3 Image

FLUX 3 Image yozma topshiriq va o‘ntagacha namuna asosida tasvirlar yaratadi hamda tahrirlaydi. U kompozitsiya va mahalliy o‘zgarishlar uchun topshiriqda beriladigan chegaralovchi to‘rtburchaklar, veb va tasvir qidiruvi ma’lumotlariga tayanish hamda beshta aniqlik sinfini qo‘shadi.

Ailoot Ultra · Rasmlar POST /v1/images/generations black-forest-labs/flux-3-image

Model haqida

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

FLUX 3 Image — Black Forest Labs’ning kompozitsiyani aniq boshqaradigan tasvir yaratish va tahrirlash modeli. Matn tavsifi yangi sahna yaratishi mumkin; berilgan tasvirlar obyektni, qayta ishlanadigan sahnani yoki birlashtiriladigan bir nechta elementni belgilashi mumkin. Chegaralovchi to‘rtburchaklar topshiriqda har bir element qayerda bo‘lishini va mavjud tasvirning qaysi qismlari o‘zgarishini ko‘rsatishga imkon beradi. Natija — so‘ralgan sahna, matn va maketni tekshirish mumkin bo‘lgan tasvir.

Sahna yarating yoki tahrir ko‘rsatmasini bering

Yangi tasvir uchun asosiy obyekt, harakat yoki poza, muhit, yorug‘lik va kadr kompozitsiyasini tasvirlang. Tasvir ichidagi aniq so‘zlarni qo‘shtirnoqqa oling va qayerda chiqishini ayting. Mustaqil mahsulot topshirig‘ida och tosh sirt ustidagi qizil sayohat krujkasi, tepasidagi katta sarlavha va dastasini ochib beradigan yumshoq tong yorug‘ligi ko‘rsatilishi mumkin. Bir-biriga aloqasiz uslub so‘zlarini berish o‘rniga sarlavha, mahsulot va fon orasidagi munosabatni belgilang.

Tahrirlash uchun aniq obyekt va o‘zgarishni ayting: krujka rangini o‘zgartirish, yorliqni almashtirish, odamni ko‘chirish yoki sahna uslubini yangilash. Bitta tahrir qo‘lda chizilgan to‘rtburchakni talab qilmaydi. Hujjatlashtirilgan jarayon yaratishdan oldin ko‘rsatmani kengaytiradi, nomlangan elementni topishi va avtomatik to‘rtburchak qo‘shishi mumkin. Qaytgan kengaytirilgan topshiriq shu talqinni qayd etadi; bu ko‘rsatma noto‘g‘ri obyektni tanlaganda yoki istalmagan detal kiritganda foydali.

Namuna tasvirlarini birlashtiring va tayyorlang

Ishlab chiqaruvchining aniq profili tasvir URL lari yoki kodlangan tasvir ma’lumotlari shaklida birdan o‘ntagacha namunani qabul qiladi. Har biri kamida 256×256 piksel va ko‘pi bilan 16 megapiksel bo‘lishi kerak. Namunani tartibdagi o‘rni yoki ko‘rinadigan mazmuni orqali nomlang, keyin vazifasini tushuntiring: Image 1 dagi shaxs, Image 2 dagi kurtka va Image 3 dagi xona. Tasvir namunasi vizual axborot manbasi bo‘lib, undagi barcha aloqasiz detallarni ko‘chirish ko‘rsatmasi emas.

Tomonlar nisbati sozlamasi odatda auto. So‘rov spetsifikatsiyasida topshiriqda so‘ralgan nisbat ustun turadi; aks holda birinchi namuna kadr formatini belgilaydi, namuna ham, so‘ralgan format ham bo‘lmasa kvadrat natija olinadi. Kompozitda kerakli sahna namunasini birinchi qo‘ying yoki nisbatni aniq tanlang. Keyingi tuzatish bir xil vizual boshlang‘ich nuqtadan foydalanishi uchun manba tasvirlari va ularning tartibini natija bilan saqlang.

Elementlarni chegaralovchi to‘rtburchaklar bilan joylashtiring

Maket topshirig‘i tavsif matni va element qatorlarining JSON massivini birlashtiradi. Tavsif elementni <cup_1> kabi belgi orqali nomlaydi; qatorda id, bbox va desc bo‘ladi. Koordinatalar yuqori chap burchakdan o‘lchanadigan, [top, left, bottom, right] tartibidagi 0 dan 1000 gacha butun sonlardir. Masalan, [0, 0, 500, 500] tasvirning piksel o‘lchamidan qat’i nazar yuqori chap chorakni bildiradi. Maket uchun mo‘ljallangan tomonlar nisbatidan foydalaning, chunki koordinata to‘ri kadr bilan birga cho‘ziladi.

Tahrir qatori esa identifikator va tavsif bilan birga from, src_bbox va tgt_bbox dan foydalanadi. ref_image_0 birinchi berilgan tasvirni anglatadi. Bir xil manba va maqsad to‘rtburchaklari elementni joyida mahkamlaydi; turli to‘rtburchaklar uni ko‘chiradi yoki o‘lchamini o‘zgartiradi. Manbasiz yangi qator tavsifidagi elementni maqsad joyda yaratib, qo‘shish, almashtirish yoki rang o‘zgartirishga imkon beradi. Maqsadsiz manba qatori elementni olib tashlaydi. Qo‘shish va olib tashlashni yozma ko‘rsatmada ham, qatorlarda ham ayting; joyida qolishi kerak bo‘lgan detallar uchun tayanch qatorlarni saqlang.

Yozuvga o‘z to‘rtburchagini bering va aniq so‘zlarini desc ichida qo‘shtirnoqqa oling. To‘rtburchaklar joylashuv va ko‘lamni yo‘naltiradi; ular qirqish niqobi emas, shuning uchun element to‘rtburchakdan tashqariga chiqishi mumkin. Ishlab chiqaruvchi misollarida taxminan 40×25 pikselli to‘rtburchaklardagi yangi obyektlar ko‘pincha paydo bo‘lmaganini bildiradi. Yetarli ko‘rinadigan joy ajrating va tahrirlangan chegaralarni tekshiring. Maqsad hududidan tashqaridagi piksellar odatda barqaror qoladi, biroq soyalar, akslar va yaqin yoritish baribir o‘zgarishi mumkin.

Qidiruvga tayanish, natija sinflari va foydali qaydlar

Hujjatlashtirilgan profilda qidiruvga tayanish odatda yoqilgan bo‘lib, veb va tasvir qidiruvi yaratishga ma’lumot beradi. Faqat berilgan tavsif va namunalarni ishlatishi kerak bo‘lgan topshiriqda uni o‘chirish mumkin. Haqiqiy mavzuda joy, hodisa yoki obyektni aniq belgilang va faktik mazmunni badiiy ishlovdan ajrating. Yorliq, obyekt yoki tasvirlangan hodisa aniq bo‘lishi zarur bo‘lsa, qidiruvdan axborot olgan tasvirni ham ishonchli manba bilan solishtirish kerak.

Beshta aniqlik sinfi — 768sq, 1k, 1.5k, 2k va 4k; standart qiymat 1k. Ular teng piksel maydoni darajalarini anglatadi, shuning uchun aniq kenglik va balandlik tanlangan nisbatga bog‘liq. O‘n beshta o‘zgarmas nisbat 21:9 dan kvadrat va vertikal formatlar orqali 9:21 gacha boradi. Ushbu model profili o‘lchamni nisbat va aniqlik orqali boshqaradi; FLUX.2 so‘rov profillaridagi seed, width yoki height maydonlarini ochmaydi. Uning hujjatlashtirilgan versiya tanlagichi hozircha yetkazib beruvchi vaznlarining sanalangan mosligini tasdiqlash o‘rniga yangilanib turadigan relizni nomlaydi.

Ishlab chiqaruvchi jarayoni asinxron ishlovdan keyin tasvirni kengaytirilgan topshiriq bilan birga qaytaradi. Imzolangan tasvir yuklab olish havolasi bir soat amal qiladi. Vaqtinchalik havolaga tayanmasdan haqiqiy tasvir, yakuniy topshiriq va namunalarni saqlang. Ko‘rib chiqiladigan materialda so‘ralgan matn, obyekt joylashuvi, namuna qiyofasi va o‘zgargan hududni mo‘ljallangan ko‘rsatish o‘lchamida solishtiring. Yaratish tugashi shu vizual talablarni tekshirishning boshlang‘ich nuqtasidir.

Ailoot Ultra · Rasmlar 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

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-3-image	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1	Standart—
Maydon`resolution`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 768, 1K, 1.5K, 2K, 4K	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 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	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: 10	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	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	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
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.082 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-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

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

Usul yo‘llari taxalluslari

/v1/images

Chaqirish uchun tegishli ID lar

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image

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

Black Forest Labs: FLUX.3 Image