API vettorializzazione immmagine

Vectorizer.AI offre un API di traccia bitmap completo. L'API traccia i pixel ai vettori automaticamente e con una fedeltà best-in-class.

Ottieni chiave API

Avvio rapido

POSTA un'immagine bitmap e ottiene un risultato vettorializzato

File
URL

$ curl https://it.vectorizer.ai/api/v1/vectorize \
 -u xyz123:[secret] \
 -F image=@example.jpeg \
 -o result.svg

// Requires: org.apache.httpcomponents.client5:httpclient5-fluent

Request request = Request.post("https://it.vectorizer.ai/api/v1/vectorize")
   .addHeader("Authorization", "Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd")
   .body(
      MultipartEntityBuilder.create()
         .addBinaryBody("image", new File("example.jpeg")) // TODO: Replace with your image
         // TODO: Add more upload parameters here
         .build()
      );
ClassicHttpResponse response = (ClassicHttpResponse) request.execute().returnResponse();

if (response.getCode() == 200) {
   // Write result to disk, TODO: or wherever you'd like
   try (FileOutputStream out = new FileOutputStream("result.svg")) {
      response.getEntity().writeTo(out);
   }
} else {
   System.out.println("Request Failed: Status: " + response.getCode() + ", Reason: " + response.getReasonPhrase());
}

using (var client = new HttpClient())
using (var form = new MultipartFormDataContent())
{
   client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", "INSERT_API_KEY_HERE");
   form.Add(new ByteArrayContent(File.ReadAllBytes("example.jpeg")), "image", "example.jpeg"); // TODO: Replace with your image
   // TODO: Add more upload parameters here

   var response = client.PostAsync("https://it.vectorizer.ai/api/v1/vectorize", form).Result;

   if (response.IsSuccessStatusCode)
   {
      // Write result to disk, TODO: or wherever you'd like
      FileStream outStream = new FileStream("result.svg", FileMode.Create, FileAccess.Write, FileShare.None);
      response.Content.CopyToAsync(outStream).ContinueWith((copyTask) => { outStream.Close(); });
   }
   else
   {
       Console.WriteLine("Request Failed: Status: " + response.StatusCode + ", Reason: " + response.ReasonPhrase);
   }
}

// Requires "request" to be installed (see https://www.npmjs.com/package/request)
var request = require('request');
var fs = require('fs');

request.post({
  url: 'https://it.vectorizer.ai/api/v1/vectorize',
  formData: {
    image: fs.createReadStream('example.jpeg'), // TODO: Replace with your image
    // TODO: Add more upload options here
  },
  auth: {user: 'xyz123', pass: '[secret]'},
  followAllRedirects: true,
  encoding: null
}, function(error, response, body) {
  if (error) {
    console.error('Request failed:', error);
  } else if (!response || response.statusCode != 200) {
    console.error('Error:', response && response.statusCode, body.toString('utf8'));
  } else {
    // Save result
    fs.writeFileSync("result.svg", body);
  }
});

$ch = curl_init('https://it.vectorizer.ai/api/v1/vectorize');

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER,
    array('Authorization: Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd'));
curl_setopt($ch, CURLOPT_POSTFIELDS,
    array(
      'image' => curl_file_create('example.jpeg'),
      // TODO: Add more upload options here
    ));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) == 200) {
  // Save result
  file_put_contents("result.svg", $data);
} else {
  echo "Error: " . $data;
}
curl_close($ch);

# Either use the sample code below, or this SDK: https://pypi.org/project/vectorizer-ai/
# Requires "requests" to be installed (see https://pypi.org/project/requests/)
import requests

response = requests.post(
    'https://it.vectorizer.ai/api/v1/vectorize',
    files={'image': open('example.jpeg', 'rb')},
    data={
        # TODO: Add more upload options here
    },
    auth=('xyz123', '[secret]')
)
if response.status_code == requests.codes.ok:
    # Save result
    with open('result.svg', 'wb') as out:
        out.write(response.content)
else:
    print("Error:", response.status_code, response.text)

# Requires: gem install httpclient
require 'httpclient'

client = HTTPClient.new default_header: {
  "Authorization" => "Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd"
}

response = client.post("https://it.vectorizer.ai/api/v1/vectorize", {
  "image" => File.open("example.jpeg", "rb"), # TODO: Replace with your image
  # TODO: Add more upload parameters here
})

if response.status == 200 then
  # Write result to disk, TODO: or wherever you'd like
  File.open("result.svg", 'w') { |file| file.write(response.body) }
else
  puts "Error: Code: " + response.status.to_s + ", Reason: " + response.reason
end

$ curl https://it.vectorizer.ai/api/v1/vectorize \
 -u xyz123:[secret] \
 -F 'image.url=https://example.com/example.jpeg' \
 -o result.svg

// Requires: org.apache.httpcomponents.client5:httpclient5-fluent

Request request = Request.post("https://it.vectorizer.ai/api/v1/vectorize")
   .addHeader("Authorization", "Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd")
   .body(
      MultipartEntityBuilder.create()
         .addTextBody("image.url", "https://example.com/example.jpeg") // TODO: Replace with your image URL
         // TODO: Add more upload parameters here
         .build()
      );
ClassicHttpResponse response = (ClassicHttpResponse) request.execute().returnResponse();

if (response.getCode() == 200) {
   // Write result to disk, TODO: or wherever you'd like
   try (FileOutputStream out = new FileOutputStream("result.svg")) {
      response.getEntity().writeTo(out);
   }
} else {
   System.out.println("Request Failed: Status: " + response.getCode() + ", Reason: " + response.getReasonPhrase());
}

