Hunyuan Image 3 Instruct Edit

Hunyuan Image 3 Instruct Edit is Tencent's advanced image editing model that transforms existing images based on text instructions. Upload your source images and describe the changes you want — the model intelligently edits while preserving the original style and composition.

Why Choose This?

Text-driven editing Modify images using natural language instructions for intuitive control.
Multi-image input Support for multiple reference images to guide complex edits.
Context-aware modifications Understands scene structure and object relationships for coherent edits.
Multiple aspect ratios Preset options for 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, and 2:3.
Flexible sizing Custom width and height from 256 to 1536 pixels.
Prompt Enhancer Built-in tool to automatically improve your editing instructions.

Parameters

Parameter	Required	Description
prompt	Yes	Text instruction describing the desired edit
images	Yes	Source images to edit (click "+ Add Item" for multiple)
size	No	Preset aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
width	No	Output width in pixels (256-1536, default: 256)
height	No	Output height in pixels (256-1536, default: 256)
seed	No	Random seed for reproducibility

How to Use

Upload your images — add one or more source images by clicking "+ Add Item".
Write your prompt — describe the edits you want (add, remove, modify elements).
Select size preset — choose an aspect ratio that fits your needs.
Adjust dimensions (optional) — fine-tune width and height if needed.
Set seed (optional) — use a fixed seed for reproducible results.
Run — submit and download your edited image.

Pricing

Output	Cost
Per image	$0.12

Best Use Cases

Photo Retouching — Remove unwanted objects, fix imperfections, enhance details.
Creative Editing — Transform scenes, change backgrounds, add artistic elements.
Product Photography — Modify product images, change colors, adjust compositions.
Content Creation — Adapt existing visuals for different contexts and platforms.
Design Iteration — Quickly explore variations of existing artwork.

Pro Tips

Use clear, specific instructions for best results (e.g., "remove the person in the background" instead of "clean up the image").
Upload high-quality source images for better editing results.
Use the Prompt Enhancer to refine your editing instructions.
Multiple images can provide additional context for complex edits.
Keep the same seed when comparing different edit instructions.

Notes

Both prompt and images are required fields.
Ensure uploaded image URLs are publicly accessible.
Resolution range is 256-1536 pixels for both width and height.
For best quality, match output dimensions to your source image aspect ratio.

Related Models

Hunyuan Image 3 Instruct — Text-to-image generation with the same model family.
Qwen-Image Edit-Plus — Advanced image editing with bilingual text support.

Hunyuan Image 3 Instruct Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-image-3-instruct/edit 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 Hunyuan Image 3 Instruct Edit below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-image-3-instruct/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",
    "seed": -1
}'

# 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/hunyuan-image-3-instruct/edit", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "seed": -1
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/hunyuan-image-3-instruct/edit",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "seed": -1
}
)

print(output["outputs"][0])  # → URL of the generated output

Hunyuan Image 3 Instruct Edit API — Frequently asked questions

What is the Hunyuan Image 3 Instruct Edit API?

Hunyuan Image 3 Instruct Edit is a WaveSpeedAI model for image editing, exposed as a REST API on WaveSpeedAI. Hunyuan Image 3.0 Instruct Edit – instruction-based image editing with natural language prompts, supporting up to 2 reference images for precise modifications. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Hunyuan Image 3 Instruct 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 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/hunyuan-image-3-instruct-edit.

How much does Hunyuan Image 3 Instruct Edit cost per run?

Hunyuan Image 3 Instruct Edit starts at $0.12 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 Hunyuan Image 3 Instruct Edit accept?

Key inputs: `prompt`, `images`, `seed`. 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/hunyuan-image-3-instruct-edit.

How long does Hunyuan Image 3 Instruct Edit take to generate?

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

Can I use Hunyuan Image 3 Instruct 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