Krea
Krea 3
krea-3/text-to-image
Supporta la generazione da testo e la modifica tramite immagini di riferimento, output nativo in 2K, circa 8 secondi per singola modifica, ideale per iterazioni visive ad alta frequenza e riutilizzo dei materiali
Prova krea-3/text-to-image
Input
Creazioni
Vedi tutte le creazioniOutput
imagePrezzi
krea-3/text-to-image per image
| Prezzo unitario | $0.036 |
|---|
Panoramica del modello
krea-3/text-to-image è la linea di modelli Krea dedicata alla generazione di immagini da testo, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Accetta prompt testuali per generare immagini e offre numerosi preset di dimensioni tra cui quadrato, verticale e orizzontale, con output in PNG o JPEG. La linea supporta due varianti, berry e jam: la prima privilegia la qualità, la seconda la velocità; è inoltre possibile impostare l'intensità di ragionamento, il prompt negativo e un seed casuale fisso per riprodurre lo stesso risultato. È indicata per team di sviluppo che devono bilanciare qualità e velocità di generazione in base al progetto e integrare la generazione in batch nei propri flussi di lavoro.
Punti chiave
- Qualità e velocità selezionabili per livello — variant offre le opzioni berry e jam: la prima privilegia la qualità, la seconda la velocità, ed è possibile passare dall'una all'altra in base al compito.
- Intensità di ragionamento regolabile — reasoning_level accetta low o medium e controlla il grado di ragionamento ed espansione del prompt prima della generazione; medium richiede più tempo.
- Dimensioni e formato di output controllabili — sei preset integrati: quadrato, verticale 4:3/16:9 e orizzontale 4:3/16:9, fino a 1024×1024, con output in PNG o JPEG.
- Riproducibilità tramite seed fisso — passando seed è possibile riprodurre lo stesso risultato con lo stesso input, utile per il debug dei prompt e per confronti tra versioni.
Capacità
Generazione di immagini da prompt testuale: una descrizione testuale è l'unico input obbligatorio e restituisce una singola immagine; il prompt può raggiungere 5000 caratteri, sufficienti per descrivere in modo completo soggetto, stile e composizione.
Esclusione di elementi tramite prompt negativo: con negative_prompt (fino a 1024 caratteri) si specifica ciò che non deve comparire nell'immagine, aggiungendo una dimensione al controllo della composizione.
Sei preset di dimensioni e scelta del formato: si sceglie il preset quadrato, verticale o orizzontale in base al canale di destinazione e si ottiene direttamente PNG o JPEG, riducendo le conversioni successive.
Riproducibilità parametrica dei risultati: fissando parametri come seed e reasoning_level, lo stesso input produce stabilmente lo stesso output, ideale per creare baseline di generazione ripetibili.
Casi d'uso
- Generazione in batch di immagini per team di contenuti — si sceglie il preset in base alle dimensioni della sezione e una chiamata produce un'immagine, per immagini di intestazione degli articoli, visual per i social e altri contesti che richiedono output stabili.
- Ottimizzazione dei prompt per designer e sviluppatori — con un seed fisso si modificano uno alla volta prompt e prompt negativo confrontando le differenze di output, per consolidare template di prompt riutilizzabili.
- Produzione con la stessa base per materiali verticali e orizzontali — con la stessa descrizione si passa dai preset portrait a quelli landscape ottenendo materiali dello stesso stile adatti a mobile e web.
- Validazione di prototipi sensibile alla velocità di generazione — scegliendo la variante jam e abbassando l'intensità di ragionamento si ottengono rapidamente più direzioni nelle fasi iniziali, per poi produrre la versione rifinita con berry.
Limiti e consigli di scelta
Supporta solo la generazione da prompt testuale: non accetta immagini di riferimento né esegue modifiche locali; per image-to-image o modifiche areali occorre scegliere modelli con le capacità corrispondenti. Il limite di output è 1024×1024, quindi i prodotti ad alta risoluzione richiedono un successivo upscaling. negative_prompt è efficace solo con la variante berry e non ha effetto scegliendo jam. Ogni chiamata restituisce un'immagine, quindi per più proposte servono più richieste. Se il compito richiede la riproduzione rigorosa di un personaggio o dell'aspetto di un prodotto esistenti, la sola descrizione testuale difficilmente garantisce coerenza.
Domande frequenti
Vedi tutte le domande →-
A cosa serve Krea 3?
È adatto per fotografia realistica, ritratti, immagini di prodotto, cibo, spazi architettonici, illustrazioni e concept design; può anche generare poster con testo in titolo. Anche con prompt brevi si ottengono immagini complete, ideale per esplorare rapidamente diverse direzioni.
-
Qual è la differenza tra berry e jam?
Sono due varianti dello stesso modello, con la maggior parte dei parametri identici (negative_prompt ha effetto solo su berry): Krea posiziona berry come orientata alla qualità e jam come orientata alla velocità, entrambe allo stesso prezzo. Si passa da una all'altra tramite input.variant, con berry come predefinita. Nei confronti pratici, con lo stesso seed le due varianti producono composizioni e tonalità diverse ma una qualità dell'immagine equivalente; conviene provarle entrambe una volta e poi scegliere.
-
Che cos'è reasoning_level? Quale scegliere?
Controlla quanto impegno il modello dedica a comprendere ed espandere il prompt prima di generare l'immagine; le opzioni sono low e medium (predefinito). Usa medium quando il prompt è molto breve o astratto; usa low quando il prompt è già molto specifico e vuoi maggiore rapidità.
-
Quali dimensioni sono supportate?
image_size supporta 6 opzioni: square_hd (1024 × 1024, predefinita), square (512 × 512), portrait_4_3 (768 × 1024), portrait_16_9 (576 × 1024), landscape_4_3 (1024 × 768), landscape_16_9 (1024 × 576).
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: krea-3/text-to-image
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per krea-3/text-to-image e la route default — vedi la tabella dei parametri sotto.
seedintegerOpzionalemin 0max 2147483647Seme casuale fisso, utilizzato per riprodurre lo stesso risultato di generazione; assumere un valore intero, se non fornito viene deciso casualmente dal server.
promptstringObbligatoriominLength 1maxLength 5000Descrizione testuale dell'immagine da generare, utilizzata come prompt di input per il contenuto generato.
variantstringOpzionalePredefinito: "berry"Livello di variante di generazione, berry privilegia la qualità, jam privilegia la velocità; predefinito berry.
berryjamimage_sizestringOpzionalePredefinito: "square_hd"Preset delle dimensioni di output, supporta fino a 1024×1024; predefinito square_hd.
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9output_formatstringOpzionalePredefinito: "png"Formato dell'immagine di output; predefinito png.
pngjpegnegative_promptstringOpzionalemaxLength 1024Specifica il contenuto da escludere dall'immagine, ha effetto solo con la variante berry.
reasoning_levelstringOpzionalePredefinito: "medium"Controlla il grado di ragionamento ed espansione del prompt prima della generazione, valori più alti indicano un'elaborazione più approfondita, medium è relativamente più lento; predefinito medium.
lowmediumcallbackobjectOpzionale
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": "krea-3/text-to-image",
"input": {
"prompt": "…",
"variant": "berry",
"image_size": "square_hd",
"output_format": "png",
"reasoning_level": "medium"
}
}' 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: "krea-3/text-to-image",
input: {
"prompt": "…",
"variant": "berry",
"image_size": "square_hd",
"output_format": "png",
"reasoning_level": "medium"
}
}),
});
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": "krea-3/text-to-image",
"input": {
"prompt": "…",
"variant": "berry",
"image_size": "square_hd",
"output_format": "png",
"reasoning_level": "medium"
}
},
)
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 kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
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
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
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
-
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 hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Z-Image Alibaba $0.008 /immagine -
BRIA Eraser Bria $0.058 /immagine -
FLUX.1 Kontext Max Black Forest Labs $0.071 /immagine -
Grok Imagine Image 2.0 xAI $0.052 /immagine -
Wan 2.7 Image Alibaba $0.035 /immagine -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /immagine -
FLUX 1.1 Pro Black Forest Labs $0.050 /immagine -
FLUX.1 Fill Pro Black Forest Labs $0.071 /immagine -
Seedream 4.5 ByteDance $0.045 /immagine -
Nano Banana 2 Google $0.036 /immagine -
Qwen Image 2.1 Alibaba $0.020 /immagine -
Grok Imagine xAI $0.011 /secondo