using (var client = new HttpClient())
using (var form = new MultipartFormDataContent())
{
   client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", "INSERT_API_KEY_HERE");
   form.Add(new StringContent("https://example.com/example.jpeg"), "image.url"); // TODO: Replace with your image URL
   // TODO: Add more upload parameters here

   var response = client.PostAsync("https://it.vectorizer.ai/api/v1/vectorize", form).Result;

   if (response.IsSuccessStatusCode)
   {
      // Write result to disk, TODO: or wherever you'd like
      FileStream outStream = new FileStream("result.svg", FileMode.Create, FileAccess.Write, FileShare.None);
      response.Content.CopyToAsync(outStream).ContinueWith((copyTask) => { outStream.Close(); });
   }
   else
   {
       Console.WriteLine("Request Failed: Status: " + response.StatusCode + ", Reason: " + response.ReasonPhrase);
   }
}

// Requires "request" to be installed (see https://www.npmjs.com/package/request)
var request = require('request');
var fs = require('fs');

request.post({
  url: 'https://it.vectorizer.ai/api/v1/vectorize',
  formData: {
    'image.url': 'https://example.com/example.jpeg', // TODO: Replace with your image
    // TODO: Add more upload options here
  },
  auth: {user: 'xyz123', pass: '[secret]'},
  followAllRedirects: true,
  encoding: null
}, function(error, response, body) {
  if (error) {
    console.error('Request failed:', error);
  } else if (!response || response.statusCode != 200) {
    console.error('Error:', response && response.statusCode, body.toString('utf8'));
  } else {
    // Save result
    fs.writeFileSync("result.svg", body);
  }
});

$ch = curl_init('https://it.vectorizer.ai/api/v1/vectorize');

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER,
    array('Authorization: Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd'));
curl_setopt($ch, CURLOPT_POSTFIELDS,
    array(
      'image.url' => 'https://example.com/example.jpeg',
      // TODO: Add more upload options here
    ));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) == 200) {
  // Save result
  file_put_contents("result.svg", $data);
} else {
  echo "Error: " . $data;
}
curl_close($ch);

# Either use the sample code below, or this SDK: https://pypi.org/project/vectorizer-ai/
# Requires "requests" to be installed (see https://pypi.org/project/requests/)
import requests

response = requests.post(
    'https://it.vectorizer.ai/api/v1/vectorize',
    data={
        'image.url': 'https://example.com/example.jpeg',
        # TODO: Add more upload options here
    },
    auth=('xyz123', '[secret]')
)
if response.status_code == requests.codes.ok:
    # Save result
    with open('result.svg', 'wb') as out:
        out.write(response.content)
else:
    print("Error:", response.status_code, response.text)

# Requires: gem install httpclient
require 'httpclient'

client = HTTPClient.new default_header: {
  "Authorization" => "Basic dmt5YzY3a3FhMjd5aWRkOltzZWNyZXRd"
}

response = client.post("https://it.vectorizer.ai/api/v1/vectorize", {
  "image.url" => "https://example.com/example.jpeg", # TODO: Replace with your image URL
  # TODO: Add more upload parameters here
})

if response.status == 200 then
  # Write result to disk, TODO: or wherever you'd like
  File.open("result.svg", 'w') { |file| file.write(response.body) }
else
  puts "Error: Code: " + response.status.to_s + ", Reason: " + response.reason
end

Chatbot API

Abbiamo creato un ChatGPT personalizzato che ti può aiutare con la tua integrazione API. Può rispondere a domande sulla documentazione API, e fornisce un codice di esempio nella tua lingua preferita adattato al tuo caso di utilizzo.

Chatta on il Chatbot API Vectorizer.AI

Il chatbot è in beta e fa errori. Controlla le risposte e chiedigli di modificare il codice per correggere errori e omissioni.

Come usare questo API

L'API è previsto per supportare molti usi-casi diversi. Qui di seguito sono elencati i più comuni:

Immagine singola Inoltra un bitmap, ottieni un risultato vettoriale, fatto

Usa l'endpoint Vettorializza e i codici di esempio qui sopra.

Anteprima prima Mostra un'anteprima al tuo possibile cliente prima dell'acquisto

Se devi effettuare molte chiamate API per finalizzare una vendita, puoi usare le panoramiche a costo inferiore fino a quando non convinci il cliente.

Usa l'endpoint Vettorializzacon mode=preview e policy.retention_days > 0 per ottenere l'anteprima, assicurandoti di conservare l'Image Token restituito nell'intestazione di risposta X-Image-Token
Una volta convinto il cliente, usa l'endpoint Scarica con l'Image Token per scaricare il risultato completo.
Facoltativo: se hai bisogno di altri formati di risultato (es. PNG, PDF, ecc), assicurati di conservare la Ricevuta restituita nell'intestazione di risposta scaricamento X-Receipt. Quindi utilizza l'endpoint Scarica con l'Image Token e la Ricevuta per scaricare i formati rimanenti.

Multiformato Per esempio hai bisogno di risultati PNG e SVG.

Utilizza l'endpoint Vettorializza con policy.retention_days > 0 per ottenere il primo risultato, assicurandoti di conservare l'Image Token restituito nell'intestazione di risposta X-Image-Token.
Utilizza l'endpoint Scarica con l'Image Token per scaricare gli altri formati.

Multiopzione Devi elaborare ogni immagine con multiple opzioni di elaborazione.

Utilizza l'endpoint Vettorializza con policy.retention_days > 0 per ottenere il primo risultato, assicurandoti di conservare l'Image Token restituito nell'intestazione di risposta X-Image-Token.
Utilizza l'endpoint Vettorializza con l'Image Token per ripetere con le rimanenti opzioni di elaborazione che desideri.

