Black Forest Labs: FLUX.2 Max

FLUX.2 [max] ialah model imej Black Forest Labs untuk aset akhir yang menuntut kualiti tinggi dan suntingan konsisten. Profil yang didokumenkan menggabungkan rujukan visual, kawalan adegan terperinci dan grounding web untuk subjek semasa, dengan output sehingga 4 megapiksel.

Ailoot Ultra · Imej POST /v1/images/generations black-forest-labs/flux.2-max

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

FLUX.2 [max] ialah anggota berkualiti tertinggi dalam keluarga penjanaan dan penyuntingan imej FLUX.2 Black Forest Labs. Pengeluar meletakkannya untuk aset akhir yang mencabar, pematuhan tinggi kepada arahan kompleks dan konsistensi merentas suntingan. Ia mencipta imej daripada penerangan bertulis atau menggunakan imej yang diberikan sebagai rujukan visual. Keupayaan tersendiri dalam keluarga ini ialah carian grounding: permintaan boleh menggunakan maklumat semasa tanpa bergantung hanya pada adegan yang diterangkan dalam prompt.

Maklumat dunia sebenar dan arahan visual

Pengeluar mendokumenkan carian web untuk subjek seperti cuaca semasa, acara sukan terkini atau latar bersejarah. Kenal pasti lokasi, acara dan masa sebenar yang relevan dengan gambar, kemudian huraikan olahan artistik secara berasingan. Konsep kad cuaca dengan grounding boleh menetapkan bandar, keadaan yang hendak divisualkan, tajuk tepat dan susun atur. Carian memberi maklumat kepada penjanaan; ilustrasi yang menarik masih memerlukan fakta yang kelihatan disemak terhadap sumber berkaitan sebelum digunakan sebagai komunikasi berfakta.

Keupayaan carian ini milik [max] dalam perbandingan FLUX.2 yang diterbitkan. Anggota lain yang dinamakan mempunyai peranan masing-masing: [pro] untuk produksi, [flex] untuk pensampelan boleh laras dan tipografi, serta [klein] untuk penjanaan interaktif kompak. Simpan nama model pilihan bersama hasil supaya pindaan kemudian tidak menggantikan profil yang menyokong grounding dengan edisi lain secara senyap.

Rujukan untuk suntingan yang mencabar

Profil permintaan yang didokumenkan menerima sehingga lapan imej rujukan; antara muka interaktif pengeluar secara berasingan membenarkan sepuluh. Tetapkan peranan setiap rujukan, seperti rupa watak, reka bentuk produk, pakaian, bilik atau gaya visual. Komposisi boleh menggabungkan kerusi daripada satu gambar dengan bilik daripada gambar lain sambil mengekalkan siluet dan bahan kerusi. Untuk adegan sedia ada, kenal pasti objek yang hendak diubah serta butiran yang perlu kekal, termasuk arah cahaya dan geometri di sekelilingnya.

Contoh keluarga ini merangkumi perubahan latar belakang, penggantian objek, komposisi perabot, suntingan teks dan watak konsisten. Contoh arahan aset akhir asli boleh meletakkan jam tangan yang diberikan di atas kain gelap berlipat, mengekalkan reka bentuk muka dan talinya, serta mengubah hanya pencahayaan kepada cahaya sisi yang lembut. Nyatakan sumber yang membekalkan setiap ciri dan semak muka jam, tanda, bahan serta pantulan hasil bersama-sama. Arahan pemeliharaan menetapkan matlamat; gambar yang dikembalikan ialah bukti untuk dibandingkan dengannya.

Teks, warna dan tafsiran prompt

Panduan FLUX.2 mengesyorkan struktur subjek–tindakan–gaya–konteks, dengan unsur penting di hadapan. Ia mencadangkan 10–30 perkataan untuk konsep pantas, 30–80 untuk projek biasa dan penerangan lebih panjang untuk adegan kompleks. Ini ialah saranan penulisan, bukan had konteks mutlak. Bahasa semula jadi dan penerangan adegan berstruktur JSON kedua-duanya didokumenkan untuk menyusun subjek, kedudukan, cahaya dan gaya. Prompt berstruktur ialah arahan imej, bukannya janji respons teks berstruktur.

