recraft/4.0/style/pro/text-to-vector

Name: Recraft V4 Styles Pro Text to Vector
Author: Recraft

4.0 Style Pro by Recraft - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

Input

Prompt(string)

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URLs of the style reference images. Supports PNG, JPG, and WEBP; provide between 1 and 10 images.

Style Match(string)

Override how closely the generation follows the custom style. Allowed values: precise, flexible.

Background Color(string)

The preferable background color of the generated images.

Colors(array)

An array of preferable colors

Style ID(string)

The ID of an existing V4 custom style.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

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/4.0/style/pro/text-to-vector

Input Schema

7 parameters · 1 required · 6 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Min length: 1 · Max length: 10000
`colors`	object[]	Optional	An array of preferable colors · Default: []
`images`	string[]	Optional	The URLs of the style reference images. Supports PNG, JPG, and WEBP; provide between 1 and 10 images.
`style_id`	string	Optional	The ID of an existing V4 custom style.
`style_match`	string	Optional	Override how closely the generation follows the custom style. · Options: precise, flexible preciseflexible
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`background_color`	string	Optional	The preferable background color of the generated images.

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/4.0/style/pro/text-to-vector",
  "colors": [],
  "prompt": "a cute character panda with cool clothes, 3d flat color, design"
}'

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

← Back to Recraft V4 Styles Pro Text to Vector

API README

Text To Vector

Text To Vector occupies the vector-artwork role in the model catalog for application builders. Its practical value is to reduce ambiguity when a workflow chooses among neighboring model variants: an upstream service can confirm that it has prompt, submit one well-scoped job, and receive an editable vector-oriented asset for downstream approval. This positioning explains when the exact recraft/4.0/style/pro/text-to-vector route belongs in an architecture without borrowing promises from another version, tier, or task variant.

A disciplined evaluation loop begins by checking the input readiness, acceptance criteria, and publishing destination. The caller records required values separately from optional choices such as images, style_match, background_color, colors, style_id, aspect_ratio, 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/4.0/style/pro/text-to-vector measurable business context while leaving the Highlights section to explain model behavior.

Highlights

Resolution-independent artwork. Recraft V4 Styles Pro Text to Vector 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 V4 Styles Pro Text to Vector 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
Billing formula	`params.style_id ? 0.138 : 0.144`
With `style_id`	`$0.138000`
Without `style_id`	`$0.144000`

When to Use

Scenario	Why it fits
Choose Text To Vector	Use it when the job specifically calls for text to vector and the route’s documented input contract matches assets already available in your workflow.
Keep the request reproducible	Use the required `prompt` 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/4.0/style/pro/text-to-vector.

{
  "prompt": "a cute character panda with cool clothes, 3d flat color, design",
  "style_match": "precise",
  "aspect_ratio": "21:9"
}

Technical Specs

Specification	Details
Model ID	`recraft/4.0/style/pro/text-to-vector`
Execution mode	`async`
Task type	`image`
`prompt`	`string` · required
`images`	`array` · optional
`style_match`	`string` · optional · choices: `precise`, `flexible`
`background_color`	`string` · optional
`colors`	`array` · optional
`style_id`	`string` · optional
`aspect_ratio`	`string` · optional · choices: `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`