In alternativa, puoi elaborare ciascuna immagine individualmente senza preoccuparti dell'Image Token. L'Image Token ti fa risparmiare un po' di larghezza banda e latenza.

Livelli di prezzi

Azione	Crediti	Descrizione
Test	0.00	L'integrazione e la prova dell'API sono gratuite, non occorre un abbonamento. Usa semplicemente `mode=test` e `mode=test_preview` per lo sviluppo. Pupi valutare la qualità del risultato usando la Web App interattiva alla prima pagina.
Anteprima	0.20	Offriamo l'anteprima dei risultati per consentirti di mostrare agli utenti finali il prodotto prima dell'acquisto. Le anteprime sono immagini PNG del quadruplo delle dimensioni del tuo input, e hanno una filigrana discreta. Usa `mode=preview` per ottenere un'anteprima del risultato.
Vettorializza	1.00	Vettorializza un'immagine bitmap per un'immagine vettoriale.
Anteprima upgrade	0.90	Scarica il risultato di produzione dopo la panoramica della chiamata API. Meno caro in rapporto alla vettorializzazione da zero.
Formato scaricamento	0.10	Scarica un altro formato (es. SVG, PNG, PDF, ecc.) del risultato. Meno caro in rapporto alla vettorializzazione da zero.
Giorno di archiviazione	0.01	Il prezzo al giorno per l'archiviazione di un risultato oltre il primo giorno, che è gratuito.

Consulta la pagina prezzi per i piani di abbonamento.

Autenticazione e Sicurezza

L'API utilizza l'autenticazione di base HTTP standard. Tutte le richieste all'API devono essere effettuate sull'HTTPS e includere le tue credenziali API, con l'ID API come utente e il segreto API come password.

La tua libreria client HTTP deve supportare l'Indicazione nome server (SNI) per fare richieste con successo. Se ricevi strani errori di handshake, probabilmente dipende da questo.

Limitazione di velocità

L'uso dell'API è a velocità limitata con concessioni generose e nessun limite superiore fisso.

Durante l'operazione normale gestita dall'utente finale non dovresti trovare limiti di velocità in quanto l'uso tende a fluire e rifluire in un modo che il servizio gestisce agilmente.

Tuttavia, per lavori in batch raccomandiamo di iniziare con almeno 5 thread, aggiungendo 1 nuovo thread ogni 5 minuti fino a raggiungere il livello di parallelismo desiderato. Ti pregheremmo di contattarci prima di iniziare se hai bisogno di oltre 100 thread simultanei.

Se inoltri troppe richieste inizierai a ricevere risposte 429 Too Many Requests. In tal caso dovresti applicare un backoff lineare: alla prima risposta di questo tipo, attendi 5 secondi prima di inoltrare la richiesta successiva. Alla seconda risposta 429 consecutiva, attendi 2*5=10 secondi prima di inoltrare la richiesta successiva. Alla terza attendi 3*5=15 secondi, ecc.

Puoi reimpostare il contatore di backoff dopo una richiesta riuscita, e dovresti applicare il backoff per thread (vale a dire i thread dovrebbero essere indipendenti l'uno dall'altro).

Timeout

Sebbene le richieste API siano normalmente completate in pochi secondi, è possibile che durante picchi di carico occorra più tempo per l'elaborazione.

Per assicurarti che la tua libreria clienti non termini troppo presto le richieste API dovrebbero essere configurate con un timeout inattività di almeno 180 secondi.

Errore JSON

Usiamo stati HTTP convenzionali per indicare se una richiesta API riesce o meno, includendo importanti informazioni di errore nell'Errore Oggetto JSON restituito.

Cerchiamo di restituire sempre un Errore Oggetto JSON con qualsiasi richiesta problematica. Tuttavia, in teoria è sempre possibile che vi siano errori interni del server che portano a una risposta non di errore JSON.

Attributi
status	Lo status HTTP della risposta, ripetuto qui come ausilio per il debug.
code	Codice errore interno Vectorizer.AI.
message	Messaggio di errore leggibile, previsto per aiutare con il debug.

Se lo status HTTP per la tua richiesta è 200 non sarà restituito un Errore Oggetto JSON, e puoi presumere con sicurezza che la richiesta in senso lato è riuscita.

Alcune librerie client HTTP generano eccezioni per gli stati HTTP nel range 400-599. Dovrai catturare queste eccezioni e gestirle idoneamente.

HTTP Status	Significato
`200`-`299`	Operazione riuscita
`400`-`499`	Esiste un problema con le informazioni fornite nella richiesta (per esempio un parametro mancante). Controlla il messaggio di errore per determinare come risolverlo.
`500`-`599`	Si è verificato un errore Vectorizer.AI interno. Attendi un momento quindi riprova, e se il problema persiste inviaci una email.

Esempio di risposta di errore

{
  "error" : {
    "status" : 400,
    "code" : 1006,
    "message" : "Failed to read the supplied image. "
  }
}

I recenti errori API sono elencati nella pagina del tuo account per facilitare il debug.

C'è anche un elenco di tutte le risposte di errore restituite dall'API.

Intestazioni risposta

Ecco le intestazioni di risposta personalizzate che usiamo:

