recraft/recraft/v4.1/pro/vector

Name: Recraft V4.1 Pro Vector
Author: Recraft

Recraft V4.1 Pro is Recraft's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.

Input

Prompt(string)

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.

Background Color(string)

The preferable background color of the generated images.

Colors(array)

An array of preferable colors

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/v4.1/pro/vector

Input Schema

4 parameters · 1 required · 3 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Min length: 1 · Max length: 10000
`colors`	object[]	Optional	An array of preferable colors · Default: []
`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/recraft/v4.1/pro/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.1 Pro Vector

API README

Recraft V4.1 Pro Vector

Recraft V4.1 Pro Vector occupies the vector-artwork role in the model catalog for media-production teams. Its practical value is to make endpoint selection explicit before implementation begins: 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/recraft/v4.1/pro/vector route belongs in an architecture without borrowing promises from another version, tier, or task variant.

A disciplined evaluation loop begins by checking the test fixture, quality bar, and delivery contract. The caller records required values separately from optional choices such as colors, aspect_ratio, background_color, 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/v4.1/pro/vector measurable business context while leaving the Highlights section to explain model behavior.

Highlights

Resolution-independent artwork. Recraft V4.1 Pro 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.1 Pro 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
Per request	`$0.300000`

When to Use

Scenario	Why it fits
Choose Recraft V4.1 Pro Vector	Use it when the job specifically calls for 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/recraft/v4.1/pro/vector.

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

Technical Specs

Specification	Details
Model ID	`recraft/recraft/v4.1/pro/vector`
Execution mode	`async`
Task type	`image`
`colors`	`array` · optional
`prompt`	`string` · required
`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`
`background_color`	`string` · optional