API PerfectVectorBeta
Da immagine a SVG, con una sola chiamata API
Invia un’immagine PNG, JPEG o WebP e ricevi un SVG pulito e modificabile, dal tuo server, dal tuo script o dal tuo strumento di automazione.
- Aggiungi la conversione da immagine a SVG al tuo prodotto o ai tuoi strumenti interni
- Converti loghi, icone e illustrazioni nelle tue pipeline
- Paghi solo le conversioni riuscite
Da 0,08 USD per SVG · chiavi di test gratuite
Conversione in produzione riuscita
POST /v1/vectorizations · Idempotency-Key: logo-0001201 · "status": "succeeded"X-Credits-Charged: 1Conversione non riuscita
POST /v1/vectorizations · Idempotency-Key: logo-0002"status": "failed"X-Credits-Charged: 0Stessa richiesta ripetuta
POST /v1/vectorizations · Idempotency-Key: logo-0001Idempotent-Replayed: trueX-Credits-Charged: 0Chiave di test, stessa richiesta
POST /v1/vectorizations · Bearer pv_test_…201 · test keyX-Credits-Would-Charge: 1
Perché i team scelgono l’API di PerfectVector
- Paghi solo se la conversione riesce
- Un credito API per ogni SVG consegnato. Le conversioni non riuscite o andate in timeout, i controlli di stato e i download ripetuti non costano nulla.
- Test gratuiti, come in produzione
- Le chiavi di test eseguono gli stessi controlli, applicano gli stessi limiti e danno le stesse risposte delle chiavi di produzione, restituendo un SVG di esempio. Così completi l’integrazione prima di pagare.
- Riprova senza rischi
- Invia un Idempotency-Key: se ripeti la richiesta, ricevi la stessa conversione senza eseguirla o pagarla due volte.
Casi d’uso
Cosa puoi creare con l’API di PerfectVector
Usala per creare un nuovo servizio, aggiungila al tuo prodotto esistente o integrala nelle tue pipeline.
Lancia un nuovo servizio
Vendi prodotti realizzati con le immagini dei tuoi clienti.
- Adesivi personalizzati e file di taglio
- Ordini di incisioni personalizzate
- Strumenti di elaborazione in blocco per venditori online
order.png → API → product.svgAggiungila al tuo prodotto
Offri ai tuoi utenti un pulsante per vettorializzare, senza sviluppare il motore.
- Editor di grafica e modelli
- Stampa su richiesta e merchandising
- Software per macchine da taglio e insegne
upload.png → API → editable.svgAutomatizza la tua pipeline
Converti i file appena arrivano, senza interventi manuali.
- Librerie di risorse grafiche del marchio
- Lavori in attesa di agenzie e studi
- Strumenti di automazione no-code
inbox/*.png → API → library/*.svg
Il tuo agente di programmazione può scrivere l’integrazione usando il riferimento API per agenti, raccolto in un’unica pagina. Apri il riferimento per agenti
Vedi i prezzi dell’APIFunzionalità dell’API
Tutto ciò che ti serve per portare la conversione da immagine a SVG in produzione.
Converti
PNG, JPEG o WebP fino a 5 MiB, da 100 a 4.096 pixel per lato, con una sola richiesta multipart.
Attendi o usa il polling
Ricevi l’SVG nella stessa risposta, oppure usa l’ID per controllare lo stato mentre la conversione è in corso.
Risultati
I link per il download funzionano per 24 ore. Puoi eliminare i file di una conversione in qualsiasi momento.
Idempotenza
Le richieste ripetute con la stessa chiave restituiscono la stessa conversione, senza un secondo addebito.
Modalità test
Le chiavi di test gratuite eseguono l’intera richiesta e restituiscono un SVG di esempio.
Errori e limiti
Codici di errore stabili, un ID richiesta in ogni risposta e header chiari sui limiti di frequenza.
Guida rapida
Dalla chiave al primo SVG in pochi minuti
Crea una chiave di test
Accedi, apri la pagina API per sviluppatori del tuo account e crea una chiave in modalità test. È gratis.
Invia un’immagine
Inviala con una richiesta POST come dati di un modulo multipart. Richiedi image/svg+xml per ricevere l’SVG nella stessa chiamata.
Passa a una chiave di produzione
Acquista un pacchetto di crediti, sostituisci la chiave con una di produzione e inizia a convertire immagini reali. Il resto non cambia.
curl https://api.perfectvector.com/v1/vectorizations \
-H "Authorization: Bearer $PERFECTVECTOR_API_KEY" \
-H "Idempotency-Key: logo-0001" \
-H "Accept: image/svg+xml" \
-F image=@logo.png \
-o logo.svgimport os
import requests
with open("logo.png", "rb") as image:
response = requests.post(
"https://api.perfectvector.com/v1/vectorizations",
headers={
"Authorization": f"Bearer {os.environ['PERFECTVECTOR_API_KEY']}",
"Idempotency-Key": "logo-0001",
"Accept": "image/svg+xml",
},
files={"image": ("logo.png", image)},
timeout=130,
)
if response.headers["Content-Type"].startswith("image/svg+xml"):
with open("logo.svg", "wb") as file:
file.write(response.content)import { readFile, writeFile } from "node:fs/promises";
const form = new FormData();
form.append("image", new Blob([await readFile("logo.png")]), "logo.png");
const response = await fetch("https://api.perfectvector.com/v1/vectorizations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.PERFECTVECTOR_API_KEY}`,
"Idempotency-Key": "logo-0001",
Accept: "image/svg+xml",
},
body: form,
signal: AbortSignal.timeout(130_000),
});
if (response.headers.get("content-type")?.startsWith("image/svg+xml")) {
await writeFile("logo.svg", Buffer.from(await response.arrayBuffer()));
}Nella guida rapida trovi esempi completi con polling e gestione degli errori.
Prezzi
Pacchetti di crediti, senza abbonamento
Acquisti una volta, li usi per 12 mesi. Un credito API equivale a un SVG ottenuto con una conversione riuscita.
Starter
10 crediti API
Prezzo normale 5 USD, prezzo beta 4 USD0,40 USD per SVG
Bulk 100
100 crediti API
Prezzo normale 20 USD, prezzo beta 16 USD0,16 USD per SVG
Bulk 1000
1000 crediti API
Prezzo normale 100 USD, prezzo beta 80 USD0,08 USD per SVG
Prezzo beta, sconto del 20%
Ti servono 10.000 crediti API o più? Contatta il team commerciale
Domande sull’API
L’API di PerfectVector è già disponibile?
Sì. È aperta a tutti come beta pubblica dal 3 novembre 2026. Crea una chiave di test gratuita per iniziare a sviluppare oggi.
Quali immagini posso convertire?
Immagini PNG, JPEG e WebP fino a 5 MiB, con ogni lato compreso tra 100 e 4.096 pixel. Loghi, icone e illustrazioni con forme ben definite producono gli SVG più puliti. Ogni richiesta converte un’immagine con le impostazioni standard.
Come funzionano i prezzi?
Una conversione in produzione usa un credito API quando riesce. Acquisti i crediti in pacchetti una tantum, senza abbonamento né ricarica automatica. Le conversioni non riuscite, i controlli di stato e i download ripetuti sono gratuiti.
Posso provare prima di pagare?
Sì. Le chiavi di test sono gratuite, eseguono l’intera richiesta, inclusi i controlli sulla chiave, sul file e sui limiti di frequenza, e restituiscono un SVG di esempio. Quando la tua integrazione funziona, passa a una chiave di produzione.
I crediti API sono gli stessi del sito web?
No. I crediti API sono separati da quelli che usi sul sito web e negli assistenti IA, e non si convertono mai gli uni negli altri. I piani del sito non includono crediti API.
Cosa succede alle immagini che invio?
Le tue immagini e i tuoi SVG restano disponibili per 24 ore, poi vengono eliminati dall’archivio entro 48 ore. Puoi eliminare subito una conversione tramite l’API. Le tue immagini non vengono mai usate per addestrare modelli di IA né vendute.
Meglio usare l’API o PerfectVector MCP?
Usa l’API quando è il tuo software a convertire le immagini, con una chiave API. Usa PerfectVector MCP quando vuoi convertire immagini chiedendolo a ChatGPT, Claude o un altro assistente supportato, senza scrivere codice.
Inizia a sviluppare con una chiave di test gratuita
Nessun costo finché la tua integrazione non funziona. Poi un credito per ogni SVG che ottieni davvero.
Preferisci chiederlo a un assistente IA? Prova PerfectVector MCP