Intestazione	Descrizione
`X-Image-Token`	Restituita quando la tua richiesta di vettorializzazione ha `policy.retention_days > 0` Può essere usato per: Scarica il risultato di produzione dopo una chiamata API in panoramica a un prezzo ridotto in rapporto alla vettorializzazione da zero. Scarica altri formati (es. SVG, PNG, PDF, etc.) del risultato a un prezzo ridotto in rapporto alla vettorializzazione da zero. Rivettorializza la stessa immagine con diverse opzioni di elaborazione.
`X-Receipt`	Restituito quando scarichi un risultato di produzione usando un Image Token precedente. Può essere usato per scaricare altri formati (es. SVG, PNG, PDF, etc.) del risultato al prezzo di formato scaricamento ridotto in rapporto al prezzo di upgrade panoramica.
`X-Credits-Calculated`	Restituito con le richieste di test per mostrare il costo che sarebbe stato addebitato nel caso di una richiesta regolare.
`X-Credits-Charged`	Restituito con tutte le richieste per mostrare il costo addebitato. Sempre 0 per le richieste di test.

Vettorializza `POST`
`https://api.vectorizer.ai/api/v1/vectorize`

Per vettorializzare un'immagine, devi eseguire un caricamento file POST HTTP standard. Tieni presente che il Contenuto-Tipo deve essere multipart/form-data quando carichi file binari.

La tabella qui di seguito include tutti i parametri API in un formato di lavoro provalo ora. Ciascun parametro include una breve descrizione, ma assicurati di consultare la documentazione dettagliata sulle Opzioni di output.

Parametri

L'immagine inserita deve essere fornita come:

image Binario Facoltativo	Un file binario.
image.base64 Stringa Facoltativo	Stringa codificata base64. La stringa può essere di 1 megabyte massimo.
image.url Stringa Facoltativo	Un URL da recuperare ed elaborare.
image.token Facoltativo	Un Image Token restituito nell'intestazione `X-Image-Token` in una chiamata di vettorializzazione API precedente ove `policy.retention_days > 0`.

Deve essere un file .bmp, .gif, .jpeg, .png, o .tiff.

Le dimensioni massime per il caricamento dell'immagine (= larghezza × altezza) sono 33.554.432 pixel, che sono ridotte a input.max_pixels.

mode
production preview test test_preview

Num, default: production

Value	Processing Mode	Credits
`production`	Questa modalità è prevista per l'uso in produzione e tutti i parametri sono supportati.	1.00
`preview`	Questa modalità è prevista per consentirti di mostrare all'utente finale il prodotto prima dell'acquisto. Produce un risultato PNG del quadruplo delle dimensioni con una filigrana discreta, ignorando parametri contraddittori.	0.20
`test`, `test_preview`	Queste modalità sono previste per l'uso da parte dei developer durante l'integrazione con il servizio. Tutti i parametri sono supportati, ma è prevista una filigrana notevole. I risultati delle prove sono gratuiti e non richiedono un abbonamento attivo,, in modo da rendere possibile l'integrazione gratuita con il servizio. Includiamo un'intestazione `X-Credits-Calculated` nella risposta per consentirti di sapere con certezza quanto ti sarebbe stato addebitato per le chiamate di produzione corrispondenti.	Gratutito

input.max_pixels

Intero, 100 a 3145828, default: 2097252

Le dimensioni massime di input dell'immagine (= larghezza × altezza in pixel). Immagini più grandi saranno ridotte a queste dimensioni prima dell'elaborazione.

policy.retention_days

Intero, 0 a 30, default: 0

Il numero di giorni per la conservazione dell'immagine di input e i relativi risultati. Quando specifichi policy.retention_days > 0 includiamo un'intestazione X-Image-Token nella risposta.

Ciò ha tre utilizzi principali:

Dopo una chiamata API in panoramica puoi in seguito scaricare il risultato di produzione rapidamente e a prezzo ridotto.
Dopo la vettorializzazione di un'immagine puoi scaricare diversi formati di output per la stessa immagine e opzioni di elaborazione senza dovere vettorializzare tutto da zero. Ciò fa risparmiare significativamente crediti e latenza.
Quando vuoi rivettorializzare la stessa immagine con diverse opzioni di elaborazione. Ciò ti consente di ridurre la latenza della chiamata e risparmiare larghezza di banda.

Il primo giorno di archiviazione è gratuiti, quindi un addebito di 0,01 crediti al giorno viene applicato.

Vedi anche l'endpoint Scaricamento.

processing.max_colors

Intero, 0 a 256, default: 0

Il massimo numero di colori da usare per il risultato.

0 significa illimitato. 1 e 2 significano entrambi due colori, per esempio bianco e nero. N>=2 significa quel numero di colori.

Va notato che se il output.gap_filler.enabled=true (default) il risultato conterrà anche miscele dei colori selezionati. Disattiva il gap filler per ottenere un risultato che contenga solamente i colori selezionati.

processing.palette

Formato: '[color][-> remapped][~ tolerance];'

#00000000;
#FFFFFF ~ 0.1;
#0000FF -> #00FF00;
#FF0000 -> #00FF00 ~ 0.1;

Default: (empty)

Questo è un meccanismo molto potente e flessibile per controllare i colori nel risultato.

I colori rilevati nell'immagine che rientrano nella tolleranza di qualsiasi tavolozza di colori saranno regolati secondo il colore della tavolozza più vicino, e cambiati se quel colore della tavolozza ha una rimappatura specificata. I colori non abbinati sono lasciati invariati.

Esempi

Per regolare i colori rilevati secondo il rosso, verde e blu più vicino, usa:

#FF0000; 
#00FF00; 
#0000FF;

Per ripulire i colori rilevati vicino al rosso, verde e blu, ma lasciare gli altri invariati, usa:

#FF0000 ~ 0.02; 
#00FF00 ~ 0.02; 
#0000FF ~ 0.02;

Per modificare i colori rilevati vicini al rosso in verde, lasciando tutto il resto invariato, usa:

#FF0000 -> #00FF00 ~ 0.02;

