VectoSolve API-tutorial: beeldvectorisatie automatiseren voor ontwikkelaars
Leer hoe je de VectoSolve API integreert in je applicaties. Complete handleiding met codevoorbeelden in Node.js, Python en PHP plus automatiseringsworkflows.
Founder of VectoSolve
Self-taught developer, founder and sole developer of VectoSolve since 2024. He builds the conversion engine and the cutting, embroidery and 3D printing exports.
How this article was made: drafted with AI assistance, then edited and fact-checked before publication. About the author
Key Takeaways
- De VectoSolve API converteert rasterafbeeldingen programmatisch naar schone SVG's voor $0.20 per conversie (credits verlopen nooit)
-
Eenvoudig REST-endpoint:
POST https://vectosolve.com/api/v1/vectorizemet Bearer token-authenticatie en multipart form-data -
Voeg
removeBackground=truetoe voor extra $0.07 om achtergronden automatisch te verwijderen vóór vectorisatie - De snelheidslimiet is 60 verzoeken/minuut — gebruik exponentiële backoff en batchqueues voor grote opdrachten
- Integreert met n8n, Zapier en AI-agentplatformen voor volledig geautomatiseerde vectorisatieworkflows
Of je nu een SaaS-product bouwt, designworkflows automatiseert of duizenden afbeeldingen verwerkt, de VectoSolve API laat je rasterafbeeldingen programmatisch converteren naar schone SVG-vectoren. Deze handleiding behandelt alles van je eerste API-aanroep tot geavanceerde integraties.
Waarom de VectoSolve API gebruiken?
Handmatige beeldconversie schaalt niet. De VectoSolve API maakt het volgende mogelijk:
- Batchverwerking — Honderden afbeeldingen automatisch converteren
- SaaS-integratie — Vectorisatie aan je product toevoegen
- Workflowautomatisering — Verbinden met n8n, Zapier of OpenClaw
- Consistente kwaliteit — Elke keer dezelfde AI-gestuurde resultaten
Aan de slag
Stap 1: Je API-sleutel aanmaken
Ga naar je API-sleutels dashboard en klik op "Nieuwe sleutel aanmaken". Geef het een beschrijvende naam zoals "Productie" of "Test".
Belangrijk: Kopieer je API-sleutel onmiddellijk — deze wordt om beveiligingsredenen niet opnieuw getoond.
Stap 2: Credits toevoegen
Elke API-conversie kost $0.20. Neem een abonnement via de prijspagina. Credits verlopen nooit, koop wat je nodig hebt.
Stap 3: Je eerste verzoek doen
Het API-endpoint accepteert POST-verzoeken met je afbeelding als form-data:
POST https://vectosolve.com/api/v1/vectorize
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
Pro Tip: Test je API-sleutel met een eenvoudig cURL-commando voordat je je integratie opbouwt. Dit bevestigt dat je sleutel geldig is, je credits hebt en het endpoint bereikbaar is vanuit je omgeving. Het kost 10 seconden en bespaart uren debuggen.
Codevoorbeelden
cURL
curl -X POST https://vectosolve.com/api/v1/vectorize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@image.png" \
-F "removeBackground=false"
Node.js
const FormData = require('form-data');
const fs = require('fs');
const fetch = require('node-fetch');
async function vectorize(imagePath, apiKey) {
const formData = new FormData();
formData.append('file', fs.createReadStream(imagePath));
formData.append('removeBackground', 'false');
const response = await fetch('https://vectosolve.com/api/v1/vectorize', {
method: 'POST',
headers: {
'Authorization': `Bearer ${apiKey}`,
},
body: formData,
});
const result = await response.json();
if (result.success) {
console.log('SVG URL:', result.svgUrl);
console.log('Credits remaining:', result.credits.remaining);
return result.svg;
} else {
throw new Error(result.error);
}
}
// Usage
vectorize('./logo.png', 'YOUR_API_KEY');
Python
import requests
def vectorize(image_path, api_key):
url = "https://vectosolve.com/api/v1/vectorize"
with open(image_path, 'rb') as f:
files = {'file': f}
data = {'removeBackground': 'false'}
headers = {'Authorization': f'Bearer {api_key}'}
response = requests.post(url, files=files, data=data, headers=headers)
result = response.json()
if result.get('success'):
print(f"SVG URL: {result['svgUrl']}")
print(f"Credits remaining: {result['credits']['remaining']}")
return result['svg']
else:
raise Exception(result.get('error'))
# Usage
svg = vectorize('./logo.png', 'YOUR_API_KEY')
PHP
<?php
function vectorize($imagePath, $apiKey) {
$url = 'https://vectosolve.com/api/v1/vectorize';
$curl = curl_init();
$postFields = [
'file' => new CURLFile($imagePath),
'removeBackground' => 'false'
];
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $postFields,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey
]
]);
$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response, true);
if ($result['success']) {
echo "SVG URL: " . $result['svgUrl'] . "\n";
return $result['svg'];
} else {
throw new Exception($result['error']);
}
}
// Usage
$svg = vectorize('./logo.png', 'YOUR_API_KEY');
?>
A Full Year of Conversions for $49
Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime
Get the Annual DealAPI-responsformaat
Een succesvolle respons ziet er zo uit:
{
"success": true,
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\"...>",
"svgUrl": "https://vectosolve.com/api/files/abc123.svg",
"backgroundRemoved": false,
"credits": {
"cost": 0.20,
"remaining": 9.80
}
}
Foutafhandeling
De API retourneert standaard HTTP-statuscodes:
| Code | Betekenis | Oplossing |
|---|---|---|
| 401 | Ongeldige API-sleutel | Controleer je Authorization-header |
| 402 | Onvoldoende credits | Koop meer credits |
| 403 | Abonnement vereist | Upgrade je plan |
| 429 | Snelheidslimiet overschreden | Wacht en probeer opnieuw (60 verz./min) |
| 500 | Serverfout | Probeer opnieuw of neem contact op met support |
"De beste API's zijn degene die je niet in de weg staan. Upload een bestand, krijg een SVG terug — geen configuratie, geen gedoe met parameters.
Geavanceerd: Achtergrondverwijdering
Voeg removeBackground=true toe om achtergronden automatisch te verwijderen vóór vectorisatie. Dit kost $0.07 extra per verzoek:
curl -X POST https://vectosolve.com/api/v1/vectorize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@photo.jpg" \
-F "removeBackground=true"
Free SVG Tools for Crafters
Design Checker · Color Separator · Mat Preview · Offset Generator · Text to SVG
Check Your SVG FreeAutomatiseringsintegraties
n8n-workflow
n8n is een krachtig workflowautomatiseringstool. Om VectoSolve te integreren:
- Voeg een HTTP Request-knooppunt toe
- Stel de methode in op POST
- URL:
https://vectosolve.com/api/v1/vectorize - Authenticatie: Header Auth
- Headernaam:
Authorization - Headerwaarde:
Bearer YOUR_API_KEY - Body Content Type: Form-Data
- Voeg parameter
filetoe met je binaire invoer
Zapier
Gebruik "Webhooks by Zapier" om VectoSolve te verbinden met 5.000+ apps:
- Voeg een Webhooks by Zapier-actie toe
- Kies POST-verzoek
- URL:
https://vectosolve.com/api/v1/vectorize - Voeg header toe:
Authorization: Bearer YOUR_API_KEY - Payloadtype: Form
- Koppel je bestandsveld van de trigger
OpenClaw / AI-agenten
Voor AI-gestuurde automatiseringstools zoals OpenClaw:
- Maak een API-sleutel aan in je VectoSolve-dashboard
- Voeg een nieuwe HTTP-tool toe aan je AI-agent
- Configureer het POST-verzoek zoals hierboven getoond
- Parse de JSON-respons om
svgofsvgUrlte extraheren
Voor batchopdrachten met hoog volume (1.000+ afbeeldingen), implementeer een op wachtrijen gebaseerde architectuur: duw conversieverzoeken naar een wachtrij, verwerk ze met snelheidslimietbewuste workers (max 60/min), en sla resultaten op in je eigen opslag. Dit voorkomt time-outs en zorgt ervoor dat elke afbeelding betrouwbaar wordt verwerkt.
Snelheidslimieten en best practices
- Snelheidslimiet: 60 verzoeken per minuut
- Max bestandsgrootte: 5 MB
- Ondersteunde formaten: PNG, JPG, JPEG, WEBP, GIF
- Credits: Verlopen nooit
Tips voor batchverwerking:
- Implementeer exponentiële backoff voor snelheidslimieten
- Zet verzoeken in de wachtrij en verwerk in batches van 50
- Cache resultaten om dezelfde afbeelding niet opnieuw te converteren
- Gebruik webhooks voor grote batchopdrachten
Veelgestelde vragen
Hoeveel kost de API?
Elke conversie kost $0.20. Achtergrondverwijdering voegt $0.07 toe. Koop credits in bulk om te besparen — ze verlopen nooit.
Welke beeldformaten worden ondersteund?
PNG, JPG, JPEG, WEBP en GIF. De maximale bestandsgrootte is 5 MB.
Verlopen credits?
Nee! Eenmaal gekocht, blijven credits voor altijd op je account tot ze worden gebruikt.
Wat is de snelheidslimiet?
60 verzoeken per minuut. Neem contact met ons op voor enterprise-plannen met hogere limieten.
Kan ik de API gebruiken in commerciële producten?
Ja! Je kunt de VectoSolve API integreren in je commerciële applicaties, SaaS-producten of klantprojecten.
A Full Year of Conversions for $49
Starter Annual: 25 conversions every month, $49 for the whole year. That is about $4.08 a month · Cancel anytime
Get the Annual DealHulp nodig?
Bekijk deze bronnen:
- API-sleutels dashboard — Beheer je sleutels en bekijk het gebruik
- FAQ — Veelgestelde vragen beantwoord
- Prijzen — Maand- en jaarabonnementen
Klaar om te beginnen? Haal je API-sleutel op en converteer je eerste afbeelding in seconden!
| API-parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
| image | File (multipart) | Vereist | PNG, JPG of WebP tot 10 MB |
| removeBackground | Boolean | false | AI-achtergrondverwijdering vóór vectorisatie |
| colorMode | String | "color" | "color", "grayscale" of "blackwhite" |
| detailLevel | String | "medium" | Padcomplexiteit: "low", "medium" of "high" |
| outputFormat | String | "svg" | Uitvoerformaat: "svg" of "eps" |
Bronnen en verder lezen
- MDN Web Docs — Fetch API — Referentie voor HTTP-verzoeken met multipart form-data, gebruikt in de API-integratievoorbeelden
- Google AI Blog — Image Processing APIs — Inzichten in AI-gestuurde beeldverwerking, REST API-designpatronen en schaalbare cloudarchitecturen
- Smashing Magazine — API Integration — Ontwikkelaarshandleidingen voor het consumeren van REST API's in Node.js, Python en frontend JavaScript
- W3C SVG 2 Specification — Officiële SVG-standaard voor het begrijpen van het uitvoerformaat van vectorisatie-API-responses