WaveSpeedAI APIWavespeed AIZ Image Turbo Image To Image

Z Image Turbo Image To Image

Z Image Turbo Image To Image

Playground

Try it on WavespeedAI!

Z-Image-Turbo Image-to-Image is a 6 billion parameter model that enhances the quality of reference images (similar to upscaling) in sub-second time. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

Z-Image Turbo Image-to-Image

Z-Image Turbo Image-to-Image is a versatile image generation model that offers a spectrum of modifications — from subtle enhancement to dramatic reimagination. The key is the strength parameter: at low values, it preserves your original image while enhancing quality (similar to upscaling); at high values, it uses your image as loose inspiration for entirely new creations.

This is not a simple editing tool — it’s a generation engine that lets you control exactly how much of the original image to preserve.


Why Choose This?

  • Flexible transformation spectrum From near-lossless enhancement to complete style overhaul — all controlled by a single strength slider.

  • Quality enhancement mode At low strength, improve image quality, add detail, and sharpen without changing content.

  • Creative reimagination mode At high strength, use your image as a reference while dramatically changing style, composition, or subject.

  • Custom output sizing Set exact width and height for your output, independent of input dimensions.

  • Prompt Enhancer Built-in tool to automatically improve your prompts for better results.

  • Fast and affordable Turbo-optimized for quick generation at just $0.005 per image.


Understanding Strength

The strength parameter is the core of this model. It controls how much the output differs from your input image:

StrengthEffectUse Case
0.0 - 0.3Minimal change — enhances quality, adds detail, sharpensUpscaling, quality improvement, subtle refinement
0.3 - 0.6Moderate change — preserves structure, adjusts styleStyle tweaks, color grading, texture enhancement
0.6 - 0.8Significant change — keeps composition, transforms contentStyle transfer, artistic reinterpretation
0.8 - 1.0Maximum change — uses image as loose reference onlyCreative reimagination, dramatic transformation

Parameters

ParameterRequiredDescription
promptYesText description guiding the transformation
imageYesSource image to transform (upload or URL)
widthNoOutput width in pixels (default: 1024)
heightNoOutput height in pixels (default: 1024)
strengthNoTransformation intensity 0-1 (default: 0.6)
seedNoRandom seed for reproducibility (-1 for random)

How to Use

  1. Upload your image — drag and drop or paste a public URL.
  2. Write your prompt — describe the desired output or transformation.
  3. Set strength — low for enhancement, high for reimagination.
  4. Adjust output size — set width and height as needed.
  5. Run — submit and download the transformed image.

Pricing

ItemCost
Per image$0.005

Simple flat-rate pricing regardless of image size or strength setting.


Best Use Cases

  • Image Enhancement (strength 0-0.3) — Improve quality, add sharpness, enhance details without changing content.
  • Style Transfer (strength 0.5-0.8) — Apply new artistic styles while preserving composition.
  • Creative Reimagination (strength 0.8-1.0) — Use images as inspiration for entirely new creations.
  • Batch Processing — Affordable pricing enables large-scale image transformation.
  • Iterative Design — Quickly explore variations with different strength levels.

Pro Tips

  • Start with strength 0.5 to understand how the model interprets your image, then adjust.
  • For quality enhancement without content change, use strength below 0.3 with a prompt describing the desired quality.
  • For dramatic transformations, use strength above 0.8 with a detailed prompt describing the new style.
  • The prompt matters more at higher strength values; at low strength, the image dominates.
  • Use the same seed to compare different strength levels on the same image.

Notes

  • Output dimensions can differ from input — set width and height to your target size.
  • At strength 0, output will be nearly identical to input (useful for testing).
  • At strength 1, output may differ significantly while retaining some compositional elements.

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/z-image-turbo/image-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "1024*1024",
    "strength": 0.6,
    "seed": -1,
    "enable_sync_mode": false,
    "enable_base64_output": false
}'

# 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-Reference image URL to guide the generation style or composition.
sizestringNo1024*1024256 ~ 1536 per dimensionThe size of the generated media in pixels (width*height).
strengthnumberNo0.60.00 ~ 1.00Controls the strength of the transformation. Higher values produce outputs more different from the input image.
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.
enable_sync_modebooleanNofalse-If set to true, the function will wait for the result to be generated and uploaded before returning the response. This property is only available through the API.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

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.