API reference · Alibaba

alibaba/z-image/turbo/tiling/lora

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

IMAGEAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDalibaba/z-image/turbo/tiling/lora

Input Schema

11 parameters · 2 required · 9 optional

Parameter	Type	Required	Description
`image`	string	Required	URL of an image for image-to-image or inpainting. When provided without mask_image_url, performs image-to-image; with mask_image_url, performs inpainting.
`prompt`	string	Required	The prompt to generate an image from.
`mask`	string	Optional	URL of a mask image for inpainting. White regions are regenerated, black regions are preserved. Requires image_url.
`seed`	integer	Optional	The same seed and the same prompt given to the same version of the model will output the same image every time.
`loras`	object[]	Optional	List of LoRA weights to apply (maximum 3). · Default: []
`strength`	number	Optional	How much to transform the input image. Only used when image_url is provided. · Max: 1 · Default: 0.6
`tile_size`	integer	Optional	Tile size in latent space. Must be even (divisible by 2) for patchification. (64 = 512px, 128 = 1024px, 256 = 2048px). · Min: 32 · Max: 256 · Default: 128
`tile_stride`	integer	Optional	Tile stride in latent space. Must be even (divisible by 2). (32 = 256px, 64 = 512px, 128 = 1024px). · Min: 16 · Max: 128 · Default: 64
`tiling_mode`	string	Optional	Tiling direction: 'both' (omnidirectional), 'horizontal' (left-right only), 'vertical' (top-bottom only). · Options: both, horizontal, vertical · Default: "both" bothhorizontalvertical
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "alibaba/z-image/turbo/tiling/lora",
  "loras": [],
  "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.",
  "strength": 0.6,
  "tile_size": 128,
  "tile_stride": 64,
  "tiling_mode": "both",
  "output_format": "png"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Z-Image Turbo Seamless Tiling