> ## Documentation Index
> Fetch the complete documentation index at: https://www.recraft.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vectorize

> Convert a raster image (PNG, JPG, or WEBP) into an editable SVG for \$0.01 per request with the standard vectorizer (`v1`), or \$0.04 with Vectorizer Pro (`v1_pro`).

Vectorize turns a raster image into a clean, editable SVG made of shapes. Use it to make logos, icons, and illustrations scalable, or to bring generated raster images into a vector workflow.

> [card] From \$0.01
>
> per request with the standard vectorizer, \$0.04 with Vectorizer Pro

> [card] PNG, JPG, WEBP → SVG
>
> up to 20 MB, 16 MP

> [card] POST /v1/images/vectorize
>
> endpoint

## Try it

Create a token in [API tokens](https://www.recraft.ai/app/api/api-keys) (it needs a positive API units balance) and set it once per terminal session:

```bash theme={null}
export RECRAFT_API_TOKEN=your_token
```

Then run. The request vectorizes a public sample illustration:

```bash cURL theme={null}
curl https://external.api.recraft.ai/v1/images/vectorize \
  -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png"
  }'
```

```python Python theme={null}
# pip install requests
import os

import requests

response = requests.post(
    'https://external.api.recraft.ai/v1/images/vectorize',
    headers={'Authorization': f"Bearer {os.environ['RECRAFT_API_TOKEN']}"},
    json={
        'image_url': 'https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png',
    },
)
if not response.ok:
    raise SystemExit(f'{response.status_code}: {response.text}')
print(response.json()['image']['url'])
```

```javascript JavaScript theme={null}
// Node.js 18+, run as an ES module (file.mjs)
const response = await fetch('https://external.api.recraft.ai/v1/images/vectorize', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RECRAFT_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image_url: 'https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png',
  }),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result.image.url);
```

```python Python (OpenAI SDK) theme={null}
# pip install openai
import os

from openai import OpenAI

client = OpenAI(
    base_url='https://external.api.recraft.ai/v1',
    api_key=os.environ['RECRAFT_API_TOKEN'],
)

response = client.post(
    path='/images/vectorize',
    cast_to=object,
    body={
        'image_url': 'https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png',
    },
)
print(response['image']['url'])
```

## Response

```json theme={null}
{
  "created": 1759140000,
  "credits": 10,
  "image": {
    "image_id": "0e6a1b8c-5b1f-4a8e-9f3a-2c7d4e8b9a10",
    "url": "https://..."
  }
}
```

* The result is a single `image`, not a `data` array. `image.url` points to an SVG file.
* Image URLs are temporary: files are kept for about 24 hours, so download them. See [Limits and sizes](https://www.recraft.ai/docs/api-reference/appendix.md#image-storage).
* `credits` is the number of API units charged for the request.

## Parameters

| Parameter | Type, default | Description |
| - | - | - |
| `image_url` | string, **required** in JSON | URL or data URL of the input image. |
| `file` | file, **required** in multipart | The input image, uploaded instead of `image_url`. |
| `version` | string, `v1` | `v1` (default): the standard vectorizer. `v1_pro`: Vectorizer Pro, cleaner SVGs with smooth curves, straight lines and sharp corners, \$0.04 per request. |
| `shape_stacking` | string, `hierarchical` | `hierarchical`: shapes are layered, lower shapes stay whole and are partly covered by the ones above. `cut_out`: shapes don't overlap, each visible region belongs to one shape. |
| `response_format` | string, `url` | `url`, `b64_json`, or `multipart`. See [Image inputs and results](https://www.recraft.ai/docs/api-reference/image-inputs-and-results.md#image-results). |

The input image must be PNG, JPG, or WEBP, under 20 MB, up to 16 MP, with sides between 256 and 4096 px. See [Input images](https://www.recraft.ai/docs/api-reference/appendix.md#input-images).

## Examples

> [accordion] Upload a local file
>
> ```bash cURL theme={null}
> curl https://external.api.recraft.ai/v1/images/vectorize \
>   -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
>   -F "file=@image.png"
> ```
>
> ```python Python theme={null}
> import os
>
> import requests
>
> with open('image.png', 'rb') as image:
>     response = requests.post(
>         'https://external.api.recraft.ai/v1/images/vectorize',
>         headers={'Authorization': f"Bearer {os.environ['RECRAFT_API_TOKEN']}"},
>         files={'file': image},
>     )
> if not response.ok:
>     raise SystemExit(f'{response.status_code}: {response.text}')
> print(response.json()['image']['url'])
> ```

> [accordion] Vectorizer Pro
>
> Set `version: v1_pro` to use Vectorizer Pro. It produces cleaner SVGs and costs \$0.04 per request.
>
> ```bash theme={null}
> curl https://external.api.recraft.ai/v1/images/vectorize \
>   -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "image_url": "https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png",
>     "version": "v1_pro"
>   }'
> ```

> [accordion] Non-overlapping shapes for cutting and printing
>
> `cut_out` makes every region a separate shape, which suits plotters, vinyl cutters, and screen printing.
>
> ```bash theme={null}
> curl https://external.api.recraft.ai/v1/images/vectorize \
>   -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "image_url": "https://cdn.prod.website-files.com/655727fe69827d9a402de12c/679b82f54ef9617939df9d8e_motorcycle--going-fast.png",
>     "shape_stacking": "cut_out"
>   }'
> ```

> [accordion] Generate a vector image directly
>
> To get SVG from a prompt, skip vectorizing and generate with a `_vector` model, for example `recraftv4_1_vector`. See [Recraft V4.1](https://www.recraft.ai/docs/api-reference/models/recraft-v4-1.md#variants).

## Related

> [card] [Remove background](https://www.recraft.ai/docs/api-reference/tools/remove-background.md)
>
> Cut out the subject before vectorizing.

> [card] [Pricing](https://www.recraft.ai/docs/api-reference/pricing.md)
>
> Prices of every model and tool.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.