# Recraft Vectorize

`recraft/recraft-vectorize` · Recraft · image

Convert an existing raster image into SVG paths. Choose standard tracing or the Pro vectorizer for smoother curves and sharper corners.

[Model page](https://sociaro.com/models/recraft/recraft-vectorize) · [JSON](https://sociaro.com/models/recraft/recraft-vectorize.json) · [Model pricing](https://sociaro.com/pricing?model=recraft%2Frecraft-vectorize) · [Documentation](https://docs.sociaro.com/models/recraft-recraft-vectorize/) · [Playground](https://my.sociaro.com/playground/?model=recraft/recraft-vectorize)

## Use cases

- Recover editable shapes from a raster logo
- Turn a flat illustration into scalable artwork for print

## Technical details

- API model ID — recraft/recraft-vectorize
- Provider — Recraft
- Modality — Image
- Input — Images
- Output — Image
- Endpoint — POST /v2/jobs
- Workflow — Vectorize

## Request parameters

- `image_url` (string, required) — A 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.
- `version` (string) — `v1` (the default), the standard vectorizer, or `v1_pro`, cleaner SVGs with smooth curves, straight lines and sharp corners, priced higher.
  - Allowed values — `v1`, `v1_pro`
- `shape_stacking` (string) — `hierarchical` (the default): shapes are layered and partly covered by the ones above; `cut_out`: shapes do not overlap.
  - Allowed values — `hierarchical`, `cut_out`
- `color_reduction` (string) — `on` or `off`: reduce the number of colors in the SVG.
  - Allowed values — `on`, `off`
- `limit_num_shapes` (string) — `on` or `off`: cap the number of shapes at `max_num_shapes`.
  - Allowed values — `on`, `off`
- `max_num_colors` (integer) — The most colors the SVG may use.
  - 0–4294967295
- `max_num_shapes` (integer) — The most shapes the SVG may hold.
  - 0–4294967295
- `return_gradients` (string) — `on` or `off`: keep gradients in the SVG.
  - Allowed values — `on`, `off`
- `small_shape_filter` (string) — `on` or `off`: drop very small shapes.
  - Allowed values — `on`, `off`
- `strict_color_palette` (array) — A 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_compression` (string) — `on` or `off`: compress the SVG file.
  - Allowed values — `on`, `off`
- `zdr` (boolean) — When enabled, Recraft skips logging or storing your input image. Recraft still stores the output to serve its URL. ZDR adds no charge.

## Pricing

Rates in USD. Catalogue timestamp 2026-11-21T02:23:44Z.

- USD 0.01 per request · version: v1 · active
- USD 0.04 per request · version: v1_pro · active

- One image in, one result out: billed per request.
- Leaving out version gives v1.

## Examples

### Cherries in four inks

A four-colour raster fruit label becomes an SVG with smooth curves around the fruit, leaf and stems.

[Result (image)](https://previews.sociaro.com/shared/promo/gallery/creative/cherries.svg)

Source inputs

- [Four-colour raster input (image)](https://previews.sociaro.com/shared/promo/gallery/creative/cherries-input.png)
