Introduzione
Cosa fa questo endpoint
Genera un SVG da un prompt di testo con Ideogram Vector 1.0. Il file è composto da tracciati e sfumature, quindi si adatta a qualsiasi dimensione e si apre come insieme di forme modificabili.
Input principali
prompt descrive il disegno. quality permette di scegliere low, medium o high. aspect_ratio imposta la forma della tela tra 17 proporzioni. reference_image_urls è facoltativo: fino a cinque immagini per guidare lo stile.
Cosa ricevi
Un file .svg per richiesta (MIME image/svg+xml).
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Immagine |
| Input da vettorializzare | JPEG, PNG o WebP, fino a 50 MB |
| Lunghezza del prompt | Fino a 9,500 caratteri |
| Immagini di riferimento | Fino a 5 per le immagini generate |
Caratteristiche principali
Un ritratto al bar ricostruito con forme a tinta unita
Abbiamo vettorializzato una foto da 1024×1536 con detailed. Il file SVG conteneva circa 2,000 tracciati e 580 sfumature: capelli, maglia e luce della finestra sono diventati aree di colore posterizzate che conservano la scena originale, in circa 2 MB.
Un’icona PNG piatta diventa 17 tracciati puliti
Un’icona di tazza di caffè esportata in PNG è diventata un SVG da 6 KB, con contorni, riccioli di vapore ed emblema a foglia fedeli alla bitmap. Ogni forma è un tracciato separato: basta un clic in un editor vettoriale per cambiarne il colore.
simple unisce le forme piccole
A sinistra c’è l’originale, al centro la vettorializzazione con simple, a destra quella con detailed. simple ha ridotto i tracciati da circa 2,000 a meno di 1,000 e il file da 2 MB a 1.1 MB. I bordi di capelli e maglione sono diventati blocchi più ampi.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Descrivi soggetto, stile (piatto, disegno al tratto, geometrico), colori e scritte da inserire. almeno 1 caratteri · al massimo 9500 caratteri |
quality | No | low, medium (predefinito) o high. I livelli superiori aggiungono dettagli e richiedono più tempo; ciascuno ha un proprio prezzo per SVG. |
aspect_ratio | No | Proporzioni della tela vettoriale, da 1:4 verticale a 4:1 orizzontale; il valore predefinito è 1:1. |
reference_image_urls | No | Facoltativo: fino a cinque immagini JPEG, PNG o WebP da un massimo di 10 MB ciascuna, come riferimento per stile e composizione. La prima ha il peso maggiore. al massimo 5 elementi |
Prezzi
Ogni SVG completato viene addebitato una sola volta alla tariffa del suo livello di qualità. Le immagini di riferimento aumentano il prezzo solo con high. Le richieste non riuscite o senza un SVG in uscita non vengono addebitate.
| With references | Qualità: low | Qualità: medium | Qualità: high |
|---|---|---|---|
| $0.174 / immagine | $0.216 / immagine | $0.264 / immagine |
| $0.174 / immagine | $0.216 / immagine | $0.432 / immagine |
Casi d’uso
Loghi e marchi con scritte
Richiedi un simbolo con un nome breve e conserva le scritte come contorni vettoriali, nitidi su un biglietto da visita o un’insegna.
Recupera un logo a bassa risoluzione
Vettorializza un vecchio logo PNG o JPEG in SVG per stamparlo in grande, ricolorarlo o inviarlo in tipografia.
Poster, adesivi e file da taglio
Genera un poster o un adesivo come insieme di forme, oppure vettorializza disegni per plotter da taglio, incisori laser e software di ricamo che richiedono vettori.
Consigli avanzati
Scegli l’operazione
Invia prompt per un nuovo disegno (text-to-image) oppure
image_urlper vettorializzare un’immagine esistente (edit). Le richieste conimage_urlvengono indirizzate automaticamente alla vettorializzazione.Scegli le impostazioni
Per una nuova immagine scegli quality e
aspect_ratioe, se vuoi, fino a cinque immagini di riferimento. Per la vettorializzazione sceglidetail_level: detailed o simple.Scarica il file SVG
Interroga lo stato dell’attività e scarica il file .svg dall’archivio della piattaforma. Aprilo in Figma, Illustrator o Inkscape: tracciati e riempimenti sono subito modificabili.
Introduzione
La funzione da testo a SVG di Ideogram Vector 1.0 disegna un nuovo file vettoriale da una descrizione. È pensata per loghi, emblemi, poster, adesivi e illustrazioni semplici che devono restare nitidi a qualsiasi dimensione.
Funzioni e punti di forza
Output vettoriale nativo
Il modello restituisce elementi di tracciato e sfumatura, senza racchiudere un’immagine in un contenitore SVG. Apri il file in Figma, Illustrator o Inkscape e potrai selezionare ogni forma.
Scritte leggibili
Ideogram è noto per la tipografia. Nei nostri test, parole brevi come FOXTROT e NORTH SHORE erano scritte correttamente e integrate nell’impaginazione.
Tre livelli e 17 proporzioni
low serve per bozze rapide, medium per la maggior parte dei lavori e high per il massimo dettaglio. La tela va da 1:4 verticale a 4:1 orizzontale.
Casi d’uso
Abbozza un marchio
Genera diverse proposte di logo, poi perfeziona quella scelta in un editor vettoriale.
Poster per eventi e negozi
Crea un poster con un titolo da stampare in A2 senza pixel visibili.
Adesivi e articoli promozionali
Crea disegni per taglio del vinile, serigrafia o ricamo, che richiedono file vettoriali.
Guida ai prompt e consigli
Descrivi lo stile con precisione
Parole come piatto, geometrico, disegno al tratto, bicolore o emblema aiutano il modello a mantenere le forme semplici e modificabili.
Inserisci le scritte tra virgolette o in maiuscolo
Scrivi il testo esatto da inserire e limitati a poche parole.
Indica i colori
Non c’è un controllo della tavolozza: elenca i colori nel prompt, per esempio blu navy e pesca.
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": "ideogram/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# 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.
