alibaba/z-image-turbo/image-to-image

Image to Image

Alibaba's Z-Image Turbo reworks a reference image to follow a new prompt, using the original as a starting point. Good for restyling, variations and quick concept rounds, with a strength slider for how far results drift from the source, matched or custom sizes and prompt expansion.

Try it Get API keyOpenAPI llms.txt

Prompt *

A young Asian woman with long, vibrant purple hair stands on a sunlit sandy beach, posing confidently with her left hand resting on her hip. She gazes directly at the camera with a neutral expression. A sleek black ribbon bow is tied neatly on the right side of her head, just above her ear. She wears a flowing white cotton dress with a fitted bodice and a flared skirt that reaches mid-calf, slightly lifted by a gentle sea breeze. The beach behind her features fine, pale golden sand with subtle footprints, leading to calm turquoise waves under a clear blue sky with soft, wispy clouds. The lighting is natural daylight, casting soft shadows to her left, indicating late afternoon sun. The horizon line is visible in the background, with a faint silhouette of distant dunes. Her skin tone is fair with a natural glow, and her facial features are delicately defined. The composition is centered on her figure, framed from mid-thigh up, with shallow depth of field blurring the distant waves slightly.

Image URL *

Image size

More settings (7)

Acceleration

Enable prompt expansion

Number of Images

Number of inference steps

Output Format

Seed

Strength

ResultExampleSign in to try

$0.005 / megapixel · billed by each image's actual pixels

Example — generated from this input

Pricing

Unit price $0.005 / megapixel

Billed by the actual pixels of each image; larger sizes and more images cost more. 1024×1024 is about 1 megapixel.

Each request temporarily reserves $0.01; you are charged for actual usage, usually within a minute: any unused amount is released and any usage above it is charged to your balance, even if that takes it below zero; while your balance is below zero, new requests are paused until a top-up covers it.

Failed generations are not charged.

API

Submit generation requests with this model ID.

POST/v1/model-tasks

alibaba/z-image-turbo/image-to-image

Request body

{
  "model": "alibaba/z-image-turbo/image-to-image",
  "input": {
    "prompt": "A young Asian woman with long, vibrant purple hair stands on a sunlit sandy beach, posing confidently with her left hand resting on her hip. She gazes directly at the camera with a neutral expression. A sleek black ribbon bow is tied neatly on the right side of her head, just above her ear. She wears a flowing white cotton dress with a fitted bodice and a flared skirt that reaches mid-calf, slightly lifted by a gentle sea breeze. The beach behind her features fine, pale golden sand with subtle footprints, leading to calm turquoise waves under a clear blue sky with soft, wispy clouds. The lighting is natural daylight, casting soft shadows to her left, indicating late afternoon sun. The horizon line is visible in the background, with a faint silhouette of distant dunes. Her skin tone is fair with a natural glow, and her facial features are delicately defined. The composition is centered on her figure, framed from mid-thigh up, with shallow depth of field blurring the distant waves slightly.",
    "acceleration": "regular",
    "enable_prompt_expansion": false,
    "image_size": "auto",
    "image_url": "https://pub-a7287c8d5de944d984e22a5bd3ab9bbe.r2.dev/uploads/capability-demo-f59028295e7d92e35e556102850542d1.png",
    "num_images": 1,
    "num_inference_steps": 8,
    "output_format": "png",
    "strength": 0.6
  }
}

Input schema

Parameter	Type	Requirement	Default
image_url	string	Required	—
prompt	string	Required	—
acceleration	string	Optional	regular
enable_prompt_expansion	boolean	Optional	false
image_size	object \| string	Optional	auto
num_images	integer	Optional	1
num_inference_steps	integer	Optional	8
output_format	string	Optional	png
seed	integer	Optional	—
strength	number	Optional	0.6

Response

The API returns a result or a pollable asynchronous task. See the examples and Schema below for the response mode and result fields.

Asynchronous task

Submit response

HTTP 202

/v1/model-tasksapplication/json

{
  "id": "task_example",
  "model": "alibaba/z-image-turbo/image-to-image",
  "status": "queued"
}

Status response

HTTP 200

/v1/model-tasks/{id}application/json

{
  "id": "task_example",
  "model": "alibaba/z-image-turbo/image-to-image",
  "status": "completed",
  "output": {
    "images": [
      {
        "url": "https://api.musespan.com/v1/model-tasks/task_example/artifacts/0"
      }
    ]
  }
}

File download

HTTP 200

/v1/model-tasks/{id}/artifacts/{index}Generated image (e.g. image/png)

When the task completes, file URLs in output point to this endpoint, numbered from 0. Send the same API key (Authorization header) when downloading.

Error response

HTTP 400

/v1/model-tasksapplication/json

{
  "error": {
    "code": "invalid_input",
    "message": "The input does not match this model's input schema. Check the model's API documentation.",
    "type": "invalid_request_error"
  }
}

Code examples

Async submission returns a task ID. Poll until status is completed, then retrieve the generated content from the result. Get your API key in the console.

# Use a new directory for each new generation. Rerunning here continues this task.
set -eu
test -s model-task-id.txt || python3 -c "import uuid; print(uuid.uuid4())" > model-task-id.txt
REQUEST_ID=$(cat model-task-id.txt)
# Idempotent: resending the same bytes with the same ID never charges twice.
curl --fail-with-body --retry 3 --retry-connrefused --request POST 'https://api.musespan.com/v1/model-tasks' \
  --header "Authorization: Bearer $MUSESPAN_API_KEY" \
  --header "X-Request-Id: $REQUEST_ID" \
  --header "Content-Type: application/json" \
  --data '{"model":"alibaba/z-image-turbo/image-to-image","input":{"prompt":"A young Asian woman with long, vibrant purple hair stands on a sunlit sandy beach, posing confidently with her left hand resting on her hip. She gazes directly at the camera with a neutral expression. A sleek black ribbon bow is tied neatly on the right side of her head, just above her ear. She wears a flowing white cotton dress with a fitted bodice and a flared skirt that reaches mid-calf, slightly lifted by a gentle sea breeze. The beach behind her features fine, pale golden sand with subtle footprints, leading to calm turquoise waves under a clear blue sky with soft, wispy clouds. The lighting is natural daylight, casting soft shadows to her left, indicating late afternoon sun. The horizon line is visible in the background, with a faint silhouette of distant dunes. Her skin tone is fair with a natural glow, and her facial features are delicately defined. The composition is centered on her figure, framed from mid-thigh up, with shallow depth of field blurring the distant waves slightly.","acceleration":"regular","enable_prompt_expansion":false,"image_size":"auto","image_url":"https://pub-a7287c8d5de944d984e22a5bd3ab9bbe.r2.dev/uploads/capability-demo-f59028295e7d92e35e556102850542d1.png","num_images":1,"num_inference_steps":8,"output_format":"png","strength":0.6}}'
# Poll every 5 seconds for up to 25 minutes until status is completed or failed.
# Still queued (with queue_position) 5 minutes after submission: failed with queue_timeout, not charged.
# No result 15 minutes after acceptance (or no confirmation 15 minutes after submission): failed with generation_timeout, not charged.
# Any failure is final: generate again in a new directory (a new X-Request-Id).
# A 404 means the POST did not arrive: rerun this script to resend it with the same ID.
curl --fail-with-body 'https://api.musespan.com/v1/model-tasks/'"$REQUEST_ID"'' --header "Authorization: Bearer $MUSESPAN_API_KEY"