# Recraft V4.1 Vector

`recraft/recraft-v4-1-vector` · Recraft · image

Turn a written brief into editable SVG artwork. Set the colors or supply style references to give related drawings a common look.

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

## Use cases

- Draw a family of navigation icons
- Create an illustration that scales from a label to a sign

## Technical details

- API model ID — recraft/recraft-v4-1-vector
- Provider — Recraft
- Modality — Image
- Input — Text prompt · Images
- Output — Image
- Endpoint — POST /v2/jobs
- Workflow — Text to image

## Request parameters

- `prompt` (string, required) — What to generate, 1 to 10000 characters.
  - 1–10000 characters
- `image_format` (string) — The raster format of the result: `webp` (lossless, the default) or `png`; a vector result is always SVG.
  - Allowed values — `webp`, `png`
- `random_seed` (integer) — Random seed, a whole number from 0 to 4294967295; set it for reproducible generation.
  - 0–4294967295
- `controls` (object) — Color preferences for the result: `colors` (up to 10) and `background_color`.
- `controls.colors` (array) — Suggest up to 10 colors. Each palette entry requires an rgb array of exactly three integers from 0 to 255, in red, green, blue order.
  - Up to 10 items
  - To weight the palette, give every color a weight between 0 and 1. The weights may add up to at most 1. To leave the palette unweighted, omit weight from every color.
  - An optional std array gives the color spread as one number per RGB channel. The API publishes no numeric bounds for std.
- `controls.background_color` (object) — The preferable background color.
- `controls.background_color.rgb` (array, required with `controls.background_color`) — The color as three whole numbers from 0 to 255: red, green, blue.
  - 3–3 items
- `controls.background_color.std` (array) — The spread of the color around `rgb`, one number per channel (the vendor's `std`); it does not change the price.
- `controls.background_color.weight` (number) — Set the relative preference for the background color with a number from 0 to 1.
  - 0–1
- `size` (string) — An aspect ratio such as `16:9`; when omitted, one is picked from the prompt.
  - Allowed values — `1:1`, `2:1`, `1:2`, `3:2`, `2:3`, `4:3`, `3:4`, `5:4`, `4:5`, `6:10`, `14:10`, `10:14`, `16:9`, `9:16`
- `style_id` (string) — The id (a UUID) of a style to generate in: a public or shared style of the same model, or one an earlier request made from `style_reference_urls`; it cannot be combined with `style_reference_urls`.
- `style_reference_urls` (array) — 1 to 10 public https URLs of PNG, JPEG or WEBP images whose style the result borrows (64 MB in total); a job does not return the `style_id` of the style they make; the references are priced once per request.
  - 1–10 items
- `style_match` (string) — How closely the result follows the style: `flexible` or `precise`; when omitted, the style's own setting applies.
  - Allowed values — `flexible`, `precise`
- `zdr` (boolean) — When enabled, Recraft skips logging or storing your prompt and reference images. 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.08 per image · active
- USD 0.005 style references, once per request · active · added to the per-image price of the request

- Billed per image delivered; n multiplies the price.

## Examples

### Stallion in cobalt

A white stallion crosses a lime sun on a cobalt field. The mane and tail are drawn in black and white vector shapes.

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

### Koi in a whirlpool

An orange and cream koi curls through sweeping dark green waves in a square vector print.

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