Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] adalah model gambar produksi Black Forest Labs untuk kreasi berbasis teks dan penyuntingan berpanduan referensi. Profilnya yang didokumentasikan menggabungkan detail fotorealistis, kendali teks dan warna, serta anggaran piksel referensi/keluaran dengan gambar hingga 4 megapiksel.

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

Tentang model

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

FLUX.2 [pro] adalah model generasi dan penyuntingan gambar Black Forest Labs yang berfokus pada produksi. Produsen menyajikannya sebagai pilihan bawaan untuk sebagian besar tugas visual FLUX.2: membuat gambar baru dari teks atau merevisi adegan menggunakan referensi visual. Kemampuan keluarganya mencakup material dan pencahayaan fotorealistis, teks terbaca, instruksi warna tepat, serta subjek yang konsisten dalam suntingan terkait. Artefak yang dikembalikan adalah gambar untuk adegan produk, komposisi editorial, konsep desain, atau komunikasi visual.

Siapkan brief produksi

Mulailah dengan subjek, apa yang dilakukannya atau bagaimana susunannya, gaya, serta latar atau cahaya. Panduan prompt produsen memberi perhatian lebih pada kata-kata awal dan menyarankan penempatan subjek serta aksi utama sebelum detail dekoratif. Panduan menyarankan 10–30 kata untuk konsep cepat dan 30–80 untuk proyek biasa, dengan deskripsi lebih panjang untuk adegan kompleks. Rentang tersebut adalah panduan penulisan prompt, bukan batas konteks teks.

Brief katalog orisinal dapat menampilkan lampu baja bertekstur sikat di atas meja abu-abu hangat, dengan sudut tiga perempat yang memperlihatkan sakelar dan kapnya. Tentukan permukaan, pencahayaan, dan sudut pandang yang membuat produk dapat dikenali. Untuk infografik atau gambar pemasaran, tetapkan kata-kata yang terlihat dan hierarkinya terlebih dahulu; kutip judul persisnya, tentukan penempatannya, serta sebutkan gaya dan ukuran huruf. Periksa label, jumlah, dan detail produk pada ukuran tampilan akhir.

Panduan keluarga mendokumentasikan prompt bahasa alami maupun terstruktur JSON. Brief adegan terstruktur dapat memisahkan subjek, latar belakang, cahaya, dan komposisi dalam kolom tersendiri agar satu persyaratan dapat direvisi dengan jelas. Panduan juga mendukung deskripsi warna heksadesimal: kaitkan kode dengan objek atau teks tertentu yang akan diwarnai. Jelaskan tampilan yang diinginkan secara positif karena alur prompt FLUX.2 yang didokumentasikan tidak menyediakan prompt negatif.

Sunting dengan referensi dan anggaran piksel bersama

Profil permintaan [pro] yang tepat menawarkan delapan posisi gambar referensi; antarmuka interaktif pembuat secara terpisah mendukung sepuluh. Tetapkan peran setiap gambar, misalnya tampilan subjek, pakaian, desain produk, ruangan, atau gaya. Untuk adegan yang sudah ada, nyatakan elemen yang diubah serta komposisi, lingkungan, dan detail visual yang harus dipertahankan. Contoh yang diterbitkan mencakup komposit furnitur, perubahan latar atau cuaca, objek pengganti, dan revisi teks.

Kapasitas referensi juga bergantung pada ukuran keluaran. Panduan [pro] produsen menetapkan anggaran total 9 megapiksel untuk masukan ditambah keluaran. Contohnya mengizinkan delapan referensi pada keluaran 1 megapiksel dan tujuh pada keluaran 2 megapiksel, sehingga kapasitas referensi berkurang saat hasil yang diminta membesar. Rencanakan kumpulan sumber dan keluaran bersama-sama, alih-alih menganggap jumlah slot maksimum tersedia untuk setiap ukuran keluaran. Gunakan referensi yang menetapkan informasi penting dan tentukan kontribusi yang dimaksud.

Untuk komposit produk, gambar pertama dapat menyediakan produk dan kedua ruangan, sementara gambar ketiga menetapkan lapisan material. Jelaskan bagaimana semuanya menjadi satu adegan yang padu. Jika hasil mengubah bentuk, tanda, atau identitas yang seharusnya tetap, sasarkan masalah itu dalam tindak lanjut, alih-alih mengganti seluruh brief. Hasil praktisnya adalah gambar revisi dengan kesetiaan pada referensi serta perubahan spesifik yang dibandingkan dengan masukannya.

Perluasan prompt serta profil tetap dan pratinjau

Spesifikasi [pro] yang tepat mengaktifkan prompt upsampling secara bawaan. Kendali disable_pup menghentikan perluasan tersebut ketika instruksi yang ditulis cermat harus digunakan sebagaimana diberikan. Pertahankan pengaturan pilihan ketika membandingkan versi karena konsep pendek yang sama dan deskripsi yang diperluas merupakan masukan generasi berbeda. Ini merupakan kendali profil pembuat, bukan jaminan bahwa setiap detail yang diminta muncul dengan benar.

Dokumentasi membedakan endpoint [pro] biasa sebagai snapshot tetap dari [pro] Preview, tempat peningkatan model berikutnya diperkenalkan. Bentuk permintaan dan responsnya sama, tetapi bobot yang mendasarinya berbeda. Simpan profil pilihan yang tepat bersama gambar dan referensinya. Label Preview terpisah tidak boleh diam-diam menggantikan pilihan [pro] biasa ketika revisi bergantung pada pilihan model terdokumentasi yang sama.

Dimensi, format, dan aset pilihan

Panduan keluarga mendokumentasikan keluaran hingga 4 megapiksel, dengan dimensi eksplisit minimal 64×64 dan kelipatan 16. Panduan menyarankan hingga 2 megapiksel untuk sebagian besar penggunaan. Lebar dan tinggi menentukan pembingkaian yang dimaksud; gambar produk persegi, tata letak potret, dan adegan editorial lebar membagi ruang secara berbeda. Permintaan yang tepat mencantumkan keluaran JPEG, PNG, dan WebP, dengan JPEG sebagai bawaan, serta seed opsional.

Profil [max] memiliki fitur pencarian grounding terpisah, sementara [flex] menyediakan langkah sampling dan guidance, dan [klein] memiliki profil lebih kecil dengan empat referensi. Pilih edisi berdasarkan pekerjaan yang dibutuhkan, alih-alih memasukkan kendali tersebut ke [pro]. Untuk aset pilihan, simpan gambar sebenarnya, prompt akhir, referensi, dimensi, dan label model. Tautan hasil bertanda tangan FLUX.2 produsen kedaluwarsa setelah sepuluh menit, sehingga ambil gambarnya, alih-alih bergantung pada lokasi sementara. Tinjau identitas subjek, warna, teks, komposisi, dan detail suntingan sebelum menempatkan hasil dalam materi untuk pelanggan.

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

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-pro	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.06 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.06 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-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

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

Alias jalur metode

/v1/images

ID pemanggil terkait

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

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

Black Forest Labs: FLUX.2 Pro