Recraft
Recraft Vectorize
Convert an existing raster image into SVG paths. Choose standard tracing or the Pro vectorizer for smoother curves and sharper corners.
recraft/recraft-vectorizeBest for
- Recover editable shapes from a raster logo
- Turn a flat illustration into scalable artwork for print
Technical details
Read the model documentation- API model ID
recraft/recraft-vectorize- Provider
- Recraft
- Modality
- Image
- Input
- Images
- Output
- Image
- Endpoint
POST /v2/jobs- Workflow
- Vectorize
Request parameters
image_urlstring · RequiredA public https URL of the input image: PNG, JPEG or WEBP, under 20 MB and at most 16 megapixels, its longest side at most 4096 pixels and its shortest at least 256.
color_reductionstring`on` or `off`: reduce the number of colors in the SVG.
- on
- off
limit_num_shapesstring`on` or `off`: cap the number of shapes at `max_num_shapes`.
- on
- off
max_num_colorsintegerThe most colors the SVG may use.
0–4294967295
max_num_shapesintegerThe most shapes the SVG may hold.
0–4294967295
Additional parameters
return_gradientsstring`on` or `off`: keep gradients in the SVG.
- on
- off
shape_stackingstring`hierarchical` (the default): shapes are layered and partly covered by the ones above; `cut_out`: shapes do not overlap.
- hierarchical
- cut_out
small_shape_filterstring`on` or `off`: drop very small shapes.
- on
- off
strict_color_palettearrayA palette the SVG is held to: a list of colors, each a list of red, green, blue whole numbers (for example `[[255, 0, 0], [255, 255, 255]]`).
svg_compressionstring`on` or `off`: compress the SVG file.
- on
- off
versionstring`v1` (the default), the standard vectorizer, or `v1_pro`, cleaner SVGs with smooth curves, straight lines and sharp corners, priced higher.
- v1
- v1_pro
zdrbooleanWhen enabled, Recraft skips logging or storing your input image. Recraft still stores the output to serve its URL. ZDR adds no charge.
Pricing
| Billable unit and options | Rate (USD) |
|---|---|
| Per requestversion: v1 | $0.01 |
| Per requestversion: v1_pro | $0.04 |
Billing notes
- One image in, one result out: billed per request.
- Leaving out version gives v1.
Catalogue rates on 21 Nov 2026. Prices exclude VAT.
View in pricing catalogue