SAPPHIRE
API STATUS: STABLE v1.2

API Documentation

Quick Start

Vectorize Endpoint

POST
https://vectorizer.sapphiresc.com/api/vectorize

Authentication

Include your API key in the Authorization header. Keys can be generated in the Dashboard.

Authorization: Bearer YOUR_API_KEY

cURL Example

curl -X POST https://vectorizer.sapphiresc.com/api/vectorize \
  -H "Authorization: Bearer sk_live_..." \
  -F "file=@design_pattern.png" \
  -F "mode=textile_precise"

Request Parameters

ParameterTypeRequiredDescription
fileBinaryYesInput image (PNG, JPG, TIFF, WebP). Max 50MB.
modeStringNoProcessing strategy: textile_precise (default), illustration, or archival.
colorsIntegerNoLimit output palette size (e.g., 8, 16, 256). Default: Auto.

Response Object

{
  "id": "vec_8f92a10c",
  "status": "completed",
  "data": {
    "svg_url": "https://cdn.sapphiresc.com/vectors/...",
    "preview_url": "https://cdn.sapphiresc.com/previews/...",
    "metrics": {
      "ssim": 0.982,
      "path_count": 4521,
      "process_time_ms": 1240
    }
  }
}

OpenAPI Specification

For full schema details, usage policies, and error codes:

Download openapi.json