API Documentation
The topvecto REST API converts raster images into SVG vectors. Base URL: https://api.topvecto.com/v1
API Keys
Create and manage your keys from the Dashboard. Each key starts with tv_live_ and is shown only once.
- • Up to 10 keys per account.
- • Revoke instantly — takes effect on the next request.
- • Treat keys like passwords. Never commit them to source control.
Authentication
All requests require a bearer token in the Authorization header.
bash
curl https://api.topvecto.com/v1/vectorize \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@logo.png"Usage limits
Monthly request quotas by plan, resets on the 1st.
| Plan | Requests / month | Concurrent |
|---|---|---|
| Free | 50 | 1 |
| Pro | 5,000 | 5 |
| Business | 50,000 | 20 |
Exceeding the monthly quota returns 402 Payment Required.
POST
/vectorizeConvert an image to SVG
Accepts multipart form data with a single file field.
Parameters
file— required. PNG, JPG, WEBP, or BMP. Max 10MB.threshold— optional, 0-255. Edge detection threshold.color— optional, boolean. Multi-color tracing.background— optional, "remove" to drop the background.
Example response
json
{
"id": "conv_a1B2c3",
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" ...>",
"credits_remaining": 487
}Webhooks
Subscribe to conversion.completed to receive results asynchronously.
Errors
400— invalid input401— missing or invalid API key402— out of credits429— rate limited500— internal error