Step1x Edit

Step1x Edit

Playground

Try it 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.

Features

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

ParameterRequiredDescription
promptYesText instruction describing the edit you want to make.
imageYesSource image to edit (upload or public URL).
negative_promptNoElements to avoid in the output.
seedNoSet for reproducibility; leave empty for random.
guidance_scaleNoPrompt adherence strength (default: 4).
num_inference_stepsNoQuality/speed trade-off (default: 30).

How to Use

  1. Upload your image — drag and drop a file or paste a public URL.
  2. Write an editing instruction describing what you want to change. Use the Prompt Enhancer for AI-assisted optimization.
  3. Add a negative prompt (optional) — specify elements to exclude.
  4. Adjust parameters (optional) — fine-tune guidance scale and inference steps.
  5. 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

OutputPrice
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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/step1x-edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "guidance_scale": 4,
    "num_inference_steps": 30
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagestringYes-The image URL to generate an image from. Needs to match the dimensions of the mask.
negative_promptstringNo-The negative prompt for the generation.
seedintegerNo--1 ~ 2147483647The random seed to use for the generation.
guidance_scalenumberNo40 ~ 20The guidance scale to use for the generation.
num_inference_stepsintegerNo301 ~ 50The number of inference steps to perform.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.