WaveSpeedAI APIWavespeed AIZ Image Turbo Image To Image LoRA

Z Image Turbo Image To Image LoRA

Z Image Turbo Image To Image LoRA

Playground

Try it on WavespeedAI!

Z-Image-Turbo Image-to-Image LoRA transforms reference images with custom LoRA styles in sub-second time. Apply up to 3 LoRAs for personalized image transformation. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

Z-Image Turbo Image-to-Image LoRA

Z-Image Turbo Image-to-Image LoRA is a versatile image generation model with full LoRA support. Apply up to 3 custom LoRA adapters while controlling the transformation spectrum — from subtle enhancement to dramatic reimagination — all via the strength parameter.

This is not a simple editing tool — it’s a generation engine that combines custom styles with flexible image modification.

Looking for the standard version? Try Z-Image Turbo Image-to-Image without LoRA support.


Why Choose This?

  • LoRA support Apply up to 3 custom LoRA adapters to personalize style, characters, or visual aesthetics.

  • 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 and add detail while applying subtle LoRA styles.

  • Creative reimagination mode At high strength, combine LoRA styles with dramatic image transformation.

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


Understanding Strength

The strength parameter controls how much the output differs from your input image:

StrengthEffectUse Case
0.0 - 0.3Minimal change — enhances quality, applies subtle LoRA styleUpscaling with style hints, quality improvement
0.3 - 0.6Moderate change — preserves structure, blends LoRA styleStyle fusion, character consistency
0.6 - 0.8Significant change — keeps composition, strong LoRA influenceStyle transfer, artistic reinterpretation
0.8 - 1.0Maximum change — LoRA style dominates, image as referenceCreative reimagination, full style transformation

Parameters

ParameterRequiredDescription
promptYesText description guiding the transformation
imageYesSource image to transform (upload or URL)
lorasNoList of LoRA adapters to apply (up to 3)
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)

LoRA Format

Each LoRA in the loras array has:

  • path (required) — URL to the LoRA weights file
  • scale (optional) — Weight multiplier, default 1

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. Add LoRAs — click ”+ Add Item” to include custom LoRA adapters (up to 3).
  4. Set strength — low for enhancement, high for reimagination.
  5. Adjust output size — set width and height as needed.
  6. Run — submit and download the transformed image.

Pricing

ItemCost
Per image$0.01

Simple flat-rate pricing regardless of image size, strength, or LoRA count.


Best Use Cases

  • Character Transformation — Apply character LoRAs while preserving pose and composition.
  • Style Transfer with Control — Use style LoRAs with adjustable strength for precise blending.
  • Brand Consistency — Transform images to match brand aesthetics via custom LoRAs.
  • Artistic Reinterpretation — Combine multiple art style LoRAs for unique hybrid looks.
  • Quality Enhancement — Improve image quality while subtly applying trained styles.

Pro Tips

  • Start with strength 0.5-0.6 to balance original image and LoRA influence.
  • LoRA effect is more visible at higher strength values.
  • Combine LoRAs carefully — multiple LoRAs can conflict; test combinations.
  • If your LoRA uses trigger words, include them in your prompt.
  • Use the same seed to compare different strength levels or LoRA combinations.

Notes

  • Up to 3 LoRAs can be applied simultaneously.
  • LoRA version pricing is 2× the standard version.
  • Output dimensions can differ from input — set width and height to your target size.
  • At low strength, the original image dominates; at high strength, LoRA styles dominate.

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-lora" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "loras": [],
    "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.
lorasarrayNomax 3 itemsList of LoRAs to apply (maximum 3).
loras[].pathstringYes-Path to the LoRA model
loras[].scalefloatYes-0.0 ~ 4.0Scale of the LoRA model
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.