Skip to content

Z-Image Turbo Seamless Tiling

Integrate

Model id z-image/turbo/tiling
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/z-image/turbo/tiling?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.02 20 API credits your files are measured before the run Run it on this page

Get API key
Alibaba · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Prompt that guides image generation.

image_size default square_hd

Generated image dimensions, with 'auto' choosing 1024x1024 unless an input image is supplied, in which case its dimensions are used.

num_images default 1

Image count requested for generation.

Advanced image · mask_image_url · output_format · acceleration · tiling_mode · num_inference_steps · strength · tile_size · tile_stride · seed · enable_safety_checker · enable_prompt_expansion
image_url
Drop a file, or

Image URL used for either image-to-image generation or inpainting. Supplying mask_image_url selects inpainting; omitting it selects image-to-image generation.

Drop a file, or

Inpainting mask URL supplied alongside the required image_url. The mask retains black areas unchanged and regenerates white areas.

output_format default png

File format for the resulting image.

acceleration default regular

Acceleration level applied to processing.

tiling_mode default both

Direction of tiling: 'both' covers all directions, 'horizontal' covers only left to right, and 'vertical' covers only top to bottom.

default 8

Count of inference steps to run.

default 0.6

Transformation strength applied only to an image supplied through image_url; otherwise unused.

default 128

Latent-space tile size, where 64 corresponds to 512px, 128 to 1024px, and 256 to 2048px. Dimensions of the generated image automatically cap the size along tiled axes; patchification requires an even value, divisible by 2.

default 64

Latent-space tile stride, with pixel equivalents of 32 = 256px, 64 = 512px, and 128 = 1024px. Only multiples of 2 are valid; any value above half of the effective tile size is automatically reduced to that limit.

Seed for reproducible images: an identical prompt and seed produce an identical image when the model version is unchanged.

POST /run/z-image/turbo/tiling?wait=20 quote → $0.02
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/z-image/turbo/tiling?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Z-Image Turbo Seamless Tiling

Generates images that repeat across edges, controlled by `tiling_mode` (both, horizontal or vertical), `tile_size` and `tile_stride`. Runs up to 8 inference steps and returns 1 to 4 images in png, jpeg or webp. Supplying `image_url` enables image-to-image, and adding `mask_image_url` enables inpainting. `strength` sets how much the input changes.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Prompt that guides image generation.
image_sizeoptional
Typeobject
Defaultsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Generated image dimensions, with 'auto' choosing 1024x1024 unless an input image is supplied, in which case its dimensions are used.
num_inference_stepsoptional
Typeinteger
Default8
1 – 8
Count of inference steps to run.
seedoptional
Typeinteger | null
Seed for reproducible images: an identical prompt and seed produce an identical image when the model version is unchanged.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Image count requested for generation.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Safety checking, which returns black images in place of any images flagged unsafe. A value of true enables checking; false disables it only for authorized accounts, while requests without authorization are checked regardless.
output_formatoptional
Typeenum
Defaultpng
jpegpngwebp
File format for the resulting image.
accelerationoptional
Typeenum
Defaultregular
noneregularhigh
Acceleration level applied to processing.
enable_prompt_expansionoptional
Typeboolean
Defaultfalse
Controls whether prompt expansion is enabled.
image_urloptional image
Typeurl · image
Image URL used for either image-to-image generation or inpainting. Supplying mask_image_url selects inpainting; omitting it selects image-to-image generation.
mask_image_urloptional
Typeurl · image
Inpainting mask URL supplied alongside the required image_url. The mask retains black areas unchanged and regenerates white areas.
strengthoptional
Typenumber
Default0.6
≤ 1> 0
Transformation strength applied only to an image supplied through image_url; otherwise unused.
tile_sizeoptional
Typeinteger
Default128
32 – 256
Latent-space tile size, where 64 corresponds to 512px, 128 to 1024px, and 256 to 2048px. Dimensions of the generated image automatically cap the size along tiled axes; patchification requires an even value, divisible by 2.
tile_strideoptional
Typeinteger
Default64
16 – 128
Latent-space tile stride, with pixel equivalents of 32 = 256px, 64 = 512px, and 128 = 1024px. Only multiples of 2 are valid; any value above half of the effective tile size is automatically reduced to that limit.
tiling_modeoptional
Typeenum
Defaultboth
bothhorizontalvertical
Direction of tiling: 'both' covers all directions, 'horizontal' covers only left to right, and 'vertical' covers only top to bottom.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "z-image/turbo/tiling",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 20,
    "usd": "0.02",
    "charged": 20,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}File information for the generated images.
timings
objectTiming information for the generation process.
seed
integerImage-generation seed, including the randomly chosen value if the input omitted a seed; otherwise, it repeats the supplied value.
has_nsfw_concepts
array of booleanIndicates whether NSFW concepts appear in the generated images.
prompt
stringPrompt used during image generation.

More models: Text to Image

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/z-image/turbo/tiling.md. All models and guides: https://doitong.com/developers/llms.txt