Black Forest Labs: FLUX.2 Klein 4B
FLUX.2 [klein] 4B adalah model gambar ringkas Black Forest Labs yang didistilasi berdasarkan langkah untuk kreasi berbasis teks dan penyuntingan dengan hingga empat referensi. Desain empat langkahnya mendukung pekerjaan visual interaktif sambil mempertahankan identitas terpisah dari edisi Base 4B tanpa distilasi.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
FLUX.2 [klein] 4B adalah model ringkas Black Forest Labs untuk membuat gambar dari deskripsi teks dan menyunting gambar dengan referensi visual. Transformer rectified-flow berparameter empat miliar ini menempatkan generasi dan penyuntingan dalam satu arsitektur. Edisi bernama 4B didistilasi berdasarkan langkah, dan contoh referensi produsen menggunakan empat langkah inferensi.
Peran model adalah draf atau revisi visual interaktif: menjelajahi adegan produk, mengubah pakaian karakter, menggabungkan subjek dengan latar, atau menyempurnakan tampilan ilustrasi. Mulailah dengan peristiwa atau komposisi yang penting, lalu jelaskan subjek, material, pencahayaan, dan sudut pandang. Brief konkret dapat menempatkan cangkir keramik biru matte di atas meja oak pucat, dengan pandangan dekat bercahaya samping yang memperlihatkan gagang dan glasirnya. Hasilnya adalah gambar untuk diperiksa terhadap keputusan tersebut.
Penyuntingan dengan kumpulan referensi kecil
Profil 4B yang didokumentasikan menerima hingga empat gambar masukan. Tetapkan peran jelas untuk masing-masing: tampilan produk, karakter, latar, atau gaya. Jika satu gambar merupakan adegan yang disunting, tentukan gambar itu dan nyatakan perubahan sekaligus detail yang dipertahankan. Misalnya, pertahankan siluet dan permukaan cangkir dari gambar pertama, gunakan ruangan dari gambar kedua, dan ganti hanya penutup meja. Urutan referensi dan instruksi perubahan yang tepat memberi revisi sasaran lebih jelas dibanding permintaan peningkatan umum.
Produsen membedakan anggaran referensi ringkas ini dari varian FLUX.2 yang lebih besar. Produsen juga menyatakan bahwa [klein] tidak memiliki prompt upsampling. Berikan sendiri informasi deskriptif yang penting, termasuk hubungan antarobjek referensi, alih-alih mengandalkan perluasan otomatis dari label pendek. Untuk sebuah seri, pertahankan referensi subjek dan persyaratan visual yang sama sambil mengubah satu keputusan adegan setiap kali.
Pengaturan keluaran dan batas antaredisi
Profil 4B produsen yang tepat mencantumkan keluaran JPEG, PNG, dan WebP, dengan JPEG sebagai bawaan. Nilai lebar dan tinggi eksplisit didokumentasikan dengan minimum masing-masing 64 piksel; contoh kartu model referensi menggunakan gambar 1024×1024. Contoh tersebut adalah konfigurasi sampling, bukan pernyataan bahwa setiap tugas harus persegi atau bahwa 1024 piksel merupakan maksimum model. Pilih potongan dan bentuk tampilan yang dimaksud sebelum menyiapkan brief visual, lalu bandingkan huruf halus dan fitur kecil pada ukuran tersebut.
Contoh empat langkah yang diterbitkan menggunakan guidance_scale 1.0. Pisahkan edisi terdistilasi ini dari FLUX.2 [klein] Base 4B, yang sinyal pelatihan tanpa distilasinya ditujukan untuk adaptasi, pelatihan LoRA, dan penelitian. Base 4B dan model 9B adalah pilihan berbeda, dengan pertimbangan persiapan dan sampling berbeda. Kendali standar model ringkas ini juga berbeda dari langkah dan guidance [flex] yang dapat diatur; [max] memiliki kemampuan pencarian grounding tersendiri.
Detail yang perlu diverifikasi dalam gambar
Kartu model yang tepat menyatakan bahwa model ini bukan sumber informasi faktual. Teks tertulis dalam gambar dapat keliru atau terdistorsi, dan adegan yang dihasilkan dapat menyimpang dari permintaan. Gaya prompt sangat memengaruhi kepatuhan. Periksa ejaan, jumlah, label, identitas subjek, dan objek spesifik yang harus dipertahankan; komposisi menarik tidak membuktikan bahwa fitur produk atau fakta yang diilustrasikan benar. Pembuat juga mencatat bahwa keluaran statistik dapat mencerminkan bias data pelatihan.
Untuk aset yang ditinjau, simpan referensi sumber, kata-kata akhir, dan identitas model pilihan bersama gambar. Dokumentasi rilis membedakan contoh watermark tingkat piksel dalam kode referensi dari metadata asal-usul C2PA yang diterapkan dalam alur keluaran terhosting produsen. Menyimpan asal-usul yang dikembalikan membantu menjelaskan asal aset; hal itu terpisah dari pemeriksaan apakah perubahan visual yang diminta berhasil.
Ailoot Ultra · Gambar POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bMulai
FLUX.2 [klein] 4B adalah model gambar ringkas Black Forest Labs yang didistilasi berdasarkan langkah untuk kreasi berbasis teks dan penyuntingan dengan hingga empat referensi. Desain empat langkahnya mendukung pekerjaan visual interaktif sambil mempertahankan identitas terpisah dari edisi Base 4B tanpa distilasi.
- 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 |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan black-forest-labs/flux.2-klein-4b | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Bawaan— |
Kolomoutput_format | Jenisstring | PersyaratanOpsional | Nilai & batasan png, jpeg | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 4 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_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.028 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.028 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
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-klein-4b', '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}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan konten lain
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 |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Alias
Alias model
Ailoot Ultra black-forest-labs/flux.2-klein-4b
Alias jalur metode
/v1/images
ID pemanggil terkait
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Batasan apa yang berlaku?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1