Firered Image Edit

Playground

FireRed Image Edit enables precise image editing with natural-language instructions, supporting both English and Chinese prompts with multi-image references. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

FireRed Image Edit

FireRed Image Edit is a powerful AI image editing model that combines elements from multiple reference images into a single cohesive output. Upload reference images of people, objects, or styles, then describe how to combine them — the model intelligently merges elements while maintaining natural composition and lighting.

Why Choose This?

Multi-image composition Combine elements from multiple reference images into one seamless result.
Natural language editing Describe your edit in plain text — reference images by Figure number for precise control.
Flexible sizing Specify custom output size, or leave blank to match the first image’s aspect ratio.
Intelligent blending Automatically adapts lighting, perspective, and style for realistic integration.
Prompt Enhancer Built-in tool to automatically improve your edit descriptions.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the desired edit (use “Figure 1”, “Figure 2” to reference images)
images	Yes	Reference images to combine (click ”+ Add Item” to add more)
size	No	Output size; if empty, matches the first image’s aspect ratio

How to Use

Upload reference images — add all images containing elements you want to combine.
Write your prompt — describe the edit using “Figure 1”, “Figure 2”, etc. to reference specific images.
Set size (optional) — specify output dimensions, or leave blank to use first image’s ratio.
Use Prompt Enhancer (optional) — click to automatically refine your description.
Run — submit and download your edited image.

Pricing

Output	Cost
Per image	$0.08

Best Use Cases

Virtual Try-On — Put a person in different outfits from reference photos.
Character Compositing — Combine character features with new environments or accessories.
Product Visualization — Show products on different models or in various settings.
Creative Compositing — Merge elements from multiple sources for unique imagery.
Marketing & Ads — Create customized visuals by combining brand assets.

Pro Tips

Use “Figure 1”, “Figure 2”, etc. in your prompt to reference images in upload order.
Clear, front-facing reference images produce the best element extraction.
The first image determines the default output aspect ratio when size is not specified.
Describe the scene context (location, lighting, mood) for more cohesive results.
For best results, use reference images with similar lighting conditions.

Notes

Both prompt and images are required fields.
Ensure uploaded image URLs are publicly accessible.
Output size defaults to first image’s aspect ratio if not specified.

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/firered-image-edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{}'

# 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

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
images	array	Yes	[]	1 ~ 3 items	List of URLs of input images for editing. The maximum number of images is 3.
size	string	No	-	256 ~ 1536 per dimension	The size of the generated media in pixels (width*height).

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated images.
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Female Human Flashvsr