Introduzione
Cosa fa questo endpoint
Invia un prompt a Recraft V4 e restituisce un SVG nativo.
Input importanti
prompt (fino a 10,000 caratteri) descrive il design. aspect_ratio sceglie una delle sette forme della tavola; il valore predefinito è 1:1.
Cosa ricevi
Un file .svg (MIME image/svg+xml) composto da tracciati.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Immagine |
| Lunghezza del prompt | Fino a 10,000 caratteri |
| Proporzioni | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
Caratteristiche principali
Una volpe e un distintivo di panetteria, entrambi modificabili
A sinistra: un simbolo di volpe a due colori composto da 18 forme. A destra: un distintivo di panetteria in stile vintage con il nome Rise & Crumb incorniciato da spighe di grano, composto da 124 forme color crema e marrone. Entrambi si sono aperti in un editor vettoriale con ogni elemento selezionabile.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Indica soggetto, formato (simbolo di logo, distintivo, illustrazione piatta), palette e qualsiasi scritta del logo tra virgolette. almeno 1 caratteri · al massimo 10000 caratteri |
aspect_ratio | No | 1:1 (predefinito), 4:3, 3:4, 3:2, 2:3, 16:9 o 9:16. Imposta le proporzioni della tavola dell’SVG; il rapporto non cambia il prezzo. |
Prezzi
$0.096 / SVG
Un prezzo fisso per ogni SVG consegnato, indipendentemente dalle proporzioni della tavola. Le richieste non riuscite e i risultati vuoti non hanno costi.
Casi d’uso
Esplorazione di loghi
Genera diversi simboli per un nuovo prodotto o negozio, poi rifinisci il migliore in un editor vettoriale.
Illustrazioni editoriali piatte
Crea illustrazioni di accompagnamento per blog, pagine di destinazione e presentazioni, nitide su qualsiasi schermo.
Grafiche pronte per la stampa
Crea distintivi, etichette e grafiche per confezioni come vettori che la tipografia può ingrandire senza perdita di qualità.
Consigli avanzati
Scrivi il brief
Descrivi il soggetto, lo stile (simbolo di logo, distintivo, illustrazione piatta) e i colori. Metti tra virgolette qualsiasi scritta da inserire nel logo.
Scegli le proporzioni
Scegli
aspect_ratio: 1:1 è adatto a simboli e distintivi, 3:2 o 16:9 a scene e banner.Modifica l’SVG
Scarica il file .svg e aprilo in Figma, Illustrator o Inkscape per regolare colori, spaziatura e lettere.
Introduzione
Recraft V4 Vector trasforma un brief scritto in un file SVG. Recraft ha creato V4 per i designer, curando composizione, colore e geometria pulita. Questo endpoint ne utilizza la modalità vettoriale.
Funzioni e punti di forza
Geometria pulita e sovrapposta
Le forme sono tracciati separati: puoi cambiare il colore dell’orecchio di una volpe o spostare il nastro di un distintivo senza ridisegnare nulla.
Palette rispettate
Nelle nostre prove, le palette indicate nel prompt, come verde petrolio e corallo o crema e marrone, sono state seguite fedelmente.
Scritte integrate nel design
I nomi brevi come Rise & Crumb vengono disegnati come parte della grafica.
Casi d’uso
Bozze di identità visiva
Esplora simboli e distintivi per una nuova attività, poi affida il migliore a un designer.
Illustrazioni per web e app
Crea illustrazioni di apertura e per stati vuoti che rimangano nitide su qualsiasi schermo.
Confezioni ed etichette
Disegna grafiche per etichette che possano essere ingrandite per la stampa.
Guida ai prompt e consigli pratici
Parti dal formato
Inizia con simbolo di logo, emblema, distintivo o illustrazione piatta, così il modello imposta il giusto livello di dettaglio.
Mantieni i simboli semplici
Per i loghi, chiedi forme piatte o geometriche e due o tre colori.
Controlla le scritte
Verifica ortografia e spaziatura, poi correggi in un editor vettoriale se necessario.
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/v4-vector/text-to-image",
"input": {
"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.
