alibaba/
Text to ImageAlibaba's Z-Image Turbo Tiling generates seamless, repeatable textures and patterns from a text description. Built for game materials, fabric prints, wallpapers and 3D surfaces, tiling horizontally, vertically or both, with adjustable tile size and stride and an optional source image or mask.
More settings (10)
$0.02 / megapixel · billed by each image's actual pixels
A hyper-realistic, high-resolution 4k texture of an ancient weathered brick wall heavily overgrown with lush green moss and soft lichens. The bricks are aged, featuring deep earthy tones, natural cracks, and gritty textures. Vibrant emerald moss fills the mortar lines and spills over the rough surfaces of the stones. Uniform, flat cinematic lighting ensures no harsh shadows, highlighting the intricate organic details and damp stone surfaces. The composition is a perfectly balanced overhead view, showcasing a rich tapestry of botanical growth and masonry craftsmanship with professional clarity and hyper-detailed grit.
Pricing
Unit price $0.02 / 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.04; 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.
/v1/model-tasksalibaba/z-image-turbo-tiling/text-to-image{
"model": "alibaba/z-image-turbo-tiling/text-to-image",
"input": {
"prompt": "A hyper-realistic, high-resolution 4k texture of an ancient weathered brick wall heavily overgrown with lush green moss and soft lichens. The bricks are aged, featuring deep earthy tones, natural cracks, and gritty textures. Vibrant emerald moss fills the mortar lines and spills over the rough surfaces of the stones. Uniform, flat cinematic lighting ensures no harsh shadows, highlighting the intricate organic details and damp stone surfaces. The composition is a perfectly balanced overhead view, showcasing a rich tapestry of botanical growth and masonry craftsmanship with professional clarity and hyper-detailed grit.",
"acceleration": "regular",
"enable_prompt_expansion": false,
"image_size": "square_hd",
"num_images": 1,
"num_inference_steps": 8,
"output_format": "png",
"strength": 0.6,
"tile_size": 128,
"tile_stride": 64,
"tiling_mode": "both"
}
}Input schema
| Parameter | Type | Requirement | Default |
|---|---|---|---|
| prompt | string | Required | — |
| acceleration | string | Optional | regular |
| enable_prompt_expansion | boolean | Optional | false |
| image_size | object | string | Optional | square_hd |
| image_url | string | Optional | — |
| mask_image_url | string | Optional | — |
| num_images | integer | Optional | 1 |
| num_inference_steps | integer | Optional | 8 |
| output_format | string | Optional | png |
| seed | integer | Optional | — |
| strength | number | Optional | 0.6 |
| tile_size | integer | Optional | 128 |
| tile_stride | integer | Optional | 64 |
| tiling_mode | string | Optional | both |
Response
The API returns a result or a pollable asynchronous task. See the examples and Schema below for the response mode and result fields.
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-tiling/text-to-image","input":{"prompt":"A hyper-realistic, high-resolution 4k texture of an ancient weathered brick wall heavily overgrown with lush green moss and soft lichens. The bricks are aged, featuring deep earthy tones, natural cracks, and gritty textures. Vibrant emerald moss fills the mortar lines and spills over the rough surfaces of the stones. Uniform, flat cinematic lighting ensures no harsh shadows, highlighting the intricate organic details and damp stone surfaces. The composition is a perfectly balanced overhead view, showcasing a rich tapestry of botanical growth and masonry craftsmanship with professional clarity and hyper-detailed grit.","acceleration":"regular","enable_prompt_expansion":false,"image_size":"square_hd","num_images":1,"num_inference_steps":8,"output_format":"png","strength":0.6,"tile_size":128,"tile_stride":64,"tiling_mode":"both"}}'
# 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"