Step1x Edit

Step1X Edit is a powerful AI-powered image editing model that modifies images based on simple text instructions. Describe what you want to change — hair color, clothing, background, objects — and the model applies precise, targeted edits while preserving the rest of the image.

Why It Stands Out

Instruction-based editing: Edit images using natural language commands.
Precise modifications: Changes only what you specify, preserving everything else.
Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
Negative prompt support: Exclude unwanted elements for cleaner outputs.
Fine-tuned control: Adjust guidance scale and inference steps for precise results.
Affordable pricing: High-quality edits at just $0.03 per image.
Reproducibility: Use the seed parameter to recreate exact results.

Parameters

Parameter	Required	Description
prompt	Yes	Text instruction describing the edit you want to make.
image	Yes	Source image to edit (upload or public URL).
negative_prompt	No	Elements to avoid in the output.
seed	No	Set for reproducibility; leave empty for random.
guidance_scale	No	Prompt adherence strength (default: 4).
num_inference_steps	No	Quality/speed trade-off (default: 30).

How to Use

Upload your image — drag and drop a file or paste a public URL.
Write an editing instruction describing what you want to change. Use the Prompt Enhancer for AI-assisted optimization.
Add a negative prompt (optional) — specify elements to exclude.
Adjust parameters (optional) — fine-tune guidance scale and inference steps.
Click Run and download your edited image.

Example Instructions

"Change hair color to red"
"Add sunglasses"
"Change the background to a beach"
"Make the dress blue"
"Remove the hat"
"Add a smile"
"Change season to winter"

Best Use Cases

Portrait Retouching — Change hair color, add accessories, modify expressions.
Fashion & E-commerce — Swap clothing colors, add or remove items.
Background Editing — Change environments and settings.
Creative Projects — Experiment with visual variations quickly.
Content Creation — Generate multiple versions of images for A/B testing.

Pricing

Output	Price
Per image	$0.03

Pro Tips for Best Quality

Use clear, specific instructions — "Change hair color to red" works better than "Make it different."
Keep instructions focused on one or two changes at a time.
Use negative prompts to prevent unwanted side effects.
Lower guidance scale (2–4) for subtle changes, higher (5–7) for more dramatic edits.
Fix the seed when iterating to compare different instructions on the same base.

Notes

Ensure uploaded image URLs are publicly accessible.
Processing time varies based on current queue load.
Please ensure your content complies with usage guidelines.

Step1x Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/step1x-edit 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 Step1x Edit below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/step1x-edit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "negative_prompt": "blurry, low quality, distorted",
    "seed": 0,
    "guidance_scale": 4,
    "num_inference_steps": 30
}'

# 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("wavespeed-ai/step1x-edit", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "negative_prompt": "blurry, low quality, distorted",
        "seed": 0,
        "guidance_scale": 4,
        "num_inference_steps": 30
}, {
    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(
        "wavespeed-ai/step1x-edit",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "negative_prompt": "blurry, low quality, distorted",
    "seed": 0,
    "guidance_scale": 4,
    "num_inference_steps": 30
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Step1x Edit API — Frequently asked questions

What is the Step1x Edit API?

Step1x Edit is a WaveSpeedAI model for image generation, exposed as a REST API on WaveSpeedAI. Step1X-Edit converts photos into professional-quality edits using simple instructions, rivaling top proprietary tools. 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 Step1x Edit 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/wavespeed-ai/step1x-edit.

How much does Step1x Edit cost per run?

Step1x Edit starts at $0.030 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 Step1x Edit accept?

Key inputs: `prompt`, `image`, `seed`, `guidance_scale`, `num_inference_steps`, `negative_prompt`. 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/step1x-edit.

How long does Step1x Edit take to generate?

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

Can I use Step1x Edit 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.

ExamplesView all

Related Models

README

Step1X Edit