Seedream 5.0 Flash is LIVE — Faster & Cheaper | Try Now →

recraft-ai/recraft-v4.1-flash/text-to-image

Recraft V4.1 Flash Text-to-Image generates high-quality raster images from text prompts for photography, illustrations, creative compositions, marketing visuals, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-image
Input
Enable Safety Checker

Idle

A young French female perfumer standing behind an elegant laboratory table filled with crystal perfume bottles, pipettes, botanical ingredients, and handwritten formula cards. She wears a cream blouse and dark fitted vest, holding a clear rectangular perfume bottle near her face. Soft afternoon light, luxury editorial photography, realistic glass reflections.

$0.008per run·~125 / $1

Next:

ExamplesView all

A young French female perfumer standing behind an elegant laboratory table filled with crystal perfume bottles, pipettes, botanical ingredients, and handwritten formula cards. She wears a cream blouse and dark fitted vest, holding a clear rectangular perfume bottle near her face. Soft afternoon light, luxury editorial photography, realistic glass reflections.

A young French female perfumer standing behind an elegant laboratory table filled with crystal perfume bottles, pipettes, botanical ingredients, and handwritten formula cards. She wears a cream blouse and dark fitted vest, holding a clear rectangular perfume bottle near her face. Soft afternoon light, luxury editorial photography, realistic glass reflections.

A young male antique restorer sitting at a wooden workbench, wearing a rolled-sleeve shirt and leather apron, holding an open antique pocket watch with tiny repair tweezers. Magnifying lenses, brass tools, gears, and old watches surround him. Warm directional lamp light, cinematic craftsmanship, highly detailed.

A young male antique restorer sitting at a wooden workbench, wearing a rolled-sleeve shirt and leather apron, holding an open antique pocket watch with tiny repair tweezers. Magnifying lenses, brass tools, gears, and old watches surround him. Warm directional lamp light, cinematic craftsmanship, highly detailed.

Related Models

README

Recraft V4.1 Flash Text-to-Image

Recraft V4.1 Flash Text-to-Image generates raster images directly from text prompts for fast creative exploration. Describe the subject, composition, lighting, and visual style, then choose a square, portrait, or landscape aspect ratio to generate the final image.

It is suited to photography, illustration, mixed-media compositions, product concepts, editorial visuals, and other workflows where fast text-to-image generation is useful.

Why Choose This?

  • Fast text-to-image generation
    Turn natural-language descriptions into finished raster images.

  • Flexible visual styles
    Create photography, illustrations, mixed-media compositions, and other visual directions through prompting.

  • Creative iteration
    Quickly explore different subjects, compositions, lighting setups, and styles.

  • Multiple aspect ratios
    Generate square, portrait, or landscape images for different publishing and design needs.

  • Simple workflow
    Only a text prompt is required, making the endpoint easy to integrate into image-generation pipelines.

Parameters

ParameterRequiredDescription
promptYesText description of the image to generate, including subject, composition, lighting, and visual style. Length: 1–10000 characters.
aspect_ratioNoOutput aspect ratio: 1:1, 16:9, 9:16, 4:3, or 3:4. Default: 1:1.

How to Use

  1. Write a prompt — Describe the subject, composition, lighting, colors, and visual style.
  2. Choose aspect ratio optional — Select a square, portrait, or landscape layout, or keep the default 1:1.
  3. Submit — Generate the image.
  4. Retrieve the result — Access the generated raster image from the prediction response.

Pricing

Pricing is fixed at $0.008 per generated image.

OutputPrice
One generated image$0.008

Best Use Cases

  • Product concepts — Explore product ideas, presentation styles, and campaign imagery.
  • Editorial visuals — Generate photography-style or illustrative images for articles and publications.
  • Marketing creatives — Create campaign concepts, promotional graphics, and social media imagery.
  • Illustration — Generate stylized or descriptive artwork directly from text.
  • Mixed-media concepts — Explore compositions that combine different visual treatments and aesthetics.
  • Rapid visual exploration — Test multiple creative directions quickly before final production.

Pro Tips

  • Describe the main subject and composition before adding style details.
  • Include lighting, color palette, environment, and mood when they matter to the result.
  • Use 16:9 or 4:3 for landscape compositions.
  • Use 9:16 or 3:4 for portrait-oriented content.
  • Keep the prompt focused when you want stronger control over the main subject and composition.
  • Iterate on prompt wording to explore different visual directions quickly.

Notes

  • aspect_ratio defaults to 1:1.
  • Supported aspect ratios are 1:1, 16:9, 9:16, 4:3, and 3:4.
  • Each successful request generates one raster image.
  • This endpoint is for text-to-image generation, not image editing or vector generation.
  • Custom dimensions and structured color controls are not exposed in this configuration.
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.1 Flash Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/recraft-ai/recraft-v4.1-flash/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.1 Flash 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"
}
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.1-flash/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.1-flash/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"
}),
});
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"
}

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.1-flash/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.1 Flash Text To Image API — Frequently asked questions

What is the Recraft v4.1 Flash Text To Image API?

Recraft v4.1 Flash Text To Image is a Recraft model for image generation, exposed as a REST API on WaveSpeedAI. Recraft V4.1 Flash Text-to-Image generates high-quality raster images from text prompts for photography, illustrations, creative compositions, marketing visuals, and 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.1 Flash 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 Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/recraft-ai/recraft-ai-recraft-v4.1-flash-text-to-image.

How much does Recraft v4.1 Flash Text To Image cost per run?

Recraft v4.1 Flash Text To Image starts at $0.008 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.1 Flash Text To Image accept?

Key inputs: `prompt`, `aspect_ratio`. 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.1-flash-text-to-image.

How do I get started with the Recraft v4.1 Flash 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.1 Flash Text To Image outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Recraft). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txtrecraft-ai/recraft-v4.1-flash/text-to-image for AI agents and LLMs
Recraft V4.1 Flash Text-to-Image API on WaveSpeedAI