Conversion API

Authentication

Include your API key in the Authorization header:

Authorization: Bearer your_api_key_here

Get your API key from the Studio dashboard.

Convert Image

Upload an image and receive machine-ready embroidery files (DST + PES) with a stitch preview.

Request

Content-Type: multipart/form-data

Example (cURL)

curl -X POST https://d3vur.app/api/v1/convert \
  -H "Authorization: Bearer your_api_key" \
  -F "[email protected]"

Example (Python)

import requests

resp = requests.post(
    "https://d3vur.app/api/v1/convert",
    headers={"Authorization": "Bearer your_api_key"},
    files={"file": open("logo.png", "rb")},
)

data = resp.json()
print(f"Stitches: {data['stitch_count']}")
print(f"DST: {data['files']['dst']}")
print(f"PES: {data['files']['pes']}")

Response

{
  "job_id": "43c4e7a8-368d-4654-8b2a-8e3acc94a414",
  "status": "completed",
  "stitch_count": 846,
  "color_count": 1,
  "estimated_minutes": 1.2,
  "files": {
    "dst": "https://...supabase.co/.../design.dst",
    "pes": "https://...supabase.co/.../design.pes",
    "preview": "https://...supabase.co/.../preview.png"
  },
  "meta": {
    "dst_size_bytes": 3062,
    "pes_size_bytes": 6201,
    "duration_ms": 1498
  }
}

Rate Limits