alibaba/
文生图更多设置（6 项）
$0.005 / 百万像素 · 按每张图实际像素计费
A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of dried flowers, seed pods, and rusted bottle caps. The focus is razor-sharp on the texture of the skin, showing every pore, wrinkle, and scar that tells a story of survival. The background is a blurred, smoky hut interior, with the warm glow of a cooking fire reflecting in the subject's dark, soulful eyes. Shot on a Leica M6 with Kodak Portra 400 film grain aesthetic.
价格
单价 $0.005 / 百万像素
按每张图的实际像素计费；尺寸越大、张数越多，费用越高。1024×1024 约为 1 百万像素。
每次请求会先临时冻结 $0.01，按实际用量扣费，通常在一分钟内完成：多余部分退回，超出部分从余额扣除，余额可能因此变为负数；余额为负时新请求暂停，充值后先抵扣欠款。
生成失败不收费。
API 接入
用这个模型 ID 提交生成请求。
/v1/model-tasksalibaba/z-image-turbo/text-to-image{
"model": "alibaba/z-image-turbo/text-to-image",
"input": {
"prompt": "A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of dried flowers, seed pods, and rusted bottle caps. The focus is razor-sharp on the texture of the skin, showing every pore, wrinkle, and scar that tells a story of survival. The background is a blurred, smoky hut interior, with the warm glow of a cooking fire reflecting in the subject's dark, soulful eyes. Shot on a Leica M6 with Kodak Portra 400 film grain aesthetic.",
"acceleration": "regular",
"enable_prompt_expansion": false,
"image_size": "landscape_4_3",
"num_images": 1,
"num_inference_steps": 8,
"output_format": "png"
}
}输入 Schema
| 参数 | 类型 | 是否必填 | 默认值 |
|---|---|---|---|
| prompt | string | 必填 | — |
| acceleration | string | 可选 | regular |
| enable_prompt_expansion | boolean | 可选 | false |
| image_size | object | string | 可选 | landscape_4_3 |
| num_images | integer | 可选 | 1 |
| num_inference_steps | integer | 可选 | 8 |
| output_format | string | 可选 | png |
| seed | integer | 可选 | — |
返回结果
接口会返回生成结果，或返回可轮询的异步任务；具体响应方式与结果字段见下方示例和 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/text-to-image","input":{"prompt":"A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of dried flowers, seed pods, and rusted bottle caps. The focus is razor-sharp on the texture of the skin, showing every pore, wrinkle, and scar that tells a story of survival. The background is a blurred, smoky hut interior, with the warm glow of a cooking fire reflecting in the subject'\''s dark, soulful eyes. Shot on a Leica M6 with Kodak Portra 400 film grain aesthetic.","acceleration":"regular","enable_prompt_expansion":false,"image_size":"landscape_4_3","num_images":1,"num_inference_steps":8,"output_format":"png"}}'
# 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"