Recraft

Recraft V4.1

recraft-v4.1-flash/text-to-image

Modello di generazione di asset di design pensato per la produzione, con output vettoriale SVG nativo e modificabile, in grado di produrre immagini in modo stabile con prompt brevi, ideale per icone, tipografia e illustrazioni di brand

recraft-v4.1-flash/text-to-image recraft-v4.1/text-to-image

Prova recraft-v4.1-flash/text-to-image

Input

Colors

Creazioni

Vedi tutte le creazioni

Output

image

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

recraft-v4.1-flash/text-to-image per image

Prezzo unitario	$0.010

Panoramica della posizione

Recraft V4.1 Flash è la variante rapida della serie Recraft V4.1 orientata alla generazione di immagini da testo: tramite l'interfaccia unificata di HiAPI.ai basta inserire un prompt testuale per ottenere un'immagine. Prosegue l'orientamento progettuale della serie, raggiungendo un elevato livello di finitura su attività di illustrazione, icone e visual di brand, e consente di ottenere risultati visivi piuttosto stabili con prompt brevi. È adatto a sviluppatori e team di design che necessitano di generare immagini in batch e di integrare la fase di generazione nei flussi di automazione dei contenuti.

Punti di forza principali

Orientamento visivo verso gli asset di design — rispetto ai modelli di immagine generici, privilegia output di design utilizzabili in produzione come icone, illustrazioni e visual di brand, anziché limitarsi a semplici anteprime estetiche.
Risultati stabili con prompt brevi — con una descrizione sintetica si ottengono composizione e direzione estetica piuttosto definite, riducendo l'onere di prompt engineering legato a continui aggiustamenti dei parametri.
Controllo opzionale di palette e colore di sfondo — supporta la specifica tramite valori RGB della palette preferita e del colore di sfondo, facilitando la coerenza stilistica dei materiali di una serie tra più immagini.
Preset di dimensioni in più proporzioni — offre sei preset di dimensioni tra quadrato, 4:3 e 16:9 in orizzontale e verticale, coprendo formati comuni come immagini social, poster verticali e banner.

Descrizione delle capacità

Generazione di immagini da testo: inserendo un prompt testuale si genera un'immagine; il prompt può arrivare fino a diecimila caratteri e può descrivere soggetto, stile e dettagli della scena, ed è adatto all'integrazione in flussi automatizzati di generazione immagini.

Controllo di palette e colore di sfondo: tramite un oggetto RGB è possibile specificare la palette preferita e il colore di sfondo, mantenendo i materiali generati in batch coerenti con lo stesso standard visivo.

Preset di dimensioni di output: sono inclusi preset di dimensioni in più formati, sia quadrati sia in proporzione orizzontale e verticale; in fase di chiamata si seleziona direttamente il formato in base al posizionamento, senza necessità di ritaglio successivo.

Scenari applicativi

Generazione in batch di materiali di serie per team di brand e marketing — produzione in batch di immagini per campagne e materiali promozionali con palette e preset di dimensioni uniformi, utilizzabili direttamente per posizionamenti e pianificazione dei contenuti.
Illustrazioni e grafiche di interfaccia nella progettazione UI/UX — generazione di illustrazioni e grafiche decorative per l'interfaccia a partire da brevi descrizioni, da usare come materiali disponibili nei file di design per pagine di prodotto e prototipi.
Fase di illustrazione nelle pipeline di automazione dei contenuti — integrazione delle chiamate di generazione immagini nei sistemi di pubblicazione per creare automaticamente illustrazioni in base a articoli o informazioni di prodotto, riducendo la produzione manuale immagine per immagine.

Limiti e suggerimenti di scelta

La posizione è orientata agli asset di design e all'esplorazione concettuale e non copre tutte le esigenze di generazione di immagini; si consiglia comunque una revisione umana dei risultati, in particolare per palette e composizione, prima della consegna ufficiale. Se serve un output singolo con un livello di finitura più elevato, si può considerare la versione non Flash della stessa serie. Questa variante privilegia la rapidità di generazione e va valutata con cautela per scenari che richiedono dettagli estremi e realismo complesso.

