Black Forest Labs: FLUX.2 Max

FLUX.2 [max] adalah model gambar Black Forest Labs untuk aset akhir dengan tuntutan kualitas tinggi dan suntingan konsisten. Profilnya yang didokumentasikan menggabungkan referensi visual, kendali adegan terperinci, dan grounding web untuk subjek terkini, dengan keluaran hingga 4 megapiksel.

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

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

FLUX.2 [max] adalah anggota berkualitas tertinggi dalam keluarga generasi dan penyuntingan gambar FLUX.2 dari Black Forest Labs. Produsen memosisikannya untuk pembuatan aset akhir dengan tuntutan kualitas tinggi, kesesuaian yang kuat dengan brief kompleks, dan konsistensi antarsuntingan. Model membuat gambar dari deskripsi tertulis atau menggunakan gambar yang diberikan sebagai referensi visual. Kemampuan pembeda dalam keluarganya adalah pencarian grounding: permintaan dapat memanfaatkan informasi terkini, alih-alih hanya mengandalkan adegan yang dijelaskan dalam prompt.

Informasi dunia nyata dan brief visual

Pembuat mendokumentasikan pencarian web untuk subjek seperti cuaca terkini, acara olahraga baru-baru ini, atau latar sejarah. Tentukan lokasi, peristiwa, dan waktu sebenarnya yang relevan dengan gambar, lalu jelaskan pengolahan artistiknya secara terpisah. Konsep kartu cuaca berbasis grounding dapat menentukan kota, kondisi yang divisualisasikan, judul persis, dan tata letaknya. Pencarian memberi informasi untuk generasi; ilustrasi menarik tetap perlu diperiksa fakta yang terlihat terhadap sumber relevan sebelum menjadi komunikasi faktual.

Kemampuan pencarian ini dimiliki [max] dalam perbandingan FLUX.2 yang diterbitkan. Anggota bernama lain memiliki peran masing-masing: [pro] untuk produksi, [flex] untuk sampling dan tipografi yang dapat diatur, serta [klein] untuk generasi interaktif ringkas. Simpan nama model pilihan bersama hasil agar revisi selanjutnya tidak diam-diam menggantikan profil yang mendukung grounding dengan edisi berbeda.

Referensi untuk penyuntingan dengan tuntutan tinggi

Profil permintaan yang didokumentasikan menerima hingga delapan gambar referensi; antarmuka interaktif pembuat secara terpisah mengizinkan sepuluh. Tetapkan peran setiap referensi, misalnya tampilan karakter, desain produk, pakaian, ruangan, atau gaya visual. Komposisi dapat menggabungkan kursi dari satu gambar dengan ruangan dari gambar lain sambil mempertahankan siluet dan material kursi. Untuk adegan yang sudah ada, tentukan objek yang diubah dan detail yang dipertahankan, termasuk arah cahaya dan geometri sekeliling.

Contoh keluarga mencakup perubahan latar belakang, penggantian objek, komposisi furnitur, suntingan teks, dan karakter konsisten. Brief aset akhir orisinal dapat menempatkan jam tangan yang diberikan di atas kain gelap terlipat, mempertahankan desain dial dan tali, serta hanya mengubah pencahayaan menjadi cahaya samping lembut. Sebutkan sumber setiap fitur dan tinjau dial, tanda, material, serta pantulan hasilnya bersama-sama. Instruksi untuk mempertahankan detail menetapkan tujuan; gambar yang dikembalikan adalah bukti untuk dibandingkan dengannya.

Teks, warna, dan penafsiran prompt

Panduan FLUX.2 menyarankan struktur subjek–aksi–gaya–konteks, dengan elemen penting di awal. Panduan menyarankan 10–30 kata untuk konsep cepat, 30–80 untuk proyek biasa, serta deskripsi lebih panjang untuk adegan kompleks. Itu merupakan rekomendasi penulisan, bukan batas konteks keras. Bahasa alami dan deskripsi adegan terstruktur JSON sama-sama merupakan cara terdokumentasi untuk mengatur subjek, penempatan, cahaya, dan gaya. Prompt terstruktur adalah brief gambar, bukan janji respons teks terstruktur.

Untuk huruf yang terlihat, kutip kata-katanya, tentukan posisinya, dan jelaskan hierarki tipografi. Kaitkan setiap warna heksadesimal dengan objek atau elemen teks tertentu; kode warna tanpa sasaran bernama bersifat ambigu. Panduan pembuat menggunakan deskripsi positif, alih-alih mekanisme prompt negatif. Untuk adegan produk dengan ruang kosong bagi judul, jelaskan area kosong dan posisi yang dimaksud secara langsung.

