model

Black Forest Labs: FLUX.3 Image

Markdown · JSON

Black Forest Labs: FLUX.3 Image

FLUX 3 Image mencipta dan menyunting imej daripada arahan bertulis serta sehingga sepuluh rujukan. Ia menambah kotak pembatas berasaskan prompt untuk komposisi dan perubahan setempat, grounding web dan imej, serta lima kelas resolusi.

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

FLUX 3 Image ialah model penjanaan dan penyuntingan imej Black Forest Labs dengan kawalan komposisi eksplisit. Penerangan teks boleh mencipta adegan baharu; imej yang diberikan boleh menetapkan subjek, adegan untuk dipinda atau beberapa unsur untuk digabungkan. Kotak pembatas membolehkan arahan menentukan kedudukan setiap unsur dan bahagian imej sedia ada yang perlu berubah. Hasilnya ialah imej dengan adegan, teks dan susun atur yang diminta untuk diperiksa.

Cipta adegan atau berikan arahan suntingan

Untuk imej baharu, huraikan subjek, tindakan atau pose, latar, cahaya dan pembingkaian. Apit perkataan tepat dalam imej dengan tanda petikan dan nyatakan tempatnya. Contoh arahan produk asli boleh menunjukkan cawan perkhemahan merah di atas permukaan batu pucat, dengan tajuk besar di atasnya serta cahaya pagi lembut yang menyerlahkan pemegang. Tentukan hubungan antara tajuk, produk dan latar belakang tanpa memberikan perkataan gaya yang tidak berkaitan.

Untuk penyuntingan, kenal pasti objek tertentu dan perubahan: warnakan semula cawan, gantikan label, alihkan figura atau ubah gaya adegan. Satu suntingan tidak memerlukan kotak yang dilukis secara manual. Aliran yang didokumenkan mengembangkan arahan sebelum penjanaan dan boleh mencari unsur bernama serta menambah kotak secara automatik. Prompt dikembangkan yang dikembalikan merekodkan tafsiran itu, yang berguna apabila arahan memilih objek salah atau memperkenalkan butiran tidak dikehendaki.

Gabungkan dan sediakan imej rujukan

Profil tepat pengeluar menerima satu hingga sepuluh rujukan, diberikan sebagai URL imej atau data imej berkod. Setiap satu mestilah sekurang-kurangnya 256×256 piksel dan tidak melebihi 16 megapiksel. Namakan rujukan mengikut kedudukan atau kandungan yang kelihatan, kemudian jelaskan peranannya: orang daripada Imej 1, jaket daripada Imej 2 dan bilik daripada Imej 3. Rujukan imej ialah sumber maklumat visual, bukannya arahan menyalin semua butiran tidak berkaitan yang terkandung di dalamnya.

Tetapan nisbah bidang secara lalai ialah auto. Dalam spesifikasi permintaan, nisbah yang diminta dalam prompt diberi keutamaan; jika tiada, rujukan pertama menentukan pembingkaian, dengan output segi empat sama sebagai pilihan sandaran apabila tiada rujukan atau bentuk diminta yang menetapkannya. Untuk gabungan, letakkan rujukan adegan yang dimaksudkan dahulu atau pilih nisbah secara eksplisit. Simpan imej sumber dan urutannya bersama hasil supaya pindaan kemudian menggunakan titik permulaan visual yang sama.

Letakkan unsur dengan kotak pembatas

Prompt susun atur menggabungkan kapsyen dengan tatasusunan JSON bagi baris unsur. Kapsyen menamakan unsur melalui penanda seperti <cup_1>; baris mengandungi id, bbox dan desc. Koordinat ialah integer daripada 0 hingga 1000 mengikut urutan [top, left, bottom, right], diukur dari penjuru kiri atas. Contohnya, [0, 0, 500, 500] menerangkan suku kiri atas tanpa mengira dimensi piksel imej. Gunakan nisbah bidang yang menjadi asas reka bentuk susun atur kerana grid koordinat itu meregang mengikut bingkai.

Baris suntingan pula menggunakan from, src_bbox dan tgt_bbox bersama pengecam dan penerangan. ref_image_0 bermaksud imej pertama yang diberikan. Kotak sumber dan sasaran sepadan menambat unsur; kotak berbeza mengalih atau mengubah saiznya. Baris baharu tanpa sumber menjana penerangannya di lokasi sasaran, membolehkan penambahan, penggantian atau pewarnaan semula. Baris sumber tanpa sasaran membuang unsur. Nyatakan penambahan dan pembuangan dalam arahan bertulis serta baris, dan kekalkan baris tambatan untuk butiran yang mesti tetap di tempatnya.

Berikan tulisan kotak tersendiri dan apit perkataan tepatnya dengan tanda petikan dalam desc. Kotak memandu kedudukan dan skala; ia bukan topeng pemotongan, jadi unsur boleh melangkaui segi empat itu. Pengeluar melaporkan bahawa objek baharu dalam kotak sekitar 40×25 piksel sering gagal muncul dalam contohnya. Sediakan ruang kelihatan mencukupi dan periksa sempadan suntingan. Piksel di luar sasaran biasanya kekal stabil, tetapi bayang, pantulan dan pencahayaan berhampiran masih boleh berubah.

Grounding, kelas output dan rekod berguna

Profil yang didokumenkan mengaktifkan grounding secara lalai, membolehkan carian web dan imej membekalkan maklumat kepada penjanaan. Ia boleh dimatikan untuk arahan yang sepatutnya menggunakan hanya penerangan dan rujukan yang diberikan. Untuk subjek dunia sebenar, kenal pasti lokasi, acara atau objek dengan jelas dan asingkan kandungan berfakta daripada olahan artistik. Imejan berdasarkan carian masih perlu dibandingkan dengan bahan berwibawa apabila label, objek atau peristiwa yang digambarkan mesti tepat.