Novità

Vedi il changelog →

Nuovo modello Nuovo modello disponibile: recraft-v4.1-flash/text-to-image Nov 3, 2026
Nuovo modello Aggiunta della documentazione text-to-image per recraft-v4.1-flash/text-to-image Oct 16, 2026

Domande frequenti

Vedi tutte le domande →

Qual è la differenza tra Recraft V4.1 e V4.1 Flash?

V4.1 pone maggiormente l'accento sui dettagli e sulla completezza, mentre Flash è più veloce e adatto alla produzione di bozze in batch.
Quali dimensioni sono supportate?

image_size può essere square_hd (predefinito), square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 tra sei opzioni.
Come si specificano i colori?

Tramite l'API, passando colors (array di oggetti RGB) e background_color (un singolo oggetto RGB), con ogni canale con valore da 0 a 255. Il Playground online al momento non offre questi due parametri.
I parametri di colore vengono sempre rispettati rigorosamente?

colors è una palette di colori preferita e l'immagine cercherà di rientrare in questa serie di colori; se nel prompt sono indicati colori in evidente conflitto, il risultato potrebbe mescolare i due.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il 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-KeystringOpzionale

Chiave 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.

Chiave di idempotenza

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

modelstringObbligatorio

Valore fisso attuale: recraft-v4.1-flash/text-to-image

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per recraft-v4.1-flash/text-to-image e la route default — vedi la tabella dei parametri sotto.

colorsarrayOpzionale

Palette preferita, un array di oggetti colore RGB, con valori dei canali compresi tra 0 e 255 per ciascun oggetto; utilizzata per vincolare i toni principali dell'immagine generata.

Array [ object ]

Elementi dell'array

bintegerObbligatoriomin 0max 255

Valore del canale blu di un singolo colore nella palette, numero intero compreso tra 0 e 255.

gintegerObbligatoriomin 0max 255

Valore del canale verde di un singolo colore nella palette, numero intero compreso tra 0 e 255.

rintegerObbligatoriomin 0max 255

Valore del canale rosso di un singolo colore nella palette, numero intero compreso tra 0 e 255.

promptstringObbligatoriominLength 1maxLength 10000

Descrizione testuale dell'immagine da generare, ovvero il prompt.

image_sizestringOpzionalePredefinito: "square_hd"

Preset della dimensione di output, espresso come nome di preset in formato stringa, predefinito square_hd.

Opzioni:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

background_colorobjectOpzionale

Colore di sfondo preferito, rappresentato da un oggetto colore RGB, con valori dei canali compresi tra 0 e 255.

bintegerObbligatoriomin 0max 255

Valore del canale blu del colore di sfondo, numero intero compreso tra 0 e 255.

gintegerObbligatoriomin 0max 255

Valore del canale verde del colore di sfondo, numero intero compreso tra 0 e 255.

rintegerObbligatoriomin 0max 255

Valore del canale rosso del colore di sfondo, numero intero compreso tra 0 e 255.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

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.

urlstringObbligatorio

Obbligatoria 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.

Opzioni:final

storagestringOpzionalePredefinito: "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.

Opzioni:temppersistent

Esempi 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": "recraft-v4.1-flash/text-to-image",
  "input": {
    "prompt": "…",
    "image_size": "square_hd"
  }
}'

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: "recraft-v4.1-flash/text-to-image",
    input: {
      "prompt": "…",
      "image_size": "square_hd"
    }
  }),
});
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": "recraft-v4.1-flash/text-to-image",
        "input": {
          "prompt": "…",
          "image_size": "square_hd"
        }
    },
)
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à

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome 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.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

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.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi 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

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione 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"
    }
  }
}