Recraft 20B | High-Quality Text-to-Image API

Recraft 20B — Design-Native Text-to-Image

Recraft 20B is a large-scale text-to-image model that “thinks in design language.” It is tuned for layouts, typography, brand-safe compositions, and clean text rendering, making it ideal for social graphics, ads, presentations, and product visuals where design quality matters as much as realism.

Why it stands out

Design-first image generation Strong understanding of layout, hierarchy, and composition for poster-style images, thumbnails, and marketing assets.
Sharp, readable text on images Generates high-quality embedded text—from short labels to longer headlines—directly inside the image.
Rich style system Curated style presets (for example, igital_illustration/grain make it easy to switch between illustration, painterly, and graphic styles without rewriting prompts.
Brand and identity friendly Handles logos, icons, and UI-like designs with improved anatomy, alignment, and visual consistency.
Vector-aware design Originates from a system that supports both raster and vector workflows, making it particularly strong for flat design, icons, and graphic illustration.

Key capabilities

Advanced prompt understanding for detailed scenes, characters, and layouts.
Stable composition suitable for posters, covers, landing-page hero sections, and ad creatives.
Improved anatomy and perspective compared to many generic art models.
Good text–image integration so titles, slogans, and labels feel part of the design rather than pasted on.

Controls and parameters

prompt – natural-language description of the scene, style, layout, and embedded text you want.
aspect_ratio – choose from standard ratios (for example 1:1, 16:9, 9:16) to match feeds, banners, and story formats.
style – select from model-defined style families such as igital_illustration/grainto quickly shift aesthetic direction.
enable_base64_output – when enabled via API, returns the image as a base64 string instead of a URL (useful for certain integrations).

Outputs are delivered as high-quality raster images suitable for web, slides, and print-oriented workflows.

Pricing

Simple per-image billing:

$0.022 per generated image

How to use

Enter a prompt describing subject, composition, design style, and any on-image text (titles, slogans, labels).
Choose an aspect_ratio that matches the target placement (for example, 16:9 for banners, 9:16 for vertical stories).
Select a style preset that fits your use case (illustration, grainy poster look, etc.).
(Optional) Enable base64 output if your integration needs inline image data instead of URLs.
Run the job and download or embed the generated image from the response or dashboard.

Pro tips

Be explicit about layout (e.g., “centered character with headline at the top, small subtitle below”) to leverage Recraft’s design-native strengths.
For text-heavy designs, spell out exact wording and, if needed, describe typography (for example, “bold sans-serif headline, clean minimal layout”).
Use aspect ratios that match the final placement so you avoid cropping away important elements.
When exploring brand visuals, keep the core prompt stable and tweak style or minor wording to generate consistent variations.

Recraft 20b API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/recraft-ai/recraft-20b 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 URLs from data.outputs. Examples for Recraft 20b below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/recraft-ai/recraft-20b" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "style": "realistic_image/b_and_w",
    "enable_base64_output": false
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("recraft-ai/recraft-20b", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "style": "realistic_image/b_and_w",
        "enable_base64_output": false
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "recraft-ai/recraft-20b",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "style": "realistic_image/b_and_w",
    "enable_base64_output": false
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Recraft 20b API — Frequently asked questions

What is the Recraft 20b API?

Recraft 20b is a Recraft model for image generation, exposed as a REST API on WaveSpeedAI. Recraft AI 20b delivers affordable, fast image generation. 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 20b 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-20b.

How much does Recraft 20b cost per run?

Recraft 20b starts at $0.022 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 20b accept?

Key inputs: `prompt`, `aspect_ratio`, `enable_base64_output`, `style`. 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-20b.

How long does Recraft 20b take to generate?

Average end-to-end generation time on WaveSpeedAI is around 5 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Recraft 20b 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.

PrzykładyZobacz wszystkie

Powiązane modele

README