Lima kelas resolusi ialah 768sq, 1k, 1.5k, 2k dan 4k, dengan 1k sebagai lalai. Ia mewakili peringkat luas piksel setara, jadi lebar dan tinggi tepat bergantung pada nisbah pilihan. Lima belas nisbah tetap merangkumi 21:9, format segi empat sama dan potret, hingga 9:21. Profil model ini mengawal saiz melalui nisbah dan resolusi; ia tidak menyediakan medan seed, width atau height yang digunakan dalam profil permintaan FLUX.2. Pemilih versi yang didokumenkan kini menamakan keluaran bergerak, bukannya menetapkan padanan pemberat pembekal bertarikh.

Aliran pengeluar mengembalikan imej selepas pemprosesan tak segerak, bersama prompt dikembangkan. Pautan muat turun imej bertandatangan sah selama satu jam. Simpan imej sebenar, prompt akhir dan rujukan tanpa bergantung pada pautan sementara. Untuk aset yang disemak, bandingkan teks diminta, kedudukan objek, identiti rujukan dan kawasan diubah pada saiz paparan yang dimaksudkan. Penjanaan selesai ialah titik permulaan untuk menyemak keperluan visual tersebut.

Ailoot Ultra · Imej POST /v1/images/generations black-forest-labs/flux-3-image

black-forest-labs/flux-3-image

Black Forest Labs /black-forest-labs/flux-3-image

Pengenalan

FLUX 3 Image mencipta dan menyunting imej daripada arahan bertulis serta sehingga sepuluh rujukan. Ia menambah kotak pembatas berasaskan prompt untuk komposisi dan perubahan setempat, grounding web dan imej, serta lima kelas resolusi.

Input yang diterima
Teks · Imej
Hasil
Imej

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Imej POST /v1/images/generations
Input
text, image
Output
image
MedanJenisKeperluanNilai & hadLalai
MedanmodelJenisstringKeperluanDiperlukanNilai & had
black-forest-labs/flux-3-image
Lalai—
MedanpromptJenisstringKeperluanDiperlukanNilai & had
Panjang minimum: 1
Lalai—
MedanresolutionJenisstringKeperluanPilihanNilai & had
768, 1K, 1.5K, 2K, 4K
Lalai—
Medanaspect_ratioJenisstringKeperluanPilihanNilai & had
21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21, auto
Lalai—
MedannJenisintegerKeperluanPilihanNilai & had
Minimum: 1
Maksimum: 1
Lalai—
Medaninput_referencesJenisarrayKeperluanPilihanNilai & had
Item minimum: 0
Item maksimum: 10
Lalai—
MedanproviderJenisobjectKeperluanPilihanNilai & hadLalai—
Parameter kaedah dan kitar hayat
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt
Parametermaterial_typesKontraktext, 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.

KonfigurasiJadual kadarKuantiti ramalanCaj
KonfigurasiKadar asas tokenJadual kadarKadar asasKuantiti ramalan—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
KonfigurasiAnggaran kos penjanaanJadual kadar—Kuantiti ramalananggaran untuk satu penjanaanCaj
Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.082 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

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-3-image', '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}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Pembacaan kandungan lain
Baca aset sedia ada yang 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 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
MedanJenis
MedancreatedJenis
Medandata[].urlJenis
Medandata[].b64_jsonJenis
MedanusageJenis

Alias

Alias model

Ailoot Ultra black-forest-labs/flux-3-image

Alias laluan kaedah

/v1/images

ID pemanggil berkaitan

black-forest-labs/flux-3-image

FAQ · Black Forest Labs: FLUX.3 Image
Apakah input dan hasil yang tersedia?

POST /v1/images/generations · black-forest-labs/flux-3-image: text, image → image

Apakah medan yang digunakan oleh permintaan?

POST /v1/images/generations · black-forest-labs/flux-3-image: model, prompt, resolution, aspect_ratio, n, input_references, provider

Apakah had yang terpakai?

POST /v1/images/generations · black-forest-labs/flux-3-image: n.minimum: 1; n.maximum: 1

Butiran lanjut

Sambungkan Ailoot kepada Claude Code, OpenCode, Hermes atau aplikasi anda.

Syarikat dan portfolio projeknya

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

Beli token dengan diskaun.

Diskaun langganan untuk penggunaan berkala. Kod promosi — sehingga 50% bagi pembelian token.

Langganan
Pilih pelan berdiskaun untuk permintaan berkala anda.
Kod promosi sehingga 50%
Masukkan kod semasa pembelian. Harga dikira semula mengikut promosi semasa.
Perbelanjaan dalam sejarah
Model, token dan jumlah disimpan bagi setiap permintaan.

Pilih langganan · Lihat harga model

Sambungkan API kepada produk yang anda jual.

SaaS, aplikasi dan bot — di bawah tawaran rasmi serta perjanjian lesen Ailoot. Untuk jualan semula, mohon lesen penjual semula.

Aplikasi komersial
Tambahkan penjanaan teks, imej, video dan audio pada ciri berbayar perkhidmatan anda.
Lesen penjual semula
Hantar keterangan projek dan susunan akses. Minta terma penggunaan serta jualan semula secara bertulis.
Dokumen pada laman
Tawaran, perjanjian lesen dan dasar pemprosesan data tersedia sebelum sambungan.

Mohon lesen penjual semula · Tawaran dan perjanjian lesen