Spesifikasi permintaan [max] yang tepat menerapkan prompt upsampling secara bawaan. Kendali disable_pup menonaktifkan perluasan itu ketika brief yang ditulis cermat harus digunakan sebagaimana diberikan. Ini berbeda dari klaim bahwa setiap kata akan muncul tanpa perubahan dalam gambar akhir. Simpan brief sebenarnya dan pengaturan pilihan bersama hasil ketika menilai apakah keputusan visual yang tidak diharapkan berasal dari instruksi atau penafsirannya.

Keluaran dan aset akhir yang berguna

Panduan keluarga mendokumentasikan gambar hingga 4 megapiksel, dengan dimensi eksplisit minimal 64×64 dan kelipatan 16. Hingga 2 megapiksel merupakan rekomendasi penggunaan biasa. Profil [max] yang tepat mencantumkan JPEG, PNG, dan WebP, dengan JPEG sebagai bawaan, serta seed acak opsional. Pilih bentuk keluaran untuk penempatan yang dimaksud sebelum menyusun komposisi. Generasi gambar model terpisah dari pengubahan ukuran aset yang sudah selesai.

Simpan gambar, referensi, prompt, dimensi, dan identitas model ketika memilih versi akhir. Panduan FLUX.2 produsen memperingatkan bahwa tautan hasil bertanda tangan bersifat sementara, dengan jendela pengambilan sepuluh menit. Periksa teks kecil, identitas objek, tata letak, cahaya, dan fakta yang berasal dari pencarian pada ukuran tampilan yang dimaksud. Artefak yang berguna adalah visual pilihan dengan konteks yang cukup untuk melanjutkan revisi tepat, alih-alih adegan yang detail pentingnya belum pernah dibandingkan dengan brief.

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

Mulai

Masukan yang diterima: Teks · Gambar
Hasil: Gambar

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Gambar POST /v1/images/generations

Masukan: text, image
Keluaran: image

Kolom	Jenis	Persyaratan	Nilai & batasan	Bawaan
Kolom`model`	Jenis`string`	PersyaratanWajib	Nilai & batasan black-forest-labs/flux.2-max	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanWajib	Nilai & batasan Panjang minimum: 1	Bawaan—
Kolom`aspect_ratio`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	Bawaan—
Kolom`output_format`	Jenis`string`	PersyaratanOpsional	Nilai & batasan png, jpeg	Bawaan—
Kolom`n`	Jenis`integer`	PersyaratanOpsional	Nilai & batasan Minimum: 1 Maksimum: 1	Bawaan—
Kolom`input_references`	Jenis`array`	PersyaratanOpsional	Nilai & batasan Item minimum: 0 Item maksimum: 8	Bawaan—
Kolom`provider`	Jenis`object`	PersyaratanOpsional	Nilai & batasan	Bawaan—

Parameter metode dan siklus hidup

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

Siklus hidup: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast: Tidak ditentukan Saat mode fast dipilih
Mode Flex: Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum: Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

Konfigurasi	Jadwal tarif	Jumlah perkiraan	Satuan penagihan	Biaya
KonfigurasiTarif dasar token	Jadwal tarifTarif dasar	Jumlah perkiraan—	Satuan penagihan—	Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
Konfigurasimegapiksel gambar keluaran	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper megapiksel gambar keluaran	Biaya Keluaran · megapiksel gambar keluaran · Perkiraan hanya untuk perbandingan $0.14 per megapiksel gambar keluaran
KonfigurasiPerkiraan biaya pembuatan	Jadwal tarif—	Jumlah perkiraanestimasi satu kali pembuatan	Satuan penagihan—	Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.14 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot Ultra · Gambar

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 · Gambar

Unduh setiap gambar yang dikembalikan atau simpan konten 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 konten lain

Baca aset yang sudah ada dan 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 gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.

Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.

Jika respons asli perlu diperiksa

Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.

Kolom respons

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

Alias

Alias model

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

Alias jalur metode

/v1/images

ID pemanggil terkait

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

Input dan hasil apa yang tersedia?: POST /v1/images/generations · black-forest-labs/flux.2-max: text, image → image
Kolom apa yang digunakan permintaan?: POST /v1/images/generations · black-forest-labs/flux.2-max: model, prompt, aspect_ratio, output_format, n, input_references, provider
Batasan apa yang berlaku?: POST /v1/images/generations · black-forest-labs/flux.2-max: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Max