Black Forest Labs
FLUX.2
flux-2/text-to-image
La famiglia di generazione e modifica di immagini di Black Forest Labs, che supporta il trasferimento di stile basato su immagini di riferimento e la fusione di più immagini di riferimento, preservando il più possibile la composizione originale e la posizione del soggetto durante la modifica
Prova flux-2/text-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
flux-2/text-to-image per image
| Specifiche | Prezzo unitario |
|---|---|
| 0.5 MP | $0.0375 |
| 1 MP | $0.050 |
| 2 MP | $0.075 |
| 4 MP | $0.125 |
Panoramica della posizione
FLUX.2 text-to-image è la linea di generazione puramente testuale del modello di generazione di immagini lanciato da Black Forest Labs, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Riceve un prompt testuale, produce immagini in stile realistico e offre il controllo dei parametri relativi a risoluzione, rapporto d'aspetto, formato e qualità di output, seed casuale e altro ancora; è adatto a scenari di esplorazione di concetti creativi e produzione visiva in batch che richiedono output stabili e riproducibili.
Punti salienti
- Risoluzione e formato configurabili su richiesta — supporta risoluzioni di output da 0,5 a 4 MP e vari rapporti d'aspetto comuni, oltre a larghezza e altezza personalizzabili, per scegliere nitidezza e composizione in base all'uso.
- Generazione riproducibile con seed casuale — impostando il seed è possibile ripetere lo stesso risultato, utile per confronti di parametri e regressioni di versione sulla stessa composizione.
- Parametri di consegna dell'output controllabili — è possibile scegliere i formati webp, jpg, png e regolare la qualità di compressione, producendo direttamente file immagine pronti per la distribuzione.
- Tolleranza di sicurezza regolabile — safety_tolerance offre un intervallo da 1 a 5, consentendo di adattare il rigore del filtro in base ai requisiti di conformità aziendale.
Descrizione delle capacità
Generazione di immagini realistiche da testo: basta inserire un prompt testuale per generare immagini; le fonti ufficiali e di terze parti la collocano principalmente nello stile realistico, utilizzabile per visual di concetto e produzione di materiali.
Controllo di formato e risoluzione: tramite aspect_ratio si sceglie un rapporto predefinito oppure larghezza e altezza personalizzate; abbinato al parametro di risoluzione da 0,5 a 4 MP, si adatta a composizioni orizzontali e verticali e alle esigenze dei diversi spazi di visualizzazione.
Regolazione di formato e qualità di output: supporta tre formati di output webp, jpg e png ed è possibile impostare una qualità di salvataggio da 0 a 100, bilanciando dimensione del file e qualità d'immagine in base allo scopo del prodotto.
Generazione riproducibile: specificando il seed, la stessa combinazione di prompt e parametri produce risultati coerenti, facilitando l'individuazione dell'origine delle variazioni durante le iterazioni.
Regolazione del filtro di sicurezza: il parametro safety_tolerance offre cinque livelli, dal più rigoroso al più permissivo, impostabili secondo i criteri di conformità dello scenario di pubblicazione.
Scenari applicabili
- Bozze di concetto per team creativi — con brevi prompt si producono rapidamente più versioni di bozze visive, da usare per la selezione di direzione e la revisione interna, prima di decidere cosa approfondire.
- Esplorazione della composizione per design e pubblicità — combinando rapporto d'aspetto e parametri di risoluzione si generano immagini in formato orizzontale e verticale, utilizzabili direttamente per bozze di proposta e prove di impaginazione.
- Processi di produzione di materiali in batch — tramite seed fissi e parametri di formato di output, si generano in batch asset immagine dalle specifiche uniformi all'interno di flussi automatizzati.
- Riferimenti visivi in stile realistico — si generano scene realistiche o immagini d'atmosfera di prodotto come materiale di riferimento prima di fotografia, allestimenti o rendering.
Limiti e consigli di selezione
Questa linea accetta solo prompt testuali e non elabora immagini di riferimento; quando è necessario modificare o trasferire lo stile di un'immagine esistente, occorre passare alla linea image-to-image della stessa famiglia. La risoluzione arriva a 4 MP, ma la documentazione dei parametri consiglia 2 MP o meno; per output di dimensioni molto grandi occorre valutare autonomamente il guadagno in qualità. Il filtro di sicurezza agisce per livelli e quelli più rigorosi possono influire sulla visibilità dei contenuti generati. I requisiti di licenza non commerciale e di distribuzione hardware menzionati nei materiali di ricerca dipendono dal canale effettivo con cui l'utente ottiene il modello; chiamando tramite HiAPI.ai è possibile ignorare questi vincoli di self-hosting.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello: flux-2-klein-4b/text-to-image, text-to-image conveniente con supporto per livelli da 0.25-4 MP; con…
- Nuovo modello Nuovo modello di editing immagini: flux-2-klein-4b/image-to-image supporta una singola immagine di riferimento e output a fasce da 0,25-4 MP…
Domande frequenti
Vedi tutte le domande →-
Quante immagini di riferimento supporta la modifica di immagini con FLUX.2?
Supporta da 1 a 8 immagini di riferimento in formato JPEG, PNG o WebP, ciascuna non superiore a 10MB. In caso di composizione con più immagini, nel Prompt è necessario indicare in ordine il ruolo di ciascuna immagine.
-
A cosa serve il formato auto?
auto segue le proporzioni della prima immagine di riferimento; quando è necessario un output fisso orizzontale, verticale o quadrato, si può scegliere un formato esplicito.
-
Come vengono fatturati 1K e 2K?
1K e 2K utilizzano fasce di prezzo diverse per singola immagine; il numero di immagini di riferimento non comporta costi aggiuntivi. Gli importi specifici si basano sul prezzo in tempo reale indicato in questa pagina.
-
Come ridurre la deriva del soggetto e del logo?
Indica esplicitamente lo scopo di ogni immagine di riferimento ed elenca contemporaneamente il soggetto, il testo, i materiali, la posizione e l'illuminazione che devono essere modificati e quelli che devono essere preservati.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: flux-2/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per flux-2/text-to-image e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale, utilizzato per riprodurre i risultati di generazione; impostando lo stesso seme si ottengono output di generazione ripetibili.
widthintegerOpzionalemin 256max 2048Larghezza personalizzata dell'immagine, ha effetto solo quando aspect_ratio è custom; viene automaticamente arrotondata al multiplo di 16 più vicino.
heightintegerOpzionalemin 256max 2048Altezza personalizzata dell'immagine, ha effetto solo quando aspect_ratio è custom; viene automaticamente arrotondata al multiplo di 16 più vicino.
promptstringObbligatorioPrompt testuale per la generazione dell'immagine, che descrive il contenuto visivo desiderato.
resolutionstringOpzionalePredefinito: "1 MP"Risoluzione in megapixel (MP) dell'immagine di output, supporta fino a 4 MP, si consiglia di usare 2 MP o inferiore. Predefinito 1 MP.
0.5 MP1 MP2 MP4 MPaspect_ratiostringOpzionalePredefinito: "1:1"Rapporto d'aspetto dell'immagine generata. Predefinito 1:1.
1:116:93:22:34:55:49:163:4Mostra tutto (2)
4:3customoutput_formatstringOpzionalePredefinito: "webp"Formato di salvataggio dell'immagine di output. Predefinito webp.
webpjpgpngoutput_qualityintegerOpzionalePredefinito: 80min 0max 100Qualità di salvataggio dell'immagine di output, con valori da 0 a 100; non ha effetto sul formato png. Predefinito 80.
safety_toleranceintegerOpzionalePredefinito: 2min 1max 5Tolleranza di sicurezza, 1 è il più severo, 5 il più permissivo. Predefinito 2.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-2/text-to-image",
input: {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-2/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
FLUX.1 Fill Pro Black Forest Labs $0.071 /immagine -
Ideogram V4.5 Ideogram $0.011 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
Recraft V4.1 Recraft $0.010 /immagine -
FLUX 3 Image Black Forest Labs $0.041 /immagine -
BRIA Eraser Bria $0.058 /immagine -
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine -
GPT Image 2 OpenAI $0.007 /immagine -
Grok Imagine xAI $0.011 /secondo -
Seedream 5.0 ByteDance $0.025 /immagine -
Ideogram V4 Ideogram $0.050 /immagine -
FLUX.2 Black Forest Labs $0.035 /immagine
Stesso fornitore
-
FLUX 3 Video Black Forest Labs $0.090 /secondo -
FLUX.2 Black Forest Labs $0.035 /immagine -
FLUX 3 Image Black Forest Labs $0.041 /immagine -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
FLUX.1 Fill Pro Black Forest Labs $0.071 /immagine -
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine



