Guida all'API di FLUX 3 Image Klein: prezzi per cinque livelli di risoluzione, parametri ed esempi di chiamata

Cos'è FLUX 3 Image Klein

FLUX 3 Image Klein è il modello di immagine leggero della serie FLUX 3 di Black Forest Labs. Su HiAPI esiste un solo model ID: flux-3-image-klein, utilizzato sia per la generazione di immagini da testo sia per la modifica con immagini di riferimento. Basta scrivere il prompt per la generazione testo-immagine; aggiungendo image_urls si modifica il quadro in base alle immagini di riferimento oppure si fondono gli stili di più immagini.

I suoi punti di forza sono il costo contenuto e l'ampia scelta di livelli: cinque risoluzioni da 768 a 4K, ideali per la generazione in batch e per il flusso di lavoro che prevede bozze a bassa risoluzione e rifinitura finale ad alta risoluzione.

Prezzi: in base al livello di risoluzione, fatturati per immagine

• 768: $0.0092 / immagine
• 1K (predefinito): $0.0103 / immagine
• 1.5K: $0.0126 / immagine
• 2K: $0.016 / immagine
• 4K: $0.0412 / immagine

Le immagini di riferimento non hanno costi aggiuntivi: 1 o 10 immagini hanno lo stesso prezzo. Ridurre steps non riduce il costo; il prezzo dipende solo da resolution. Le attività non riuscite vengono rimborsate integralmente.

Ad esempio: provare 50 bozze di stile a 768 costa $0.46; sceglierne 5 e produrre le versioni definitive a 4K costa $0.206.

Parametri

Tutti i parametri tranne model e prompt sono opzionali:

• prompt: obbligatorio, da 1 a 5000 caratteri.
• resolution: 768, 1K, 1.5K, 2K, 4K; predefinito 1K.
• aspect_ratio: 16 valori disponibili, tra cui 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 e auto (predefinito).
• image_urls: da 1 a 10 immagini di riferimento accessibili pubblicamente; se omesso, è pura generazione testo-immagine.
• steps: da 1 a 16, predefinito 16. Meno passaggi significano immagini più rapide, ma possibilmente con meno dettagli.
• seed: da 0 a 4294967295. Fissando il seed, con gli stessi parametri si cerca di riprodurre risultati simili; se omesso, è casuale.
• safety_tolerance: da 0 a 4, predefinito 2. Più alto è il valore, più permissiva è la moderazione.
• output_format: jpeg (predefinito) o png.

Esempi di richiesta

Le attività di immagine sono asincrone: prima si crea l'attività, poi si esegue il polling del risultato. model va al livello superiore, gli altri parametri vanno in input.

Generazione testo-immagine, 2K, verticale 4:5, seed fisso:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "一只陶瓷咖啡杯放在晨光照亮的木桌上，浅景深，暖色调，产品摄影",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

Questa immagine costa $0.016.

Modifica con immagini di riferimento, fusione dello stile di due immagini:

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "保留第一张图里的建筑结构，用第二张图的水彩笔触和配色重新绘制",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

Dopo la creazione, usa l'ID attività restituito per eseguire il polling con GET https://api.hiapi.ai/v1/tasks/{taskId}; al successo, recupera l'URL dell'immagine dall'output.

Consigli d'uso

• Prima piccola, poi grande: prova il prompt a 768 o 1K con un seed fisso; una volta soddisfatto, cambia solo resolution in 2K o 4K e genera di nuovo.
• Varianti in batch: con lo stesso prompt, cambia il seed per ottenere una serie di candidati con composizioni diverse e stile coerente.
• Nella modifica, specifica cosa conservare: con immagini di riferimento, indica nel prompt cosa mantenere e cosa cambiare; è più stabile che descrivere solo l'immagine finale desiderata.

Limitazioni attuali

• Ogni chiamata restituisce un'immagine.
• Massimo 10 immagini di riferimento, che devono essere indirizzi http(s) pubblici.
• Non c'è l'opzione per lo sfondo trasparente; png è solo un formato senza perdita alternativo.