Advanced Prompt Optimizer for image and video generation. Automatically enhances prompts for clarity, structure, composition, motion dynamics, and style control—producing significantly better outputs across models like FLUX, Wan, Kling, Veo, Seedance, and more. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Idle
$0.001per run·~1000 / $1
ExamplesView all
Related Models
README
Image & Video Prompt Optimizer API
Overview
The WaveSpeedAI Prompt Optimizer enhances prompts specifically for image and video generation workflows. It restructures and enriches your input prompt to improve visual clarity, composition, cinematic framing, lighting, camera movement, and style consistency.
Designed for models such as Nano Banana, Seedream, FLUX, Wan, Kling, Veo, Seedance, Hailuo, and other leading visual-generation systems.
Key Features
- Improves visual composition (lighting, framing, perspective)
- Expands prompts with cinematic and artistic attributes
- Enhances style, mood, and motion for video models
- Reduces ambiguity and ensures consistent reproducible outputs
- Works seamlessly in automated pipelines and API workflows
Why Use It?
Raw user prompts often produce unstable or low-quality visual outputs. The Prompt Optimizer standardizes and enriches prompts, leading to:
- Better image detail and fidelity
- More stable, coherent video motion
- Consistent art direction across batches
- Improved adherence to user intent
Usage
Send any raw text prompt to the /v1/prompt/optimize endpoint and receive a fully optimized version ready for visual generation models.
Prompt Optimizer API — Quick start
Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/prompt-optimizer with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Prompt Optimizer below.
HTTP example
# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/prompt-optimizer" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://example.com/your-input.jpg",
"style": "default",
"mode": "image",
"enable_sync_mode": false
}'
# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
-H "Authorization: Bearer $WAVESPEED_API_KEY"
# When status is "completed", read the output from data.outputs[0].Node.js example
// npm install wavespeed
const WaveSpeed = require('wavespeed');
const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env
const result = await client.run("wavespeed-ai/prompt-optimizer", {
"image": "https://example.com/your-input.jpg",
"style": "default",
"mode": "image",
"enable_sync_mode": false
});
console.log(result.outputs[0]); // → URL of the generated outputPython example
# pip install wavespeed
import wavespeed
output = wavespeed.run(
"wavespeed-ai/prompt-optimizer",
{
"image": "https://example.com/your-input.jpg",
"style": "default",
"mode": "image",
"enable_sync_mode": false
}
)
print(output["outputs"][0]) # → URL of the generated outputPrompt Optimizer API — Frequently asked questions
What is the Prompt Optimizer API?
Prompt Optimizer is a WaveSpeedAI model for AI inference, exposed as a REST API on WaveSpeedAI. Advanced Prompt Optimizer for image and video generation. Automatically enhances prompts for clarity, structure, composition, motion dynamics, and style control—producing significantly better outputs across models like FLUX, Wan, Kling, Veo, Seedance, and more. 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 Prompt Optimizer 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 prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/prompt-optimizer.
How much does Prompt Optimizer cost per run?
Prompt Optimizer starts at $0.001 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 Prompt Optimizer accept?
Key inputs: `image`, `enable_sync_mode`, `mode`, `style`, `text`. 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/wavespeed-ai/prompt-optimizer.
How long does Prompt Optimizer take to generate?
Average end-to-end generation time on WaveSpeedAI is around 8 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.
Can I use Prompt Optimizer outputs commercially?
Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.