Per regolare qualsiasi colore vicino al rosso, verde e blu secondo questi colori, ma regolare tutti gli altri colori secondo il nero trasparente (rimuovendoli quindi dal risultato), usa:

#FF0000 ~ 0.02; 
#00FF00 ~ 0.02; 
#0000FF ~ 0.02; 
#00000000; // Transparent => removed

Colori

I colori sono specificati usando la sintassi di colori CSS di base. Per colori (parzialmente) trasparenti raccomandiamo l'uso di #RRGGBBAA. Per i colori opachi raccomandiamo l'uso di #RRGGBB.

I colori completamente trasparenti sono omessi dal risultato. Insieme alla capacità di rimappatura dei colori, puoi usarlo per rimuovere colori selezionati dal risultato.

Puoi usare un massimo di 1.024 colori.

Tolleranza

L'unità è in distanza di colori ARGB frazionaria, in cui 1,0 è la distanza dal rosso opaco (#FFFF0000) al nero opaco (#FF000000).

La tolleranza massima è 2,0, che è la distanza del nero trasparente (#00000000) al bianco opaco (#FFFFFFFF).

La tolleranza predefinita è 2,0, quindi come impostazione predefinita i colori rilevanti saranno regolati secondo il colore della tavolozza più vicino, anche se distante. Puoi limitare la regolazione secondo i colori di tavolozza individuali specificando tolleranze personalizzate.

Se sei abituato a lavorare con colori nel range 0-255, devi semplicemente dividere per 255 per ottenere il valore frazionario.

processing.shapes.min_area_px

Mobile, 0.0 a 100.0, default: 0.125

L'area minima di una forma in pixel. Le forme più piccole saranno rigettate.

Num, default: svg

Formato file output.

Opzioni SVG:

output.svg.version `svg_1_0` `svg_1_1` `svg_tiny_1_2` Num, default: `svg_1_1`	Specifica l'attributo della versione SVG nel tag SVG. Dettagli
output.svg.fixed_size `true` `false` Booleano, default: `false`	Se includere gli attributi delle dimensioni dell'immagine nel tag SVG. Quando `true` i visualizzatori in genere produrranno l'SVG a una velocità fissa. Quando `false` i visualizzatori in genere consentono a SVG la riduzione in scala per adattarsi allo spazio disponibile. Dettagli
output.svg.adobe_compatibility_mode `true` `false` Booleano, default: `false`	Quando `true` disattiviamo le opzioni che Adobe Illustrator non può importare. Dettagli

Opzioni DFX:

output.dxf.compatibility_level `lines_only` `lines_and_arcs` `lines_arcs_and_splines` Num, default: `lines_and_arcs`	I lettori DFX variano molto in termini di capacità. Questa opzione ti consente di limitare l'output alle primitive di disegno che il tuo lettore DFX supporta effettivamente. Dettagli

Opzioni bitmap:

Applicabile solamente quando output.file_format=png

output.bitmap.anti_aliasing_mode
anti_aliased aliased

Num, default: anti_aliased

Value	Anti-Aliasing Mode
`anti_aliased`	I pixel lungo il confine fra le forme hanno i loro colori fusi secondo la frazione dell'area dei pixel coperta da ciascuna forma.
`aliased`	Ai pixel viene assegnato il colore della forma che contiene il centro geometrico del pixel.

output.draw_style
fill_shapes stroke_shapes stroke_edges

Num, default: fill_shapes

Specifica come desideri tracciare o riempire l'output. Esiste una differenza sottile fra tracciare le forme e tracciare i bordi fra le forme. Consulta la documentazione dettagliata per una spiegazione

output.shape_stacking
cutouts stacked

Num, default: cutouts

Determina se le forme sono collocate in ritagli nelle forme qui sotto (cutouts) o se sono sovrapposte l'una sull'altra (stacked). Dettagli

output.group_by
none color parent layer

Num, default: none

Value	Shape grouping
`none`	Nessun raggruppamento
`color`	Per colore, interagisce con `output.shape_stacking`
`parent`	Per forma contenitore
`layer`	Per livello di ordine disegno

Dettagli

output.parameterized_shapes.flatten
true false

Booleano, default: false

Appiattisci cerchi, ellissi, rettangoli, triangoli e stelle identificati in curve ordinarie. Dettagli

Curve:

output.curves.allowed.quadratic_bezier `true` `false` Booleano, default: `true`	Se consentire le Curve di Bézier quadratiche. Dettagli
output.curves.allowed.cubic_bezier `true` `false` Booleano, default: `true`	Se consentire le Curve di Bézier cubiche. Dettagli
output.curves.allowed.circular_arc `true` `false` Booleano, default: `true`	Se consentire gli Archi circolari. Dettagli
output.curves.allowed.elliptical_arc `true` `false` Booleano, default: `true`	Se consentire gli Archi ellittici. Dettagli
output.curves.line_fit_tolerance Mobile, `0.001` a `1.0`, default: `0.1`	In genere tentiamo di sostituire i tipi di curva no consentiti con i tipi di curva consentiti. See the details for the precise fallback sequences. Tuttavia, se non consenti un numero sufficiente di tipi di curva dovremo approssimarli con segmenti di riga. Questo parametro specifica la distanza massima in pixel fra una curva e le righe che la approssimano. Dettagli

Gap Filler:

output.gap_filler.enabled `true` `false` Booleano, default: `true`	Se lavorare attorno alla riga bianca che produce bug comuni nei visualizzatori vettoriali. Dettagli
output.gap_filler.clip `true` `false` Booleano, default: `false`	Se tagliare i tratti del gap filler. Quando `output.shape_stacking=stacked` taglia o usa tratti senza scala. Dettagli
output.gap_filler.non_scaling_stroke `true` `false` Booleano, default: `true`	Se usare tratti di gap filler senza scala. Quando `output.shape_stacking=stacked` taglia o usa tratti senza scala. Dettagli
output.gap_filler.stroke_width Mobile, `0.0` a `5.0`, default: `2.0`	Larghezza dei tratti del gap filler. Dettagli

Stile di tratti quando output.draw_style è stroke_shapes o stroke_edges

output.strokes.non_scaling_stroke `true` `false` Booleano, default: `true`	Se usare tratti senza scala. Dettagli
output.strokes.use_override_color `true` `false` Booleano, default: `false`	Se usare il colore di override, o il colore stimato della forma. Dettagli
output.strokes.override_color Formato: '#RRGGBB', e.g. `#FF00FF`, default: `#000000`	Colore di override. Dettagli
output.strokes.stroke_width Mobile, `0.0` a `5.0`, default: `1.0`	Ampiezza del tratto. Dettagli

Dimensioni output:

output.size.scale

Mobile, 0.0 a 1000.0
Facoltativo

Fattore di scala uniforme. Se specificato, ha la precedenza su output.size.width e output.size.height.

output.size.width

Mobile, 0.0 a 1.0E12
Facoltativo

Larghezza in unità specificate da output.size.unit. Se è specificata solo la larghezza o l'altezza, l'altra dimensione viene calcolata automaticamente per mantenere il rapporto aspetto.

output.size.height

Mobile, 0.0 a 1.0E12
Facoltativo

Altezza in unità specificate da output.size.unit. Se è specificata solo la larghezza o l'altezza, l'altra dimensione viene calcolata automaticamente per mantenere il rapporto aspetto.

Num, default: none

Le unità di misura per la larghezza e l'altezza. Di queste, pt, in, cm e mm sono unità non fisiche, e none e px sono unità fisiche. Queste distinzioni interagiscono con output.size.input_dpi e output.size.output_dpi.

output.size.aspect_ratio
preserve_inset preserve_overflow stretch

Num, default: preserve_inset

Valore	Regola della scala
`preserve_inset`	Scala uniforme per adattare la dimensione più stretta, in modo che non vi sia fuoriuscita ma spazio vuoto nell'altra dimensione
`preserve_overflow`	Scala uniforme per adattare la dimensione meno stretta, con espansione nella dimensione più stretta
`stretch`	Scala non uniforme per adattare la larghezza e altezza specificate

Per l'una o l'altra preserve opzione, la posizione nella dimensione non limitata è controllata da output.size.align_x o output.size.align_y.

output.size.align_x

Mobile, 0.0 a 1.0, default: 0.5

Allineamento orizzontale per output.size.aspect_ratio = preserve_inset o preserve_overflow.

Valore	Allineamento orizzontale
`0.0`	Allineato a sinistra
`0.5`	Centrato orizzontalmente
`1.0`	Allineato a destra

Può essere un valore qualsiasi fra 0.0 e 1.0.

output.size.align_y

Mobile, 0.0 a 1.0, default: 0.5

Allineamento verticale per output.size.aspect_ratio = preserve_inset o preserve_overflow.

Valore	Allineamento verticale
`0.0`	Allineato in alto
`0.5`	Centrato verticalmente
`1.0`	Allineato in fondo

Può essere un valore qualsiasi fra 0.0 e 1.0.

output.size.input_dpi

Mobile, 1.0 a 1000000.0
Facoltativo

I DPI dell'immagine di input sono letti dal file quando disponibile. Questo parametro ti consente di ignorare quel valore. Il valore che ne risulta viene usato per calcolare le dimensioni fisiche dell'immagine di input, che viene usata per calcolare le dimensioni dell'output se sono specificate unità fisiche per l'output, ma non una larghezza o altezza esplicita.

output.size.output_dpi

Mobile, 1.0 a 1000000.0
Facoltativo

DPI dell'immagine di output. Viene usato per calcolare le dimensioni pixel dell'output bitmap quando sono specificate unità fisiche.

Scaricamento `POST`
`https://api.vectorizer.ai/api/v1/download`

Questo endpoint consente di:

Scaricare il risultato di produzione completo dopo una panoramica della chiamata API.

Includiamo un'intestazione X-Receipt nella risposta in modo che tu possa scaricare altri formati di output al prezzo di formato di scaricamento ridotto in seguito.
Scarica diversi formati di output per la stessa immagine e utilizza varie opzioni di elaborazione a un prezzo ridotto e senza vettorializzare tutto da zero.

Parametri

image.token

Facoltativo

Un Image Token restituito nell'intestazione X-Image-Token in una chiamata di vettorializzazione API precedente ove policy.retention_days > 0.

receipt

Stringa
Facoltativo

Una ricevuta, inclusa nell'intestazione X-Receipt in una chiamata di scaricamento API precedente in cui hai aggiornato una panoramica a risultato di produzione.

Quando invii un Image Token devi includere la ricevuta per ottenere il prezzo di formato scaricamento ridotto.

Num, default: svg

Formato file output.

Opzioni SVG:

output.svg.version `svg_1_0` `svg_1_1` `svg_tiny_1_2` Num, default: `svg_1_1`	Specifica l'attributo della versione SVG nel tag SVG. Dettagli
output.svg.fixed_size `true` `false` Booleano, default: `false`	Se includere gli attributi delle dimensioni dell'immagine nel tag SVG. Quando `true` i visualizzatori in genere produrranno l'SVG a una velocità fissa. Quando `false` i visualizzatori in genere consentono a SVG la riduzione in scala per adattarsi allo spazio disponibile. Dettagli
output.svg.adobe_compatibility_mode `true` `false` Booleano, default: `false`	Quando `true` disattiviamo le opzioni che Adobe Illustrator non può importare. Dettagli

Opzioni DFX:

output.dxf.compatibility_level `lines_only` `lines_and_arcs` `lines_arcs_and_splines` Num, default: `lines_and_arcs`	I lettori DFX variano molto in termini di capacità. Questa opzione ti consente di limitare l'output alle primitive di disegno che il tuo lettore DFX supporta effettivamente. Dettagli

Opzioni bitmap:

Applicabile solamente quando output.file_format=png

output.bitmap.anti_aliasing_mode
anti_aliased aliased

Num, default: anti_aliased

Value	Anti-Aliasing Mode
`anti_aliased`	I pixel lungo il confine fra le forme hanno i loro colori fusi secondo la frazione dell'area dei pixel coperta da ciascuna forma.
`aliased`	Ai pixel viene assegnato il colore della forma che contiene il centro geometrico del pixel.

output.draw_style
fill_shapes stroke_shapes stroke_edges

Num, default: fill_shapes

output.shape_stacking
cutouts stacked

Num, default: cutouts

Determina se le forme sono collocate in ritagli nelle forme qui sotto (cutouts) o se sono sovrapposte l'una sull'altra (stacked). Dettagli

output.group_by
none color parent layer

Num, default: none

Value	Shape grouping
`none`	Nessun raggruppamento
`color`	Per colore, interagisce con `output.shape_stacking`
`parent`	Per forma contenitore
`layer`	Per livello di ordine disegno

Dettagli

output.parameterized_shapes.flatten
true false

Booleano, default: false

Appiattisci cerchi, ellissi, rettangoli, triangoli e stelle identificati in curve ordinarie. Dettagli

Curve:

output.curves.allowed.quadratic_bezier `true` `false` Booleano, default: `true`	Se consentire le Curve di Bézier quadratiche. Dettagli
output.curves.allowed.cubic_bezier `true` `false` Booleano, default: `true`	Se consentire le Curve di Bézier cubiche. Dettagli
output.curves.allowed.circular_arc `true` `false` Booleano, default: `true`	Se consentire gli Archi circolari. Dettagli
output.curves.allowed.elliptical_arc `true` `false` Booleano, default: `true`	Se consentire gli Archi ellittici. Dettagli
output.curves.line_fit_tolerance Mobile, `0.001` a `1.0`, default: `0.1`	In genere tentiamo di sostituire i tipi di curva no consentiti con i tipi di curva consentiti. See the details for the precise fallback sequences. Tuttavia, se non consenti un numero sufficiente di tipi di curva dovremo approssimarli con segmenti di riga. Questo parametro specifica la distanza massima in pixel fra una curva e le righe che la approssimano. Dettagli

Gap Filler:

output.gap_filler.enabled `true` `false` Booleano, default: `true`	Se lavorare attorno alla riga bianca che produce bug comuni nei visualizzatori vettoriali. Dettagli
output.gap_filler.clip `true` `false` Booleano, default: `false`	Se tagliare i tratti del gap filler. Quando `output.shape_stacking=stacked` taglia o usa tratti senza scala. Dettagli
output.gap_filler.non_scaling_stroke `true` `false` Booleano, default: `true`	Se usare tratti di gap filler senza scala. Quando `output.shape_stacking=stacked` taglia o usa tratti senza scala. Dettagli
output.gap_filler.stroke_width Mobile, `0.0` a `5.0`, default: `2.0`	Larghezza dei tratti del gap filler. Dettagli

Stile di tratti quando output.draw_style è stroke_shapes o stroke_edges

output.strokes.non_scaling_stroke `true` `false` Booleano, default: `true`	Se usare tratti senza scala. Dettagli
output.strokes.use_override_color `true` `false` Booleano, default: `false`	Se usare il colore di override, o il colore stimato della forma. Dettagli
output.strokes.override_color Formato: '#RRGGBB', e.g. `#FF00FF`, default: `#000000`	Colore di override. Dettagli
output.strokes.stroke_width Mobile, `0.0` a `5.0`, default: `1.0`	Ampiezza del tratto. Dettagli

Dimensioni output:

output.size.scale

Mobile, 0.0 a 1000.0
Facoltativo

Fattore di scala uniforme. Se specificato, ha la precedenza su output.size.width e output.size.height.

output.size.width

Mobile, 0.0 a 1.0E12
Facoltativo

Larghezza in unità specificate da output.size.unit. Se è specificata solo la larghezza o l'altezza, l'altra dimensione viene calcolata automaticamente per mantenere il rapporto aspetto.

output.size.height

Mobile, 0.0 a 1.0E12
Facoltativo

Altezza in unità specificate da output.size.unit. Se è specificata solo la larghezza o l'altezza, l'altra dimensione viene calcolata automaticamente per mantenere il rapporto aspetto.

Num, default: none

output.size.aspect_ratio
preserve_inset preserve_overflow stretch

Num, default: preserve_inset

Valore	Regola della scala
`preserve_inset`	Scala uniforme per adattare la dimensione più stretta, in modo che non vi sia fuoriuscita ma spazio vuoto nell'altra dimensione
`preserve_overflow`	Scala uniforme per adattare la dimensione meno stretta, con espansione nella dimensione più stretta
`stretch`	Scala non uniforme per adattare la larghezza e altezza specificate

Per l'una o l'altra preserve opzione, la posizione nella dimensione non limitata è controllata da output.size.align_x o output.size.align_y.

output.size.align_x

Mobile, 0.0 a 1.0, default: 0.5

Allineamento orizzontale per output.size.aspect_ratio = preserve_inset o preserve_overflow.

Valore	Allineamento orizzontale
`0.0`	Allineato a sinistra
`0.5`	Centrato orizzontalmente
`1.0`	Allineato a destra

Può essere un valore qualsiasi fra 0.0 e 1.0.

output.size.align_y

Mobile, 0.0 a 1.0, default: 0.5

Allineamento verticale per output.size.aspect_ratio = preserve_inset o preserve_overflow.

Valore	Allineamento verticale
`0.0`	Allineato in alto
`0.5`	Centrato verticalmente
`1.0`	Allineato in fondo

Può essere un valore qualsiasi fra 0.0 e 1.0.

output.size.input_dpi

Mobile, 1.0 a 1000000.0
Facoltativo

output.size.output_dpi

Mobile, 1.0 a 1000000.0
Facoltativo

DPI dell'immagine di output. Viene usato per calcolare le dimensioni pixel dell'output bitmap quando sono specificate unità fisiche.

Elimina `POST`
`https://api.vectorizer.ai/api/v1/delete`

Immagini vettorializzate con policy.retention_days > 0 sono conservate per il periodo di tempo richiesto ed eliminate automaticamente subito dopo.

In genere non è necessario chiamare questo endpoint. Viene fornito in modo che tu possa eliminare immagini prima della scadenza del periodo di conservazione. L'eliminazione anticipata di un'immagine non risulta in un rimborso dei giorni di archiviazione rimasti.

Parametri
image.token Facoltativo	Un Image Token restituito nell'intestazione `X-Image-Token` in una chiamata di vettorializzazione API precedente ove `policy.retention_days > 0`.

Attributi della risposta
success	`true` L'Image Token è stato definitivamente eliminato.

Esempio di risposta

{
  "success" : true
}

Stato conto `GET`
`https://api.vectorizer.ai/api/v1/account`

Ottieni informazioni di base sul tuo account, come lo status del tuo abbonamento e il numero di crediti rimanenti.

Parametri
Nessuna

Attributi della risposta
subscriptionPlan	Il piano a cui sei attualmente abbonato, o 'nessuno'.
subscriptionState	Lo stato del tuo attuale abbonamento ('attivo' o 'scaduto') o 'terminato' se non sei abbonato.
credits	Il numero di crediti API rimasti nel tuo account. 0 se non sei attualmente abbonato, o sei abbonato a un piano non-API. Può essere frazionario, assicurati di analizzare come un Doppio.

Prova

https://api.vectorizer.ai/api/v1/account

Nome utente = Id API, Password = Segreto API

cURL

$ curl "https://api.vectorizer.ai/api/v1/account" \
 -u vkyc67kqa27yidd:[secret]

Esempio di risposta

{
  "subscriptionPlan" : "none",
  "subscriptionState" : "ended",
  "credits" : 0
}

Changelog API

Data	Modifica
4 nov 2024	Aggiunto `processing.shapes.min_area_px`.
1 ott 2024	Aggiunta di un chatbot AI come ausilio nell'integrazione con l'API.
23 set 2024	API notevolmente ampliato per consentire altre modalità di utilizzo. Aggiunti Image Token, Ricevute, intestazioni di addebito per chiamata, e gli endpoint Scaricamento ed Eliminazione.
11 giu 2024	Aggiunto `processing.palette`
4 mar 2024	Aggiunta sezione sui timeout.
24 gen 2024	Aggiunto endpoint Stato Account. Errori recenti API aggiunti alla pagina Account. Aggiunto Elenco di tutte le risposte di errore dell'API.
16 gen 2024	Errore JSON oggetto documentato.
3 ott 2023	Chiarito che `output.gap_filler.enabled=true` porta a più colori nel risultato di quanto richiesto in `processing.max_colors`.
20 set 2023	Aggiunto `mode`
1 ago 2023	Aggiunto un gruppo opzioni di dimensione di output con tutte le caratteristiche con le seguenti opzioni: `output.size.scale`, `output.size.width`, `output.size.height`, `output.size.unit`, `output.size.aspect_ratio`, `output.size.align_x`, `output.size.align_y`, `output.size.input_dpi` e `output.size.output_dpi`. Aggiunto gruppo di opzioni di output bitmap con un'opzione: `output.bitmap.anti_aliasing_mode`.
7 giu 2023	Aggiunto `processing.max_colors`
31 mag 2023	Ha ampliato notevolmente i parametri API. Endpoint API aggiornato.
10 mar 2023	Release iniziale.

Ottieni chiave API

API vettorializzazione immmagine

Avvio rapido

Chatbot API

Come usare questo API

Immagine singola Inoltra un bitmap, ottieni un risultato vettoriale, fatto

Anteprima prima Mostra un'anteprima al tuo possibile cliente prima dell'acquisto

Multiformato Per esempio hai bisogno di risultati PNG e SVG.

Multiopzione Devi elaborare ogni immagine con multiple opzioni di elaborazione.

Livelli di prezzi

Autenticazione e Sicurezza

Limitazione di velocità

Timeout

Errore JSON

Intestazioni risposta

Vettorializza POST https://api.vectorizer.ai/api/v1/vectorize

Esempi

Colori

Tolleranza

Scaricamento POST https://api.vectorizer.ai/api/v1/download

Elimina POST https://api.vectorizer.ai/api/v1/delete

Stato conto GET https://api.vectorizer.ai/api/v1/account

Changelog API

Vettorializza `POST`
`https://api.vectorizer.ai/api/v1/vectorize`

Scaricamento `POST`
`https://api.vectorizer.ai/api/v1/download`

Elimina `POST`
`https://api.vectorizer.ai/api/v1/delete`

Stato conto `GET`
`https://api.vectorizer.ai/api/v1/account`