---
title: Recraft V4 Vector | Runware Docs
url: https://runware.ai/docs/models/recraft-v4-vector
description: Professional vectorization and design-aware image conversion
---
# Recraft V4 Vector

![Recraft V4 Vector](https://assets.runware.ai/covers/recraft-v4-vector.jpg)

Recraft V4 Vector is a professional vectorization model that transforms raster images into high-quality scalable vector art. Built for design and marketing workflows, it preserves structural fidelity, contour accuracy, and visual style while producing clean paths and optimized shapes suitable for branding, illustration, and layout production.

- **Status**: live
- **ID**: `recraft:v4@vector`
- Try in Playground
- **Creator**: Recraft
- **Release Date**: February 17, 2026
- **Capabilities**: Text to Image, Vectorize, Checkpoint

## Pricing

$0.08 per run · ~19s per request

**4 example generations**

- [vectorize](https://runware.ai/docs/models/recraft-v4-vector/examples#example-urban-apiary-operations-icon-set) · 1024×1024: `$0.08` (~19s)
- [vectorize](https://runware.ai/docs/models/recraft-v4-vector/examples#example-geothermal-utility-campaign-key-visual) · 1536×768: `$0.08` (~20s)
- [vectorize](https://runware.ai/docs/models/recraft-v4-vector/examples#example-avalanche-forecaster-persona-portrait) · 1024×1024: `$0.08` (~19s)
- [vectorize](https://runware.ai/docs/models/recraft-v4-vector/examples#example-cryogenic-specimen-logistics-icon-set) · 1536×768: `$0.08` (~25s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (1:1)` | `1024x1024` |
| `1K (2:1)` | `1536x768` |
| `1K (1:2)` | `768x1536` |
| `1K (3:2)` | `1280x832` |
| `1K (2:3)` | `832x1280` |
| `1K (4:3)` | `1216x896` |
| `1K (3:4)` | `896x1216` |
| `1K (5:4)` | `1152x896` |
| `1K (4:5)` | `896x1152` |
| `1K (6:10)` | `832x1344` |
| `1K (14:10)` | `1280x896` |
| `1K (10:14)` | `896x1280` |
| `1K (16:9)` | `1344x768` |
| `1K (9:16)` | `768x1344` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/recraft-v4-vector#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `vectorize`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/recraft-v4-vector#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/recraft-v4-vector#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/recraft-v4-vector#request-outputformat)

- **Type**: `string`
- **Default**: `SVG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`SVG\`: Scalable Vector Graphics.

**Allowed values**: `SVG`

### [webhookURL](https://runware.ai/docs/models/recraft-v4-vector#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/recraft-v4-vector#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/recraft-v4-vector#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [ttl](https://runware.ai/docs/models/recraft-v4-vector#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/recraft-v4-vector#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/recraft-v4-vector#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `recraft:v4@vector`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/recraft-v4-vector#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `10000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/recraft-v4-vector#request-width)

- **Type**: `integer`
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/recraft-v4-vector#request-height)

- **Type**: `integer`
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [backgroundColor](https://runware.ai/docs/models/recraft-v4-vector#request-settings-backgroundcolor)

- **Path**: `settings.backgroundColor`
- **Type**: `object (1 property)`

Background color used for the generation.

**Learn more** (1 resource):

- [Color Palettes](https://runware.ai/docs/models/recraft-v4-1/guides/color-palettes) (learn)

#### [rgb](https://runware.ai/docs/models/recraft-v4-vector#request-settings-backgroundcolor-rgb)

- **Path**: `settings.backgroundColor.rgb`
- **Type**: `array of integers`
- **Required**: true
- **Min**: `0`
- **Max**: `255`
- **Min items**: `items: 3`

Color as `[red, green, blue]` array.

### [colors](https://runware.ai/docs/models/recraft-v4-vector#request-settings-colors)

- **Path**: `settings.colors`
- **Type**: `array of objects (1 property)`

Colors defining the palette for the generation.

**Learn more** (1 resource):

- [Color Palettes](https://runware.ai/docs/models/recraft-v4-1/guides/color-palettes) (learn)

#### [rgb](https://runware.ai/docs/models/recraft-v4-vector#request-settings-colors-rgb)

- **Path**: `settings.colors.rgb`
- **Type**: `array of integers`
- **Required**: true
- **Min**: `0`
- **Max**: `255`
- **Min items**: `items: 3`

Color as `[red, green, blue]` array.

## Response Parameters

### [taskType](https://runware.ai/docs/models/recraft-v4-vector#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `vectorize`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/recraft-v4-vector#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/recraft-v4-vector#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/recraft-v4-vector#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/recraft-v4-vector#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/recraft-v4-vector#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [cost](https://runware.ai/docs/models/recraft-v4-vector#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### vectorize (vectorize)

![Urban Apiary Operations Icon Set](https://assets.runware.ai/examples/recraft-v4-vector/a77a8727-8ae8-4371-87f0-3868368d025d.svg)

```json
{
  "taskType": "vectorize",
  "taskUUID": "55624da3-eabc-4a09-b867-ff8dd0ec38a9",
  "model": "recraft:v4@vector",
  "positivePrompt": "Create an original, polished vector icon set for a professional urban apiary operations program. Present twelve distinct pictograms in a precise 4-by-3 grid on a warm ivory background, with generous spacing and no surrounding interface or mockup. Subjects: protective beekeeper veil, smoking hive tool, stacked rooftop hive, removable honey frame, queen bee with a small marking dot, soft bee brush, swarm collection box, shallow bee water station, varroa mite inspection tray, honey extraction spinner, sting first-aid kit, and pesticide-free garden shield. Give every icon a clear, immediately readable silhouette and consistent visual weight. Art direction: modern municipal wayfinding graphics with subtle 1970s environmental-design character; bold rounded geometry, clipped corners, compact negative-space details, and a restrained combination of solid fills and uniform heavy outlines. Build insects from simplified oval and wing shapes rather than realistic anatomy. Use an intentional palette of charcoal black, deep slate blue, golden ochre, muted coral, and warm ivory. Keep each icon visually self-contained and balanced inside an implied square tile, but do not draw tile borders. Use flat colors only, clean curves, crisp joins, minimal anchor-point complexity, no gradients, no shadows, no texture, no photorealism, no text, no letters, and no numbers. Ensure the result feels like a cohesive, production-ready editable SVG symbol family suitable for safety decals, printed field guides, packaging labels, and large-format rooftop signage.",
  "width": 1024,
  "height": 1024
}
```

---

### vectorize (vectorize)

![Geothermal Utility Campaign Key Visual](https://assets.runware.ai/examples/recraft-v4-vector/9e3b6da7-57fb-4e62-acc0-b30c4f74afc6.svg)

```json
{
  "taskType": "vectorize",
  "taskUUID": "86750719-24ed-4106-8096-532f4389b71e",
  "model": "recraft:v4@vector",
  "positivePrompt": "Create an original, polished landscape vector key visual for a brand marketing campaign promoting city-scale geothermal heating. Show a lively modern neighborhood above ground and the hidden geothermal system beneath it in one elegant cutaway composition. Across the upper third, depict a compact city block with recognizable silhouettes: mid-rise apartments, a library, a greenhouse, street trees, pedestrians, bicycles, and a small electric bus. Below the ground line, transform the earth into sweeping geological strata surrounding a precise network of deep geothermal wells and looping pipes. Use warm vermilion paths rising from the earth and cool cobalt return paths descending underground, clearly communicating a continuous renewable heat cycle without technical labels. Make the pipe network form a subtle circular flow that visually unifies the entire campaign image.\n\nArt direction: bold contemporary editorial vector illustration with architectural precision, inspired by public-infrastructure diagrams and premium European transit graphics. Use simplified geometric buildings, crisp silhouettes, balanced asymmetry, rhythmic curves, intentional negative space, and a strong left-to-right visual flow. Make the underground section the visual hero, occupying roughly two thirds of the image. Include distinct rock layers, a deep hot-water reservoir, small directional arrows integrated as graphic shapes, and clean junction details that remain legible at billboard scale. Keep people and vehicles minimal but expressive, using simple modular forms rather than character-detail rendering.\n\nUse a tightly controlled palette of warm ivory, deep charcoal, saturated cobalt blue, mineral teal, terracotta red, and a small amount of golden yellow. Flat color fields with limited subtle tonal layering only; no photorealism, no grain, no painterly texture, no 3D rendering, and no complex lighting effects. Construct the artwork from clean closed shapes, smooth Bézier curves, consistent line weights, separated color regions, and economical path geometry suitable for editable scalable SVG production. Preserve clear boundaries between every object and avoid tiny decorative details. Premium, optimistic, intelligent, civic-minded mood. No text, no letters, no numbers, no logos, no border, no interface, and no advertising mockup; output the finished standalone campaign artwork.",
  "width": 1536,
  "height": 768
}
```

---

### vectorize (vectorize)

![Avalanche Forecaster Persona Portrait](https://assets.runware.ai/examples/recraft-v4-vector/7375067b-b507-4ff0-9684-2aadd3c2184c.svg)

```json
{
  "taskType": "vectorize",
  "taskUUID": "a347cd07-7591-4f67-868e-a39eb42dfd49",
  "model": "recraft:v4@vector",
  "positivePrompt": "Create an original, polished vector persona portrait for a mountain-safety organization’s avalanche education campaign. Depict a capable middle-aged female avalanche forecaster in a waist-up three-quarter view, looking directly toward the viewer with a calm, alert, trustworthy expression. Establish memorable, repeatable character features: angular oval face, warm brown skin, dark cropped curls with one bold silver streak above the right temple, slightly arched eyebrows, a small notch through the left eyebrow, oval signal-orange glasses, and one simple hexagonal snow-crystal earring. She wears a midnight-navy technical rescue shell with a high glacier-blue collar, an asymmetric orange waterproof zipper, a compact radio microphone clipped at the shoulder, and a graphite field strap crossing the chest. One gloved hand holds a small rectangular slope inclinometer close to her torso; keep the device face abstract and free of numbers or text.\n\nUse a crisp contemporary editorial-vector style influenced by technical cartography and alpine safety diagrams. Build the face, hair, clothing, and equipment from deliberate closed shapes with clean Bézier contours, economical anchor-point logic, controlled overlaps, and clearly separated color regions suitable for editing as SVG artwork. Preserve natural facial character while simplifying planes into confident geometric forms. Use limited cel-style shadow shapes rather than gradients, photorealistic rendering, airbrush effects, or raster texture.\n\nFrame the figure as one strong, unmistakable silhouette centered within a square composition. Behind her, create a restrained abstract mountain cross-section using broad glacier-blue facets, thin snow-white topographic contour arcs, and one diagonal signal-orange fracture line suggesting an avalanche slab. Keep these background elements spacious and secondary so the face remains the focal point. Add a simple circular halo shape behind the head for separation, but no badge border and no emblem. Palette: midnight navy, glacier blue, snow white, warm brown, charcoal graphite, and signal orange, with excellent contrast and consistent line weight. Mood: expert, composed, vigilant, humane, and field-ready. Deliver a finished standalone vector illustration with no typography, captions, logos, branding, watermark, mockup, interface, decorative frame, or photorealistic effects.",
  "width": 1024,
  "height": 1024
}
```

---

### vectorize (vectorize)

![Cryogenic Specimen Logistics Icon Set](https://assets.runware.ai/examples/recraft-v4-vector/9b05fc94-34b8-45c8-8f8b-135775fc19e2.svg)

```json
{
  "taskType": "vectorize",
  "taskUUID": "cf89ce81-5b7d-45b0-9495-ffad41a631f8",
  "model": "recraft:v4@vector",
  "positivePrompt": "Create a polished set of 12 original vector icons for cryogenic biological-specimen logistics, presented as a clean 6-column by 2-row system on one wide artboard. Include distinct symbols for: an insulated shipping container, a cryogenic vial, a rack of sample tubes, dry-ice pellets with vapor, a shield containing a snowflake, a gloved hand handling a vial, a temperature data logger, a thermometer with an alert symbol, a sealed quarantine crate, a chain-of-custody clipboard without writing, upright package-orientation arrows, and a secure handoff between two hands. Design these as a coherent professional icon family for biotech laboratories and medical couriers rather than playful clip art. Use bold geometric construction, clear silhouettes, gently rounded corners, consistent medium-weight outlines, uniform optical scale, balanced negative space, and simplified interior details that remain legible at small sizes. Place every icon inside its own subtle rounded-square tile with generous spacing and exact visual alignment. Use a precise limited palette of deep cobalt blue, cold cyan, high-visibility chartreuse, warm coral accents, charcoal outlines, and pale cool-gray tile backgrounds. Give critical warning details small coral accents and reserve chartreuse for status or handling cues. Flat vector artwork only: crisp closed shapes, smooth Bézier curves, minimal anchor-point complexity, no gradients, no shadows, no texture, no photorealism, no three-dimensional rendering. Maintain consistent line caps, corner radii, stroke weight, and perspective across all 12 icons. The overall composition should resemble a carefully authored editable SVG asset sheet suitable for packaging labels, SOP manuals, wayfinding, and laboratory training graphics. No words, letters, numbers, captions, logos, interface controls, browser frame, app screen, or product mockup.",
  "width": 1536,
  "height": 768
}
```