WAN 3.0 is LIVE — 30s in one shot | Try in Video Generator →

recraft-ai/

Recraft V4 Style Text-to-Vector generates styled vector graphics from text prompts using either a reusable style ID or reference images, enabling consistent SVG-style assets, icons, illustrations, brand visuals, marketing graphics, and design system workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-image
Input
Enable Safety Checker

Idle

$0.055per run·~18 / $1

Next:

Related Models

README

Recraft V4 Style Text-to-Vector

Recraft V4 Style Text-to-Vector generates vector graphics from text prompts using either a reusable style_id or temporary reference images. Use it to create stylized vector assets with controllable aspect ratio and style matching.

Why Choose This?

  • Text-to-vector generation
    Generate vector-style graphics directly from a text prompt.

  • Reusable style support
    Use a style_id created by the matching Create Style model to keep a consistent visual style.

  • Reference-image style input
    Provide reference images to create a style for the current request when no style_id is supplied.

  • Style match control
    Choose precise for closer style matching or flexible for broader interpretation.

  • Multiple aspect ratios
    Generate square, portrait, landscape, and vertical vector outputs.

Parameters

ParameterRequiredDescription
promptYesDescribe the image or vector graphic to generate.
imagesNoStyle reference images used to create a style for this request when no style_id is supplied. Supports up to 10 image URLs.
aspect_ratioNoOutput aspect ratio: 1:1, 4:3, 3:4, 16:9, or 9:16. Default: 1:1.
style_idNoReusable style ID created by the matching Create Style model.
style_matchNoControls how closely the result follows the supplied style: precise or flexible. Default: precise.

How to Use

  1. Write your prompt — Describe the vector graphic, subject, composition, and visual direction.
  2. Add style input — Provide a matching style_id, or upload reference images to create a temporary style for this request.
  3. Choose aspect ratio — Select 1:1, 4:3, 3:4, 16:9, or 9:16.
  4. Set style match optional — Use precise for closer matching or flexible for broader style interpretation.
  5. Submit — Generate the vector output.

Pricing

Pricing starts at $0.055 per request. If style reference images are provided, an additional $0.0055 is added.

ConfigurationCost
Text-to-vector with style_id or no reference images$0.055
Text-to-vector with reference images$0.0605

aspect_ratio, style_id, and style_match do not add separate charges.

Best Use Cases

  • Vector illustration generation — Create clean vector-style graphics from prompts.
  • Brand asset creation — Generate stylized icons, badges, labels, and visual elements.
  • Reusable style workflows — Use a saved style_id to keep a consistent look across generations.
  • Style exploration — Upload reference images to test a style without creating a permanent style first.
  • Marketing and design assets — Produce scalable-looking visuals for campaigns, layouts, and creative concepts.

Pro Tips

  • Use a matching style_id when you need consistent output across multiple generations.
  • Use reference images when you want to create a style for the current request only.
  • Use precise when style consistency is more important.
  • Use flexible when you want more creative variation.
  • Keep prompts focused on the subject, composition, and visual style.
  • Use 16:9 for wide layouts and 9:16 for vertical designs.

Notes

  • The style_id must be used with the matching model version.
  • Use a standard Recraft V4 style_id only with recraft-v4-style models.
  • Use a Recraft V4 Style Pro style_id only with recraft-v4-style-pro models.
  • Do not mix standard and Pro style IDs across model versions.
  • Either images or style_id must be provided. Use style_id for a reusable saved style, or images to create a temporary style for the current request.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Recraft v4 Style Text To Vector API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4-style/text-to-vector with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Recraft v4 Style Text To Vector below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "style_match": "precise"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4-style/text-to-vector" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4-style/text-to-vector";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "style_match": "precise"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "style_match": "precise"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4-style/text-to-vector", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Recraft v4 Style Text To Vector API — Frequently asked questions

What is the Recraft v4 Style Text To Vector API?

Recraft v4 Style Text To Vector is a Recraft model for image generation, exposed as a REST API on WaveSpeedAI. Recraft V4 Style Text-to-Vector generates styled vector graphics from text prompts using either a reusable style ID or reference images, enabling consistent SVG-style assets, icons, illustrations, brand visuals, marketing graphics, and design system workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Recraft v4 Style Text To Vector API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/recraft-ai/recraft-ai-recraft-v4-style-text-to-vector.

How much does Recraft v4 Style Text To Vector cost per run?

Recraft v4 Style Text To Vector starts at $0.055 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Recraft v4 Style Text To Vector accept?

Key inputs: `prompt`, `images`, `aspect_ratio`, `style_id`, `style_match`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/recraft-ai/recraft-ai-recraft-v4-style-text-to-vector.

How do I get started with the Recraft v4 Style Text To Vector API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Recraft v4 Style Text To Vector outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Recraft). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

Recraft V4 Style Text-to-Vector API on WaveSpeedAI