Untuk huruf yang kelihatan, apit perkataan dengan tanda petikan, tentukan kedudukannya dan huraikan hierarki tipografi. Kaitkan setiap warna heksadesimal dengan objek atau unsur teks tertentu; kod warna tanpa sasaran bernama adalah kabur. Panduan pengeluar menggunakan penerangan positif dan bukannya mekanisme prompt negatif. Untuk adegan produk dengan ruang kosong bagi tajuk, huraikan terus kawasan kosong itu dan kedudukan yang dimaksudkan.

Spesifikasi permintaan [max] yang tepat menggunakan pengembangan prompt secara lalai. Kawalan disable_pup mematikan pengembangan apabila arahan yang ditulis teliti perlu digunakan seperti yang diberikan. Ini berbeza daripada dakwaan bahawa setiap perkataan akan muncul tanpa perubahan dalam imej akhir. Simpan arahan sebenar dan tetapan pilihan bersama hasil ketika menilai sama ada keputusan visual yang tidak dijangka berpunca daripada arahan atau tafsirannya.

Output dan aset akhir yang berguna

Panduan keluarga mendokumenkan imej sehingga 4 megapiksel, dengan dimensi eksplisit sekurang-kurangnya 64×64 dan gandaan 16. Saranan kegunaan biasanya ialah sehingga 2 megapiksel. Profil [max] yang tepat menyenaraikan JPEG, PNG dan WebP, dengan JPEG sebagai lalai, serta seed rawak pilihan. Pilih bentuk output mengikut tempat penggunaan sebelum menyusun komposisi. Penjanaan imej model berasingan daripada mengubah saiz aset yang telah siap.

Simpan imej, rujukan, prompt, dimensi dan identiti model ketika memilih versi akhir. Panduan FLUX.2 pengeluar mengingatkan bahawa pautan hasil bertandatangan bersifat sementara, dengan tempoh pengambilan sepuluh minit. Periksa teks halus, identiti objek, susun atur, cahaya dan sebarang fakta daripada carian pada saiz paparan yang dimaksudkan. Hasil yang berguna ialah visual pilihan dengan konteks mencukupi untuk meneruskan pindaan tepat, bukannya adegan yang butiran pentingnya belum pernah dibandingkan dengan arahan.

Ailoot Ultra · Imej POST /v1/images/generations black-forest-labs/flux.2-max

black-forest-labs/flux.2-max

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

Pengenalan

Input yang diterima: Teks · Imej
Hasil: Imej

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Imej POST /v1/images/generations

Input: text, image
Output: image

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had black-forest-labs/flux.2-max	Lalai—
Medan`prompt`	Jenis`string`	KeperluanDiperlukan	Nilai & had Panjang minimum: 1	Lalai—
Medan`aspect_ratio`	Jenis`string`	KeperluanPilihan	Nilai & had 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Lalai—
Medan`output_format`	Jenis`string`	KeperluanPilihan	Nilai & had png, jpeg	Lalai—
Medan`n`	Jenis`integer`	KeperluanPilihan	Nilai & had Minimum: 1 Maksimum: 1	Lalai—
Medan`input_references`	Jenis`array`	KeperluanPilihan	Nilai & had Item minimum: 0 Item maksimum: 8	Lalai—
Medan`provider`	Jenis`object`	KeperluanPilihan	Nilai & had	Lalai—

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt
Parameter`material_types`	Kontraktext, image

Kitar hayat: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Pelan harga

Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas: Tidak dinyatakan Apabila mod pantas dipilih
Mod flex: Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum: Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

Konfigurasi	Jadual kadar	Kuantiti ramalan	Unit pengebilan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Unit pengebilan—	Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
Konfigurasimegapiksel imej keluaran	Jadual kadar—	Kuantiti ramalan—	Unit pengebilanbagi setiap megapiksel imej keluaran	Caj Output · megapiksel imej keluaran · Anggaran untuk perbandingan sahaja $0.14 bagi setiap megapiksel imej keluaran
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Unit pengebilan—	Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.14 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Contoh permintaan

Ailoot Ultra · Imej

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

Terima dan simpan hasil

Ailoot Ultra · Imej

Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya

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

Pembacaan kandungan lain

Baca aset sedia ada yang menjadi milik anda

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.

Simpan semua hasil yang selesai

Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.

Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.

Jika respons asal perlu disemak

Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.

Medan respons

Medan	Jenis
Medan`created`	Jenis
Medan`data[].url`	Jenis
Medan`data[].b64_json`	Jenis
Medan`usage`	Jenis

Alias

Alias model

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

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Apakah input dan hasil yang tersedia?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Apakah medan yang digunakan oleh permintaan?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Apakah had yang terpakai?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max