Reve 2.1 Text to Image API

Reve 2.1 Text to Image

Reve 2.1 Text to Image generates detailed, layout-aware images from natural-language prompts. It is built for dense compositions, accurate text rendering, and high-resolution visual creation across editorial, marketing, product, and creative workflows.

Why Choose This?

Detailed image generation
Create high-quality images from natural-language prompts.
Layout-aware composition
Generate structured visuals with clear subject placement, visual hierarchy, and scene organization.
Strong text rendering
Suitable for prompts that require readable text, posters, labels, or graphic layouts.
Standard image output
Generated images are returned as URLs in the standard WaveSpeed prediction response.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image to generate.
aspect_ratio	No	Output aspect ratio, including `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, and other supported presets.
output_format	No	Output format: `png`, `jpeg`, or `webp`.

How to Use

Write your prompt — Describe the subject, composition, style, lighting, and any text that should appear in the image.
Choose aspect ratio — Select an aspect ratio to let the model choose the best layout.
Choose output format — Select png, jpeg, or webp when needed.
Submit — Generate the image and retrieve the output URL.

Pricing

Output	Price
One image	$0.28

Best Use Cases

Editorial visuals — Generate structured visuals for articles, covers, and layout-driven creative assets.
Marketing images — Create campaign visuals, promotional graphics, and branded content.
Product concepts — Explore product scenes, packaging ideas, and commercial compositions.
Text-heavy designs — Generate posters, signs, labels, and dense layouts with readable text.
Creative image generation — Produce high-resolution visual concepts from detailed prompts.

Pro Tips

Describe layout, hierarchy, and the relationship between major elements.
Put exact wording in quotation marks when text must appear in the image.
Be specific about subject placement, lighting, color palette, and visual style.
Use png for high-quality general output, jpeg for smaller files, and webp for web-friendly images.

2.1 Text To Image API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/reve/2.1/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 URLs from data.outputs. Examples for 2.1 Text To Image below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/reve/2.1/text-to-image" \
  -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",
    "output_format": "jpeg",
    "enable_sync_mode": false,
    "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, {
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

try {
  const result = await client.run("reve/2.1/text-to-image", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "output_format": "jpeg",
        "enable_sync_mode": false,
        "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"],
    max_connection_retries=5,
    retry_interval=1.0,
)

try:
    output = client.run(
        "reve/2.1/text-to-image",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "enable_sync_mode": false,
    "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

2.1 Text To Image API — Frequently asked questions

What is the 2.1 Text To Image API?

2.1 Text To Image is a Reve model for image generation, exposed as a REST API on WaveSpeedAI. Reve 2.1 Text-to-Image generates high-quality images from text prompts, with strong layout intelligence, accurate text rendering, and reliable composition for posters, ads, product visuals, and typography-rich designs. 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 2.1 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/reve/reve-2.1-text-to-image.

How much does 2.1 Text To Image cost per run?

2.1 Text To Image starts at $0.28 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 2.1 Text To Image accept?

Key inputs: `prompt`, `aspect_ratio`, `enable_base64_output`, `enable_sync_mode`, `output_format`. 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/reve/reve-2.1-text-to-image.

How do I get started with the 2.1 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 2.1 Text To Image outputs commercially?

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

ExemplesTout voir

Modèles associés

README