Vectorize

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.

$0.01

per request

PNG, JPG, WEBP → SVG

up to 10 MB, 16 MP

POST /v1/images/vectorize

endpoint

Try it

Get an API token on your profile page (it needs a positive API units balance) and set it once per terminal session:

export RECRAFT_API_TOKEN=your_token

Then run. The request vectorizes a public sample illustration:

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"
  }'

# 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'])

// 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);

# 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

{
  "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.
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`.
`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.

The input image must be PNG, JPG, or WEBP, under 10 MB, up to 16 MP, with sides between 256 and 4096 px. See Input images.

Examples

Upload a local file

curl https://external.api.recraft.ai/v1/images/vectorize \
  -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
  -F "file=@image.png"

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'])

Non-overlapping shapes for cutting and printing

cut_out makes every region a separate shape, which suits plotters, vinyl cutters, and screen printing.

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"
  }'

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.

Remove background

Cut out the subject before vectorizing.

Pricing

Prices of every model and tool.

Get started

Models

Tools

Reference

$0.01

PNG, JPG, WEBP → SVG

POST /v1/images/vectorize

Try it

Response

Parameters

Examples

Remove background

Pricing

$0.01

PNG, JPG, WEBP → SVG

POST /v1/images/vectorize

​Try it

​Response

​Parameters

​Examples

​Related

Remove background

Pricing

Try it

Response

Parameters

Examples

Related