API v1

Documentation

RESTful API for converting raster images to SVG. Returns optimized vector paths.

BASE URL
weavstudio.goldgroove06.xyz
VERSION
v1
FORMAT
SVG

Authentication

All requests require Bearer token authentication. Generate API keys in the dashboard.

HEADER REQUIRED
Authorization: Bearer YOUR_API_KEY
Security

Never expose API keys in client code or public repositories. Rotate keys if compromised.

Endpoint

POST/api/vectorize

Convert raster images to SVG using contour detection algorithms.

https://weavstudio.goldgroove06.xyz/api/vectorize

Parameters

urlREQUIREDstring

Publicly accessible URL of the image to vectorize.

Formats: PNG, JPG, WebP • Max: 10MB
solverOPTIONALintegerdefault: 0

Solver type: 0 (Binary) or 1 (Color).

Binary solver for simple black/white images, Color solver for multi-color images
color_countOPTIONALintegerdefault: 8

Number of colors to use in the output SVG (1-256, only for color solver).

Higher values preserve more color detail but increase file size
rawOPTIONALbooleandefault: false

Return raw SVG (true) or optimized SVG (false).

crop_boxOPTIONALarraydefault: null

Region to crop [x1, y1, x2, y2]. Useful for extracting specific parts of an image.

"crop_box": [100, 50, 400, 300]
presetOPTIONALstringdefault: null

Quality preset: "draft", "balanced", "high", or "ultra".

Controls the quality/performance tradeoff for vectorization
auto_optimizeOPTIONALbooleandefault: true

Enable automatic optimization of the vectorization process.

use_cacheOPTIONALbooleandefault: true

Use cached results if available for faster processing.

svg_optimizationOPTIONALstringdefault: "medium"

SVG optimization level: "none", "medium", or "high".

Higher optimization reduces file size but may take longer

Code Examples

curl -X POST https://weavstudio.goldgroove06.xyz/api/vectorize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/image.png",
    "solver": 1,
    "color_count": 12,
    "preset": "balanced",
    "svg_optimization": "medium",
    "raw": false
  }'

Response

SUCCESS (200) - JSON Format

When raw=false (default), returns JSON with SVG and metadata. 1 credit is deducted.

{
  "success": true,
  "timestamp": "2026-02-04T12:30:00.000Z",
  "data": {
    "job_id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "completed",
    "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\"...",
    "metadata": {
      "bounds": [0, 0, 800, 600],
      "image_width": 800,
      "image_height": 600,
      "solver": 1,
      "color_count": 12,
      "svg_size_bytes": 15420,
      "path_count": 45,
      "input_dimensions": "1920x1080",
      "estimated_input_colors": 256
    },
    "timings": {
      "Image Reading": 0.234,
      "Color Solver": 1.456,
      "SVG Markup": 0.089,
      "SVG Optimization": 0.045
    }
  }
}
SUCCESS (200) - Raw SVG Format

When raw=true, returns SVG content as plain text without JSON wrapper.

Content-Type: image/svg+xml

<svg xmlns="http://www.w3.org/2000/svg" ...>
  <path d="M..." fill="#..." />
  ...
</svg>

Error Codes

400
Bad Request
Invalid parameters or missing required fields
401
Unauthorized
Missing or invalid API key
402
Payment Required
Insufficient credits available
413
Payload Too Large
File exceeds 10MB limit
429
Rate Limited
Exceeded 10 requests per minute
500
Server Error
Processing failed (no credit deducted)

Rate Limits

STANDARD LIMIT
10/min
10 requests per minute for all plans
NEED MORE?

Contact support for custom rate limits

support@weavrn.com →

Pricing

STARTER
$10
75 credits
$0.13 per call
BUILDER
$20
180 credits
$0.11 per call
GROWTH
$50
500 credits
$0.10 per call
Upcoming Features
  • —Batch processing (multiple images per request)
  • —Webhook support for async processing
  • —Additional output formats (PDF, EPS)