Black Forest Labs: FLUX.2 Klein 4B
FLUX.2 [klein] 4B ialah model imej kompak Black Forest Labs yang melalui penyulingan langkah untuk penciptaan berpandukan teks dan penyuntingan dengan sehingga empat rujukan. Reka bentuk empat langkahnya menyokong kerja visual interaktif sambil mengekalkan identiti berasingan daripada edisi Base 4B tanpa penyulingan.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
FLUX.2 [klein] 4B ialah model kompak Black Forest Labs untuk mencipta imej daripada penerangan teks dan menyunting imej dengan rujukan visual. Transformer rectified-flow berparameter empat bilionnya menyatukan penjanaan dan penyuntingan dalam satu seni bina. Edisi 4B yang dinamakan ini melalui penyulingan langkah, dan contoh rujukan pengeluar menggunakan empat langkah inferens.
Peranan model ialah menghasilkan draf atau pindaan visual interaktif: terokai adegan produk, ubah pakaian watak, gabungkan subjek dengan latar atau perhalus rupa ilustrasi. Mulakan dengan peristiwa atau komposisi penting, kemudian huraikan subjek, bahan, pencahayaan dan sudut pandangan. Arahan konkrit boleh meletakkan cawan seramik biru kusam di atas meja oak cerah, dengan pandangan dekat bercahaya sisi yang mengekalkan pemegang dan glasirnya kelihatan. Hasilnya ialah imej untuk diperiksa berdasarkan keputusan itu.
Menyunting dengan set rujukan kecil
Profil 4B yang didokumenkan menerima sehingga empat imej input. Tetapkan peranan jelas bagi setiap satu: rupa produk, watak, latar atau gaya. Jika satu gambar ialah adegan untuk disunting, kenal pastinya dan nyatakan perubahan serta butiran yang perlu kekal. Contohnya, kekalkan siluet dan permukaan cawan daripada imej pertama, gunakan bilik daripada imej kedua dan gantikan hanya alas meja. Urutan rujukan dan arahan perubahan yang tepat memberikan sasaran pindaan lebih jelas daripada meminta penambahbaikan umum.
Pengeluar membezakan bajet rujukan kompak ini daripada varian FLUX.2 yang lebih besar. Ia juga menyatakan bahawa [klein] tidak mempunyai pengembangan prompt. Berikan sendiri maklumat deskriptif penting, termasuk hubungan antara objek rujukan, tanpa bergantung pada pengembangan automatik label ringkas. Untuk satu siri, kekalkan rujukan subjek dan keperluan visual yang sama sambil mengubah satu keputusan adegan pada satu masa.
Tetapan output dan sempadan edisi
Profil 4B pengeluar yang tepat menyenaraikan output JPEG, PNG dan WebP, dengan JPEG sebagai lalai. Nilai lebar dan tinggi eksplisit didokumenkan dengan minimum 64 piksel setiap satu; contoh kad model rujukan menggunakan imej 1024×1024. Contoh itu ialah konfigurasi pensampelan, bukan pernyataan bahawa setiap tugas mesti berbentuk segi empat sama atau 1024 piksel merupakan maksimum model. Pilih pemotongan dan bentuk paparan yang dimaksudkan sebelum menyediakan arahan visual, kemudian bandingkan tulisan halus dan ciri kecil pada saiz itu.
Contoh empat langkah yang diterbitkan menggunakan guidance_scale 1.0. Bezakan edisi tersuling ini daripada FLUX.2 [klein] Base 4B, yang isyarat latihannya tanpa penyulingan ditujukan untuk penyesuaian, latihan LoRA dan penyelidikan. Base 4B serta model 9B merupakan pilihan berasingan dengan pertimbangan penyediaan dan pensampelan berbeza. Kawalan standard model kompak juga berbeza daripada langkah dan guidance boleh laras [flex]; [max] mempunyai keupayaan carian grounding tersendiri.
Butiran untuk disahkan dalam imej
Kad model tepat menyatakan bahawa model ini bukan sumber maklumat berfakta. Teks bertulis dalam imej boleh tidak tepat atau terherot, dan adegan yang dijana mungkin menyimpang daripada permintaan. Gaya prompt memberi kesan besar terhadap pematuhan. Semak ejaan, kuantiti, label, identiti subjek dan objek tertentu yang sepatutnya kekal; komposisi menarik tidak membuktikan bahawa ciri produk atau fakta yang diilustrasikan adalah betul. Pengeluar turut menyatakan bahawa output statistik boleh mencerminkan bias data latihan.
Untuk aset yang telah disemak, simpan rujukan sumber, perkataan akhir dan identiti model pilihan bersama imej. Dokumentasi keluaran membezakan tera air peringkat piksel dalam contoh kod rujukan daripada metadata asal usul C2PA yang digunakan dalam aliran output hos pengeluar. Mengekalkan maklumat asal usul yang dikembalikan membantu menjelaskan sumber aset; perkara itu berasingan daripada menyemak sama ada perubahan visual yang diminta berjaya.
Ailoot Ultra · Imej POST /v1/images/generations black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4b
black-forest-labs/flux.2-klein-4bPengenalan
FLUX.2 [klein] 4B ialah model imej kompak Black Forest Labs yang melalui penyulingan langkah untuk penciptaan berpandukan teks dan penyuntingan dengan sehingga empat rujukan. Reka bentuk empat langkahnya menyokong kerja visual interaktif sambil mengekalkan identiti berasingan daripada edisi Base 4B tanpa penyulingan.
- 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 |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had black-forest-labs/flux.2-klein-4b | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto | Lalai— |
Medanoutput_format | Jenisstring | KeperluanPilihan | Nilai & had png, jpeg | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1 | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 4 | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_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.028 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.028 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
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 · Imej
Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan kandungan 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 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 |
|---|---|
Medancreated | Jenis |
Medandata[].url | Jenis |
Medandata[].b64_json | Jenis |
Medanusage | Jenis |
Alias
Alias model
Ailoot Ultra black-forest-labs/flux.2-klein-4b
Alias laluan kaedah
/v1/images
ID pemanggil berkaitan
FAQ · Black Forest Labs: FLUX.2 Klein 4B
- Apakah input dan hasil yang tersedia?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:text,image→image- Apakah medan yang digunakan oleh permintaan?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:model,prompt,aspect_ratio,output_format,n,input_references,provider- Apakah had yang terpakai?
POST /v1/images/generations·black-forest-labs/flux.2-klein-4b:n.minimum:1;n.maximum:1