alibaba/
图生图更多设置（10 项）
请填写带 * 的必填参数，并检查数字格式。
$0.01 / 百万像素 · 按每张图实际像素计费
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.
价格
单价 $0.01 / 百万像素
按每张图的实际像素计费；尺寸越大、张数越多，费用越高。1024×1024 约为 1 百万像素。
每次请求会先临时冻结 $0.02，按实际用量扣费，通常在一分钟内完成：多余部分退回，超出部分从余额扣除，余额可能因此变为负数；余额为负时新请求暂停，充值后先抵扣欠款。
生成失败不收费。
API 接入
用这个模型 ID 提交生成请求。
/v1/model-tasksalibaba/z-image-turbo-inpaint/image-to-image{
"model": "alibaba/z-image-turbo-inpaint/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.",
"image_url": "<image_url>",
"mask_image_url": "<mask_image_url>"
}
}输入 Schema
| 参数 | 类型 | 是否必填 | 默认值 |
|---|---|---|---|
| image_url | string | 必填 | — |
| mask_image_url | string | 必填 | — |
| prompt | string | 必填 | — |
| acceleration | string | 可选 | regular |
| control_end | number | 可选 | 0.8 |
| control_scale | number | 可选 | 0.75 |
| control_start | number | 可选 | 0 |
| enable_prompt_expansion | boolean | 可选 | false |
| image_size | object | string | 可选 | auto |
| num_images | integer | 可选 | 1 |
| num_inference_steps | integer | 可选 | 8 |
| output_format | string | 可选 | png |
| seed | integer | 可选 | — |
| strength | number | 可选 | 1 |
返回结果
接口会返回生成结果，或返回可轮询的异步任务；具体响应方式与结果字段见下方示例和 Schema。
调用示例
异步任务提交后返回任务 ID，轮询至 status 为 completed 后，按返回结果获取生成内容。API Key 在控制台获取。
# 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-inpaint/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.","image_url":"<image_url>","mask_image_url":"<mask_image_url>"}}'
# 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"