Black Forest Labs
FLUX.2 Klein 9B
flux-2-klein-9b/text-to-image
Modello di image-to-image a flusso rettificato con 9 miliardi di parametri, distillato fino a 4 passaggi, che unifica la generazione testo-immagine e la modifica con uno o più riferimenti in un'architettura compatta, pensato per scenari di generazione in tempo reale a bassa latenza
Prova flux-2-klein-9b/text-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
flux-2-klein-9b/text-to-image per image
| Prezzo unitario | $0.00858 |
|---|
Panoramica e posizionamento
La linea di generazione puramente testo-immagine di FLUX.2 klein 9B, presentata da Black Forest Labs, punta a un equilibrio tra qualità e latenza. Genera immagini direttamente da un prompt testuale, supporta la scelta del rapporto d'aspetto da 1:1 a 16:9 e tre formati di output: jpeg, png e webp; il numero di passaggi di inferenza può essere impostato tra 4 e 8, e con i 4 passaggi predefiniti la generazione è già completata. È adatta alla produzione massiva di contenuti sensibile alla velocità di generazione, all'illustrazione marketing e all'esplorazione visiva in fase di prototipazione; gli sviluppatori possono integrarla tramite l'interfaccia unificata di HiAPI.ai.
Punti di forza principali
- Inferenza con pochi passaggi, per scenari sensibili alla latenza——il design di distillazione dei passaggi consente di completare la generazione in soli 4 passaggi, con parametri regolabili tra 4 e 8 per bilanciare velocità e dettaglio.
- Supporto seed fisso per una generazione riproducibile——fornisce il parametro seed; la stessa combinazione di prompt e seed riproduce i risultati, agevolando i test di regressione e il confronto tra versioni.
- Parametri di output aderenti alla pipeline ingegneristica——il rapporto d'aspetto copre le composizioni comuni 1:1, 4:3, 3:4, 16:9 e 9:16; l'output può essere scelto direttamente tra jpeg, png o webp, evitando transcodifiche aggiuntive.
Descrizione delle capacità
Generazione testo-immagine: basta passare un prompt testuale per ottenere l'immagine corrispondente, senza immagini di riferimento obbligatorie; è sufficiente fornire il prompt, poiché gli altri parametri hanno valori predefiniti, con bassi costi di integrazione.
Controllo dei passaggi di inferenza e del seed: num_inference_steps è regolabile tra 4 e 8 per modificare la finezza della generazione; seed serve a fissare la casualità, adatto a valutazioni e debug che richiedono una riproduzione stabile.
Proporzioni di composizione e formati di output: aspect_ratio copre cinque proporzioni tra verticale, orizzontale e quadrato; output_format supporta jpeg, png e webp, e i risultati generati possono adattarsi direttamente ai posizionamenti di pagina e ai requisiti di archiviazione.
Scenari applicativi
- Produzione massiva di illustrazioni per team di contenuti——generare in massa illustrazioni a partire da descrizioni di prodotti o temi, specificando proporzioni e formato di output per utilizzarle direttamente in articoli, landing page e materiali per i social media.
- Esplorazione di bozze visive per prototipi di prodotto——creare rapidamente più varianti di composizione con brevi prompt, riproducendo gli stili candidati tramite seed fisso per selezionare le direzioni prima della revisione di design.
- Integrazione in applicazioni con generazione in tempo reale o ad alta frequenza——per funzionalità online sensibili alla latenza, generare immagini con i 4 passaggi di inferenza predefiniti, regolando i passaggi secondo necessità per controllare qualità e tempi.
Limiti e suggerimenti per la scelta
Questa linea genera immagini puramente da testo e non accetta immagini di riferimento; per editing o cambi di stile basati su immagini esistenti occorre scegliere la linea immagine-immagine della stessa serie. I passaggi di inferenza supportano solo da 4 a 8, senza regolazione del campionamento prolungato più fine; oltre al prompt non sono disponibili parametri come il negative prompt. La model card pone vincoli sugli usi al di fuori dell'ambito previsto; prima dell'uso commerciale è necessario verificare autonomamente il testo originale della licenza. Se l'attività richiede output in altre modalità come video o audio, questo modello non è adatto.
Domande frequenti
Vedi tutte le domande →-
Quante immagini di riferimento supporta la modifica di immagini di FLUX.2 [klein] 9B?
Attualmente supporta 1 immagine di riferimento JPEG, PNG o WebP. image_urls deve essere un array contenente un solo URL pubblico di immagine.
-
Per quali attività di editing è adatto?
È adatto alla pulizia di immagini di prodotto, alla sostituzione dello sfondo, alla riscrittura del testo nell'immagine, alla modifica della combinazione di colori e al ritocco commerciale che richiede di preservare il soggetto e la posizione della fotocamera.
-
Come si impostano i passi di inferenza?
num_inference_steps accetta un numero intero da 4 a 8, il valore predefinito è 4. Il prezzo attuale non varia in base ai passi di inferenza.
-
Quali formati e proporzioni sono supportati?
Le proporzioni supportate sono 1:1, 4:3, 3:4, 16:9, 9:16; i formati supportati sono JPEG, PNG e WebP.
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-klein-9b/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per flux-2-klein-9b/text-to-image e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionaleSeme casuale, utilizzato per la riproducibilità dei risultati; accetta un numero intero.
promptstringObbligatorioPrompt testuale per la generazione dell'immagine, accetta una stringa.
aspect_ratiostringOpzionalePredefinito: "4:3"Rapporto d'aspetto dell'immagine generata, accetta una stringa. Predefinito 4:3.
1:14:33:416:99:16output_formatstringOpzionalePredefinito: "png"Formato di output dell'immagine generata, accetta una stringa. Predefinito png.
jpegpngwebpnum_inference_stepsintegerOpzionalePredefinito: 4min 4max 8Numero di passi di inferenza, accetta un numero intero tra 4 e 8. Predefinito 4.
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-klein-9b/text-to-image",
"input": {
"prompt": "…",
"aspect_ratio": "4:3",
"output_format": "png",
"num_inference_steps": 4
}
}' 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-klein-9b/text-to-image",
input: {
"prompt": "…",
"aspect_ratio": "4:3",
"output_format": "png",
"num_inference_steps": 4
}
}),
});
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-klein-9b/text-to-image",
"input": {
"prompt": "…",
"aspect_ratio": "4:3",
"output_format": "png",
"num_inference_steps": 4
}
},
)
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 chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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 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
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
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
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
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
-
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
-
Nano Banana Pro Google $0.057 /immagine -
Grok Imagine Image 2.0 xAI $0.052 /immagine -
Seedream 5.0 ByteDance $0.025 /immagine -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Grok Imagine Quality xAI $0.070 /immagine -
Recraft Creative Upscale Recraft $0.357 /immagine -
GPT Image 2.5 OpenAI $0.017 /immagine -
Seedream 4.5 ByteDance $0.045 /immagine -
Grok Imagine xAI $0.011 /secondo -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine
Stesso fornitore
-
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine -
FLUX 3 Video Black Forest Labs $0.090 /secondo -
FLUX.2 Black Forest Labs $0.035 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
FLUX 3 Image Black Forest Labs $0.041 /immagine -
FLUX.1 Fill Pro Black Forest Labs $0.071 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
FLUX.1 Schnell Black Forest Labs $0.005 /immagine -
FLUX 3 Max Black Forest Labs $0.061 /secondo -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /immagine



