Turn a sketch or line drawing into a clean vector SVG — centerline-traced, ready to edit in Illustrator.
/v1/generateworkflow: sketch_to_svg-v1One endpoint serves every workflow — this page documents sketch_to_svg-v1, the current version. Credits are debited at submission (1 cr standard, 1 cr pro); a failed generation is refunded automatically. Earlier versions of this endpoint, if any, keep being served under their own names.
| Parameter | Value for this workflow |
|---|---|
| workflow | "sketch_to_svg-v1" required |
| sketch_image | Sketch to vectorize — one public HTTPS URL.required |
| ratio | auto |
| tier | "standard" (1 cr) or "pro" (1 cr) |
| webhook_url | Optional — we POST the outcome here when the generation settles. Without it, poll the URL returned in the response until the status settles. |
curl -X POST https://thenewblack.ai/api/v1/generate \
-H "Authorization: Bearer tnb_live_XXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{
"workflow": "sketch_to_svg-v1",
"sketch_image": "https://example.com/sketch.jpg",
"ratio": "auto",
"tier": "standard"
}'// 202 Accepted
{
"generation_id": "3f1c9a6e-...",
"status": "running",
"poll": "/api/v1/generations/3f1c9a6e-..."
}Poll /v1/generations/{id} (or receive the webhook) until the generation settles:
// 200 OK
{
"generation_id": "3f1c9a6e-...",
"workflow": "sketch_to_svg",
"status": "succeeded",
"result": {
"type": "image",
"url": "https://.../result.webp",
"thumbnail": "https://.../thumb.webp"
}
}Results are stored for 48 hours — copy them to your own storage. Authentication, errors and webhooks are documented in the full API reference.
A vector SVG file traced from your sketch image — single centerlines rather than doubled outlines, so every stroke stays one editable path.
A clean line drawing on a light ground: flat sketches, croquis, technical drawings. Photographic shading has no vector equivalent and is ignored.
1 credit on the standard tier, 1 on pro. Credits come with plans and packs; a failed generation is always refunded.
Other endpoints: Virtual Try-On API · AI Fashion Models API · Fashion Design API · Reimagine Model API · Swap Model API · AI Stylist API · all endpoints