Introduzione
Cosa fa questo endpoint
Chiama Recraft 20B in modalità SVG e restituisce un file vettoriale.
Parametri importanti
prompt indica il soggetto. style sceglie uno dei 21 stili (predefinito: vector_illustration). aspect_ratio può essere 1:1, 16:9, 9:16, 4:3 o 3:4.
Cosa ricevi
Un file .svg (MIME image/svg+xml).
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Immagine |
| Stili | 21 (10 per icone, 11 per illustrazioni) |
| Proporzioni dell’immagine | 1:1, 16:9, 9:16, 4:3, 3:4 |
Caratteristiche principali
Un modello, due stili di icone
A sinistra: una tazza di caffè in icon/colored_outline, con 14 tracciati, contorno marrone e riempimenti tenui. A destra: un’icona di viaggio con montagna e sole in icon/outline, composta da 13 tracciati di sole linee. Mantieni un unico stile per ottenere icone coerenti in tutto il set.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Un solo soggetto risulta più chiaro, soprattutto per le icone: una tazza di caffè fumante o una montagna con il sole nascente. Se vuoi colori specifici, indicali a parole. almeno 1 caratteri · al massimo 1000 caratteri |
style | No | Dieci stili per le icone (outline, |
aspect_ratio | No | 1:1 (predefinito) per le icone; 16:9, 9:16, 4:3 o 3:4 per banner e scene. Imposta la forma dell’area di disegno SVG senza costi aggiuntivi. |
Prezzi
$0.053 / SVG
Ogni icona o illustrazione consegnata viene addebitata a una tariffa fissa, qualunque sia lo stile o la proporzione scelta. Se la generazione non riesce, non viene addebitato nulla.
Casi d’uso
Set di icone per app e siti web
Genera icone per menu, funzioni e stati vuoti con un unico stile, poi adattane i colori alla tua interfaccia.
Grafiche rapide per blog e social
Crea in pochi secondi una piccola illustrazione cartoon o kawaii per un post o una newsletter.
Progetti creativi e di stampa
Usa stili al tratto, a incisione o linoleografia per adesivi, timbri, macchine da taglio e biglietti stampati.
Consigli avanzati
Scegli uno stile
Scegli uno stile icon/* per le icone dell’interfaccia o vector_illustration/* per le scene; il valore predefinito è
vector_illustration.Descrivi un solo soggetto
Le icone riescono meglio con un solo oggetto, come una tazza di caffè fumante o una montagna con il sole nascente.
Scarica l’SVG
Controlla periodicamente lo stato dell’attività, scarica il file .svg e inseriscilo nel tuo strumento di progettazione o nel codice.
Introduzione
Recraft 20B SVG genera icone e illustrazioni vettoriali in modo rapido ed economico. Invece di descrivere uno stile a parole, lo scegli da un elenco di 21 stili predefiniti.
Funzioni e vantaggi principali
21 stili predefiniti
Gli stili per le icone includono outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient e uneven_fill. Gli stili per le illustrazioni includono cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut e seamless.
Risultati rapidi
Le nostre generazioni hanno richiesto circa 11 secondi ciascuna, rendendo pratico creare icone in serie.
File leggeri
Le icone generate pesavano 20–25 KB.
Casi d’uso
Librerie di icone per prodotti
Genera un set coerente per navigazione, impostazioni ed elenchi di funzioni.
Illustrazioni per contenuti
Aggiungi un’immagine cartoon o kawaii a un articolo, una newsletter o una diapositiva.
Adesivi e timbri
Usa linoleografia, incisione o disegno al tratto per la stampa e le macchine da taglio.
Guida ai prompt e consigli pratici
Un oggetto per icona
I prompt brevi, come una montagna con il sole nascente, producono icone più pulite rispetto a lunghe descrizioni di scene.
Mantieni lo stesso stile nel set
Usa lo stesso valore di style per ogni icona del set.
Evita il testo nelle icone
Il modello fatica con le scritte: aggiungi le etichette nel tuo strumento di progettazione.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
