Black Forest Labs: FLUX.2 Flex

FLUX.2 [flex] mengkhususkan diri pada tipografi gambar dan detail visual kecil, dengan langkah sampling dan guidance yang dapat diatur. Gunakan teks dan referensi gambar untuk mengembangkan poster, tata letak produk, atau revisi tepat sambil menyeimbangkan kepatuhan dan realisme.

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

Tentang model

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

FLUX.2 [flex] adalah edisi generasi dan penyuntingan gambar Black Forest Labs yang mengkhususkan diri pada tipografi, rendering teks, dan pelestarian detail kecil. Model menggunakan instruksi adegan tertulis serta referensi gambar untuk menghasilkan gambar. Kendali khasnya adalah sampling yang dapat diatur: profil yang didokumentasikan menyediakan langkah inferensi dan guidance, sehingga brief visual dapat disempurnakan melalui pengaturan maupun kata-kata.

Huruf dan detail halus

Tugas tipografi harus dimulai dengan naskah sebenarnya. Kutip setiap baris, tentukan tempatnya, dan bedakan judul, teks pendukung, serta label. Jelaskan gaya, skala, dan warna huruf dalam kaitannya dengan adegan. Brief poster orisinal dapat menampilkan sepeda biru kobalt di studio pucat, dengan judul besar di atas rangka dan baris spesifikasi lebih kecil di bawahnya. Gambar harus memperjelas produk dan urutan baca bersama-sama.

Untuk visual produk terperinci, tentukan bagian yang menentukan kegunaan hasil: dial, label kendali, jahitan, tepi material, atau tanda kemasan. Berikan referensi terbaca dan jelaskan fitur yang ditetapkannya. Adegan yang secara umum tampak serupa tetap dapat mengubah karakter atau komponen penting, sehingga bandingkan detail yang dihasilkan pada ukuran tampilan yang dimaksud. Spesialisasi model merupakan alasan memberikan persyaratan tepat, bukan jaminan bahwa penyuntingan ejaan atau pemeriksaan visual menjadi tidak perlu.

Langkah dan guidance memiliki tujuan berbeda

Profil produsen yang tepat menerima satu hingga lima puluh langkah inferensi, dengan lima puluh sebagai bawaan. Deskripsinya mengaitkan lebih banyak langkah dengan detail dan realisme lebih tinggi. Guidance berkisar 1.5 hingga 10, dengan bawaan 5. Guidance lebih tinggi memperkuat kepatuhan pada prompt tetapi dapat mengurangi realisme. Karena itu, gambar dengan instruksi desain tepat dan gambar yang mencari tampilan fotografis alami dapat memerlukan pilihan berbeda dalam profil tersebut.

Pertahankan kata-kata, referensi, dan bentuk keluaran ketika membandingkan perubahan pengaturan. Perhatikan fitur yang mendorong perubahan: bentuk huruf, penempatan objek, atau tekstur material. Ubah pengaturan karena alasan visual tertentu, alih-alih menganggap angka besar otomatis lebih baik. Ini adalah kendali sampling produsen; profil [klein] terdistilasi empat langkah dan kendali standar [pro] atau [max] merupakan pilihan model berbeda.

Prompt upsampling aktif secara bawaan dalam spesifikasi [flex] dan dapat dinonaktifkan melalui kendali prompt_upsampling tersendiri. Hal ini memungkinkan brief terperinci tetap berupa teks yang diberikan bila sesuai. Panduan bersama produsen menyarankan penempatan subjek utama dan aksi penting sebelum dekorasi sekunder, serta menjelaskan prompt terstruktur JSON bersama brief bahasa alami. Gunakan struktur yang paling memudahkan penentuan hubungan yang diperlukan.

Revisi berpanduan referensi

Profil permintaan yang tepat memuat delapan posisi gambar referensi. Alur interaktif pembuat secara terpisah mengizinkan hingga sepuluh gambar; jumlah itu menjelaskan antarmuka berbeda. Tentukan apakah gambar menyediakan adegan yang disunting, produk, karakter, pakaian, atau gaya. Untuk revisi, tentukan objek dan perubahan, lalu sebutkan komposisi sekeliling, material, atau cahaya yang harus tetap.

Tugas kemasan orisinal dapat menggunakan karton dari gambar pertama dan lapisan akhir dari gambar kedua, mengganti label depan dengan kata-kata yang disetujui, serta mempertahankan proporsi karton. Komposisi kelompok dapat menetapkan referensi berbeda bagi setiap subjek dan menjaga penetapan itu konsisten. Contoh keluarga mencakup perubahan objek dan latar, pengompositan, suntingan teks, dan transformasi gaya. Minta satu revisi terpadu dengan sasaran jelas, lalu bandingkan bagian yang disunting maupun bagian yang harus tetap stabil.

Ukuran, warna, dan gambar yang dikembalikan

Panduan FLUX.2 mendokumentasikan minimum 64×64 piksel, dimensi kelipatan 16, dan keluaran hingga 4 megapiksel, dengan hingga 2 megapiksel disarankan untuk penggunaan biasa. Spesifikasi [flex] yang tepat mencantumkan keluaran JPEG, PNG, dan WebP, dengan JPEG sebagai bawaan. Spesifikasi juga menyediakan seed acak opsional. Simpan model sebenarnya, seed, dan pengaturan sampling bersama referensi sumber ketika membandingkan versi; nama keluarga saja tidak mengidentifikasi konfigurasi generasi lengkap.

Untuk pekerjaan peka warna, kaitkan setiap kode heksadesimal dengan objek atau elemen teks bernama. Untuk komposisi, tentukan rasio aspek yang dimaksud melalui dimensi gambar dan sisakan ruang cukup bagi huruf terbaca. Panduan bersama tidak memiliki mekanisme prompt negatif, sehingga jelaskan tampilan yang diinginkan secara positif: fokus tajam, latar bersih, atau area kosong yang jelas untuk naskah. Contoh multibahasanya mendukung penulisan brief khusus budaya dalam bahasa sesuai tanpa menetapkan jaminan jumlah bahasa tetap.

Alur FLUX.2 produsen mengembalikan gambar setelah pemrosesan dan menggunakan tautan bertanda tangan sementara dengan jendela pengambilan sepuluh menit. Simpan gambar sebenarnya bersama brief. Periksa tipografi, detail halus, identitas referensi, dan pengolahan visual sebelum menempatkan aset dalam tata letak. Hasil akhir dapat berupa poster pilihan, gambar produk, atau komposisi suntingan dengan pengaturan tepat yang disimpan untuk revisi berikutnya.

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

black-forest-labs/flux.2-flex

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

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-flex	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 masukan	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper megapiksel gambar masukan	Biaya Masukan · megapiksel gambar masukan · Perkiraan hanya untuk perbandingan $0.12 per megapiksel gambar masukan
Konfigurasimegapiksel gambar keluaran	Jadwal tarif—	Jumlah perkiraan—	Satuan penagihanper megapiksel gambar keluaran	Biaya Keluaran · megapiksel gambar keluaran · Perkiraan hanya untuk perbandingan $0.12 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.12 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-flex', '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-flex

Alias jalur metode

/v1/images

ID pemanggil terkait

black-forest-labs/flux.2-flex

FAQ · Black Forest Labs: FLUX.2 Flex

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

Black Forest Labs: FLUX.2 Flex