Black Forest Labs: FLUX.3 Image
FLUX 3 Image crea e modifica immagini da un brief scritto e fino a dieci riferimenti. Aggiunge riquadri delimitatori basati sul prompt per composizione e modifiche locali, grounding tramite web e immagini e cinque classi di risoluzione.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
FLUX 3 Image è il modello di generazione e modifica immagini di Black Forest Labs con controllo esplicito della composizione. Una descrizione testuale può creare una nuova scena; le immagini fornite possono stabilire un soggetto, una scena da rivedere o vari elementi da combinare. I riquadri delimitatori permettono al brief di specificare dove va collocato ogni elemento e quali parti di un’immagine esistente devono cambiare. Il risultato è un’immagine, con scena, testo e layout richiesti da ispezionare.
Crea una scena o dai un’istruzione di modifica
Per una nuova immagine, descrivi soggetto, azione o posa, ambientazione, luce e inquadratura. Metti fra virgolette il testo esatto nell’immagine e indica dove compare. Un brief originale di prodotto potrebbe mostrare una tazza rossa da campeggio su una superficie di pietra chiara, con un grande titolo sopra e luce mattutina morbida che ne rivela il manico. Definisci la relazione fra titolo, prodotto e sfondo anziché proporre parole stilistiche scollegate.
Per la modifica, identifica l’oggetto preciso e il cambiamento: ricolora la tazza, sostituisci un’etichetta, sposta una figura o cambia lo stile della scena. Una singola modifica non richiede un riquadro disegnato manualmente. Il flusso documentato amplia l’istruzione prima della generazione e può localizzare l’elemento nominato e aggiungere automaticamente un riquadro. Il prompt ampliato restituito registra tale interpretazione, utile quando un’istruzione seleziona l’oggetto sbagliato o introduce un dettaglio indesiderato.
Combina e prepara immagini di riferimento
Il profilo esatto del produttore accetta da uno a dieci riferimenti, forniti come URL di immagini o dati immagine codificati. Ciascuno deve essere di almeno 256×256 pixel e non superare 16 megapixel. Nomina un riferimento per posizione o contenuto visibile, poi spiegane il ruolo: la persona di Image 1, la giacca di Image 2 e la stanza di Image 3. Un’immagine di riferimento è una fonte di informazioni visive, non un’istruzione per copiare ogni dettaglio estraneo che contiene.
L’impostazione del rapporto d’aspetto è auto per impostazione predefinita. Nella specifica di richiesta, un rapporto richiesto nel prompt ha priorità; altrimenti il primo riferimento stabilisce l’inquadratura, con output quadrato come ripiego quando né un riferimento né un formato richiesto la forniscono. Per una composizione, metti per primo il riferimento della scena desiderata o scegli esplicitamente il rapporto. Conserva immagini sorgente e ordine con il risultato, così una revisione successiva usa lo stesso punto di partenza visivo.
Colloca elementi con riquadri delimitatori
Un prompt di layout combina una didascalia con un array JSON di righe degli elementi. La didascalia nomina un elemento tramite un marcatore come <cup_1>; la riga contiene id, bbox e desc. Le coordinate sono interi da 0 a 1000 nell’ordine [top, left, bottom, right], misurate dall’angolo superiore sinistro. Per esempio, [0, 0, 500, 500] descrive il quarto superiore sinistro indipendentemente dalle dimensioni in pixel dell’immagine. Usa il rapporto d’aspetto per cui il layout è stato progettato, perché quella griglia di coordinate si estende con l’inquadratura.
Una riga di modifica usa invece from, src_bbox e tgt_bbox insieme a identificatore e descrizione. ref_image_0 significa la prima immagine fornita. Riquadri sorgente e destinazione corrispondenti ancorano un elemento; riquadri diversi lo spostano o ridimensionano. Una nuova riga senza sorgente genera la propria descrizione nella posizione di destinazione, consentendo aggiunte, sostituzioni o ricolorazioni. Una riga sorgente senza destinazione rimuove l’elemento. Indica aggiunte e rimozioni sia nell’istruzione scritta sia nelle righe e conserva righe di ancoraggio per i dettagli che devono restare al loro posto.
Assegna alle scritte un proprio riquadro e citane il testo esatto in desc. I riquadri guidano posizione e scala; non sono maschere di ritaglio, quindi un elemento può estendersi oltre il rettangolo. Il produttore riferisce che nuovi oggetti in riquadri di circa 40×25 pixel spesso non apparivano nei suoi esempi. Lascia spazio visibile sufficiente e ispeziona i confini modificati. I pixel fuori dalla destinazione solitamente restano stabili, ma ombre, riflessi e illuminazione vicina possono comunque cambiare.
Grounding, classi di output e registri utili
Il profilo documentato attiva il grounding per impostazione predefinita, permettendo a ricerche web e immagini di informare la generazione. Può essere disattivato per un brief che deve usare solo descrizione e riferimenti forniti. Per un soggetto reale, identifica chiaramente luogo, evento o oggetto e mantieni separato il contenuto fattuale dal trattamento artistico. Le immagini informate dalla ricerca richiedono comunque un confronto con materiale autorevole quando un’etichetta, un oggetto o un evento rappresentato devono essere accurati.
Le cinque classi di risoluzione sono 768sq, 1k, 1.5k, 2k e 4k, con 1k predefinita. Rappresentano fasce di uguale area in pixel, quindi larghezza e altezza esatte dipendono dal rapporto selezionato. Quindici rapporti fissi vanno da 21:9, attraverso formati quadrati e verticali, a 9:21. Il profilo di questo modello controlla le dimensioni tramite rapporto e risoluzione; non espone i campi seed, width o height usati nei profili di richiesta FLUX.2. Il selettore di versione documentato nomina attualmente una release in evoluzione anziché stabilire una corrispondenza datata con i pesi del fornitore.
Il flusso del produttore restituisce un’immagine dopo l’elaborazione asincrona, insieme al prompt ampliato. Il link firmato per scaricare l’immagine è valido un’ora. Conserva immagine effettiva, prompt finale e riferimenti invece di affidarti a un link temporaneo. Per una risorsa verificata, confronta testo richiesto, collocazione degli oggetti, identità dei riferimenti e zona modificata alle dimensioni di visualizzazione previste. Una generazione completata è il punto di partenza per verificare tali requisiti visivi.
Ailoot Ultra · Immagini POST /v1/images/generations black-forest-labs/flux-3-image
black-forest-labs/flux-3-image
black-forest-labs/flux-3-imageIntroduzione
FLUX 3 Image crea e modifica immagini da un brief scritto e fino a dieci riferimenti. Aggiunge riquadri delimitatori basati sul prompt per composizione e modifiche locali, grounding tramite web e immagini e cinque classi di risoluzione.
- Input accettati
- Testo · Immagini
- Risultati
- Immagini
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Immagini POST /v1/images/generations
- Tipi di input
text,image- Tipi di output
image
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti black-forest-labs/flux-3-image | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 768, 1K, 1.5K, 2K, 4K | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 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 | Predefinito— |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 1 | Predefinito— |
Campoinput_references | Tipoarray | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 10 | Predefinito— |
Campoprovider | Tipoobject | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametromaterial_types | Contrattotext, image |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.082 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
Ailoot Ultra · Immagini
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
Ricevi e salva i risultati
Ailoot Ultra · Immagini
Scarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Altre letture di contenuto
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.
Conserva tutti i risultati completati
Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.
Conserva la risposta completa e gli header, ogni output effettivo, gli identificatori originali restituiti e tutti i campi di utilizzo. Recupera l'operazione originale senza inviare nuovamente la richiesta di creazione.
Se occorre verificare la risposta originale
Conserva l'X-Client-Request-ID restituito per la riconciliazione. Leggi solo i valori task_id/asset_id effettivamente restituiti o la tua libreria multimediale; non costruire mai un URL del task a partire dall'ID dell'operazione e non reinviare mai la richiesta di creazione.
Campi della risposta
| Campo | Tipo |
|---|---|
Campocreated | Tipo |
Campodata[].url | Tipo |
Campodata[].b64_json | Tipo |
Campousage | Tipo |
Alias
Alias del modello
Ailoot Ultra black-forest-labs/flux-3-image
Alias dei percorsi dei metodi
/v1/images
ID di chiamata correlati
FAQ · Black Forest Labs: FLUX.3 Image
- Quali input e risultati sono disponibili?
POST /v1/images/generations·black-forest-labs/flux-3-image:text,image→image- Quali campi usa la richiesta?
POST /v1/images/generations·black-forest-labs/flux-3-image:model,prompt,resolution,aspect_ratio,n,input_references,provider- Quali limiti si applicano?
POST /v1/images/generations·black-forest-labs/flux-3-image:n.minimum:1;n.maximum:1