VectoSolve Python SDK

Official Python client for the VectoSolve API — AI-powered image vectorization, background removal, upscaling, and SVG generation.

Installation

pip install vectosolve

Quick Start

from vectosolve import VectoSolve

client = VectoSolve(api_key="vs_your_api_key")

# Convert an image to SVG
result = client.vectorize("photo.png")
result.save("output.svg")
print(f"Credits remaining: {result.credits.remaining}")

Get your API key at vectosolve.com/dashboard.

Features

Usage

Vectorize (Image to SVG)

# From a local file
result = client.vectorize("photo.png")
result.save("output.svg")

# From a URL
result = client.vectorize("https://example.com/image.png")
print(result.svg)  # Raw SVG string

Remove Background

result = client.remove_background("product.jpg")
print(result.image_url)  # URL of the processed image

Upscale

result = client.upscale("small-image.png")
print(result.image_url)

Generate SVG from Text

result = client.generate_svg(
    "a golden retriever playing fetch in a park",
    style="vector_illustration",
    size="1024x1024",
    colors=["#f4a460", "#228b22", "#87ceeb"],
)
result.save("dog.svg")

Available styles: vector_illustration, vector_illustration/line_art, vector_illustration/engraving, vector_illustration/linocut, vector_illustration/bold_stroke, vector_illustration/colored_stencil, vector_illustration/thin, vector_illustration/mosaic, vector_illustration/flat_2

Available sizes: 1024x1024, 1024x1536, 1536x1024

Generate Logo

result = client.generate_logo(
    "minimalist coffee shop logo with a steaming cup",
    model="v3",
    num_variants=4,
    colors=["#6f4e37", "#f5f5dc"],
)

for i, logo in enumerate(result.logos):
    logo.save(f"logo_{i}.svg")

Generate Pattern

result = client.generate_pattern(
    "tropical leaves and flowers",
    colors=["#2d5016", "#ff6b6b", "#ffd93d"],
)
print(result.image_url)

Batch Processing

result = client.batch([
    {"url": "https://example.com/photo1.png", "operation": "vectorize"},
    {"url": "https://example.com/photo2.jpg", "operation": "remove_bg"},
    {"url": "https://example.com/photo3.png", "operation": "upscale"},
])

for item in result.results:
    if item.success:
        print(f"[{item.index}] {item.operation}: {item.url}")
    else:
        print(f"[{item.index}] Failed: {item.error}")

print(f"Processed: {result.total_processed}, Failed: {result.total_failed}")

Environment Variable

Instead of passing the API key directly, you can set it as an environment variable:

export VECTOSOLVE_API_KEY="vs_your_api_key"

client = VectoSolve()  # Automatically reads VECTOSOLVE_API_KEY

Error Handling

from vectosolve import (
    VectoSolve,
    AuthenticationError,
    InsufficientCreditsError,
    RateLimitError,
    ValidationError,
)

client = VectoSolve(api_key="vs_your_api_key")

try:
    result = client.vectorize("image.png")
except AuthenticationError:
    print("Invalid API key")
except InsufficientCreditsError as e:
    print(f"Need {e.required} credits — top up at vectosolve.com/pricing")
except RateLimitError as e:
    print(f"Rate limited — retry after {e.retry_after}s")
except ValidationError as e:
    print(f"Bad request: {e.message}")

Context Manager

with VectoSolve(api_key="vs_your_api_key") as client:
    result = client.vectorize("photo.png")
    result.save("output.svg")
# Connection automatically closed

Use Cases

• Cricut & Silhouette — Convert designs to cut-ready SVGs
• Laser cutting — Vectorize artwork for laser engravers
• Embroidery — Convert images for embroidery machines
• E-commerce — Remove backgrounds from product photos
• Design automation — Generate logos and patterns programmatically

Links

• API Documentation
• Dashboard & API Keys
• Pricing
• GitHub

License

MIT