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

recraft-ai/

Recraft V4 Pro Style Text-to-Image generates styled images from text prompts using either a reusable style ID or reference images, enabling consistent visual direction for brand assets, design systems, marketing visuals, social content, and creative production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-image
Input
Enable Safety Checker

Idle

A mysterious young European man standing inside an entirely deep-red luxury elevator, wearing a sculptural charcoal-gray suit with asymmetric tailoring, silver hair slicked backward, captured adjusting his cuff while staring directly toward the closing doors, polished metal walls creating fragmented reflections of him from multiple angles, minimalist neo-noir photography, strong symmetry, dramatic fashion editorial aesthetic, sophisticated and slightly unsettling.

$0.11per run·~90 / $10

Next:

ExamplesView all

A mysterious young European man standing inside an entirely deep-red luxury elevator, wearing a sculptural charcoal-gray suit with asymmetric tailoring, silver hair slicked backward, captured adjusting his cuff while staring directly toward the closing doors, polished metal walls creating fragmented reflections of him from multiple angles, minimalist neo-noir photography, strong symmetry, dramatic fashion editorial aesthetic, sophisticated and slightly unsettling.

A mysterious young European man standing inside an entirely deep-red luxury elevator, wearing a sculptural charcoal-gray suit with asymmetric tailoring, silver hair slicked backward, captured adjusting his cuff while staring directly toward the closing doors, polished metal walls creating fragmented reflections of him from multiple angles, minimalist neo-noir photography, strong symmetry, dramatic fashion editorial aesthetic, sophisticated and slightly unsettling.

Related Models

README

Recraft V4 Style Pro Text-to-Image

Recraft V4 Style Pro Text-to-Image generates images from text prompts using either a reusable Pro style_id or temporary style reference images. Use it to create high-quality, visually consistent image assets with controllable aspect ratio and style matching.

Why Choose This?

  • Pro text-to-image generation
    Generate polished images directly from natural-language prompts.

  • Reusable Pro style support
    Use a style_id created by the matching Recraft V4 Pro 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 image outputs.

Parameters

ParameterRequiredDescription
promptYesDescribe the image 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 subject, scene, composition, and visual direction.
  2. Add style input — Provide a matching Pro 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 styled image output.

Pricing

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

ConfigurationCost
Text-to-image with style_id or no reference images$0.11
Text-to-image with reference images$0.1155

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

Best Use Cases

  • Pro styled image generation — Generate high-quality images with reusable or request-specific style guidance.
  • Brand asset creation — Create consistent visuals for campaigns, social media, and marketing materials.
  • Reusable Pro style workflows — Use a saved Pro style_id to keep a consistent look across multiple generations.
  • Style exploration — Upload reference images to test a style without creating a permanent style first.
  • Creative production — Generate polished visuals for design, advertising, and content workflows.

Pro Tips

  • Use a matching Pro 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 Recraft V4 Style Pro style_id only with recraft-v4-style-pro models.
  • Use a standard Recraft V4 style_id only with recraft-v4-style 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 Pro Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4-style-pro/text-to-image 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 Pro Text To Image 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-pro/text-to-image" \
  -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-pro/text-to-image";
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-pro/text-to-image", 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 Pro Text To Image API — Frequently asked questions

What is the Recraft v4 Style Pro Text To Image API?

Recraft v4 Style Pro Text To Image is a Recraft model for image generation, exposed as a REST API on WaveSpeedAI. Recraft V4 Pro Style Text-to-Image generates styled images from text prompts using either a reusable style ID or reference images, enabling consistent visual direction for brand assets, design systems, marketing visuals, social content, and creative production 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 Pro Text To Image 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-pro-text-to-image.

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

Recraft v4 Style Pro Text To Image starts at $0.11 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 Pro Text To Image 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-pro-text-to-image.

How do I get started with the Recraft v4 Style Pro Text To Image 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 Pro Text To Image 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 Pro Style Text-to-Image API on WaveSpeedAI