recraft/recraft/vectorize

Name: Recraft Vectorize
Author: Recraft

Recraft Vectorize is Recraft's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input

Image Url(string)

The URL of the image to be vectorized. Must be in PNG, JPG or WEBP format, less than 5 MB in size, have resolution less than 16 MP and max dimension less than 4096 pixels, min dimension more than 256 pixels.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDrecraft/recraft/vectorize

Input Schema

1 parameters · 1 required · 0 optional

Parameter	Type	Required	Description
`image`	string	Required	The URL of the image to be vectorized. Must be in PNG, JPG or WEBP format, less than 5 MB in size, have resolution less than 16 MP and max dimension less than 4096 pixels, min dimension more than 256 pixels.

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "recraft/recraft/vectorize",
  "image": "https://static.sandbase.ai/examples/recraft/recraft/vectorize/input_image_0.png",
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Recraft Vectorize

API README

Recraft Vectorize

Recraft Vectorize occupies the vector-artwork role in the model catalog for design-system owners. Its practical value is to separate this job from adjacent family routes: an upstream service can confirm that it has image, submit one well-scoped job, and receive an editable vector-oriented asset for downstream approval. This positioning explains when the exact recraft/recraft/vectorize route belongs in an architecture without borrowing promises from another version, tier, or task variant.

A production-minded integration begins by checking the campaign objective, review rubric, and export requirement. The caller records required values separately from optional choices such as no optional controls, runs a small representative sample, and stores the route name with the resulting artifact. Reviewers then compare that artifact with the agreed acceptance criteria, document any rejected setup, and promote only a successful request shape into larger batches. This workflow gives recraft/recraft/vectorize measurable business context while leaving the Highlights section to explain model behavior.

Highlights

Resolution-independent artwork. Recraft Vectorize delivers vector-oriented output that can scale from interface graphics to large-format layouts without raster pixelation.
Editable geometry. The result is suited to design workflows that need paths, shapes, and colors adjusted after generation.
Graphic composition. Recraft Vectorize is a strong fit for icons, marks, illustrations, stickers, and other artwork built from clean visual regions.
Production export. Vector delivery keeps generated artwork practical for brand systems, print preparation, and reusable component libraries.

Pricing

Billing option	Price
Request	See account pricing for the current rate

When to Use

Scenario	Why it fits
Choose Recraft Vectorize	Use it when the job specifically calls for vectorize and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `image` explicitly, then record optional choices alongside the prompt for repeatable reruns.
Build controlled creative variations	Change one declared control at a time when comparing framing, format, duration, resolution, style, or other route-supported output decisions.
Integrate asynchronous delivery	Use this endpoint when an application can submit work, track completion, and collect the returned media URL instead of requiring an immediate inline artifact.
Validate before a large batch	Run representative prompts and source assets first, confirm the visual or audio behavior, then lock the successful request shape for scaled production.

Prompt Guide

Lead with the subject or transformation, then add the composition, environment, style, lighting, motion, voice, or fidelity details relevant to this route. Keep every parameter inside the documented schema; the example below uses only fields declared for recraft/recraft/vectorize.

{
  "image": "https://static.sandbase.ai/examples/recraft/recraft/vectorize/input_image_0.png"
}

Technical Specs

Specification	Details
Model ID	`recraft/recraft/vectorize`
Execution mode	`async`
Task type	`image`
`image`	`string` · required