Bỏ qua đến nội dung

Z-Image Turbo Seamless Tiling

Tích hợp

Id mô hình 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"

Các tệp như ví dụ: 0,02 $ 20 tín dụng API tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Alibaba · Hình ảnh

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Lời nhắc định hướng việc tạo sinh hình ảnh.

image_size mặc định square_hd

Kích thước hình ảnh được tạo, trong đó 'auto' chọn 1024x1024 trừ khi có hình ảnh đầu vào; khi đó, kích thước của hình ảnh đầu vào sẽ được sử dụng.

num_images mặc định 1

Số lượng hình ảnh yêu cầu tạo sinh.

Nâng cao 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
Thả tệp hoặc

URL hình ảnh được sử dụng cho quá trình tạo sinh hình ảnh sang hình ảnh hoặc tô lại. Cung cấp mask_image_url sẽ chọn chế độ tô lại; bỏ qua tham số này sẽ chọn chế độ tạo sinh hình ảnh sang hình ảnh.

Thả tệp hoặc

URL mặt nạ inpainting được cung cấp cùng image_url bắt buộc. Mặt nạ giữ nguyên các vùng đen và tạo lại các vùng trắng.

output_format mặc định png

Định dạng tệp của hình ảnh kết quả.

acceleration mặc định regular

Mức tăng tốc áp dụng cho quá trình xử lý.

tiling_mode mặc định both

Hướng chia ô: 'both' bao phủ mọi hướng, 'horizontal' chỉ bao phủ từ trái sang phải và 'vertical' chỉ bao phủ từ trên xuống dưới.

mặc định 8

Số bước suy luận cần chạy.

mặc định 0.6

Cường độ biến đổi chỉ áp dụng cho hình ảnh được cung cấp qua image_url; nếu không thì không được sử dụng.

mặc định 128

Kích thước ô trong không gian tiềm ẩn, trong đó 64 tương ứng với 512px, 128 tương ứng với 1024px và 256 tương ứng với 2048px. Kích thước của hình ảnh được tạo sẽ tự động giới hạn kích thước dọc theo các trục được chia ô; quá trình phân mảnh yêu cầu giá trị chẵn, chia hết cho 2.

mặc định 64

Bước trượt của ô trong không gian tiềm ẩn, với các giá trị tương đương theo pixel là 32 = 256px, 64 = 512px và 128 = 1024px. Chỉ các bội số của 2 mới hợp lệ; mọi giá trị lớn hơn một nửa kích thước ô hiệu dụng sẽ tự động được giảm xuống giới hạn đó.

Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.

POST /run/z-image/turbo/tiling?wait=20 báo giá → 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"

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Z-Image Turbo Seamless Tiling

Tạo hình ảnh lặp qua các cạnh, được điều khiển bởi `tiling_mode` (both, horizontal hoặc vertical), `tile_size` và `tile_stride`. Chạy tối đa 8 bước suy luận và trả về 1 đến 4 hình ảnh ở định dạng png, jpeg hoặc webp. Cung cấp `image_url` sẽ bật chuyển đổi hình ảnh sang hình ảnh, còn thêm `mask_image_url` sẽ bật inpainting. `strength` xác định mức độ thay đổi của đầu vào.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
Lời nhắc định hướng việc tạo sinh hình ảnh.
image_sizetùy chọn
Kiểuobject
Mặc địnhsquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Kích thước hình ảnh được tạo, trong đó 'auto' chọn 1024x1024 trừ khi có hình ảnh đầu vào; khi đó, kích thước của hình ảnh đầu vào sẽ được sử dụng.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định8
1 – 8
Số bước suy luận cần chạy.
seedtùy chọn
Kiểuinteger | null
Seed cho hình ảnh có thể tái tạo: lời nhắc và seed giống hệt nhau sẽ tạo ra hình ảnh giống hệt khi phiên bản mô hình không đổi.
num_imagestùy chọn num_outputs
Kiểuinteger
Mặc định1
1 – 4
Số lượng hình ảnh yêu cầu tạo sinh.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm tra an toàn, trả về hình ảnh màu đen thay cho mọi hình ảnh bị đánh dấu không an toàn. Giá trị true bật kiểm tra; false chỉ tắt kiểm tra đối với tài khoản được cấp quyền, còn các yêu cầu không được cấp quyền vẫn luôn được kiểm tra.
output_formattùy chọn
Kiểuenum
Mặc địnhpng
jpegpngwebp
Định dạng tệp của hình ảnh kết quả.
accelerationtùy chọn
Kiểuenum
Mặc địnhregular
noneregularhigh
Mức tăng tốc áp dụng cho quá trình xử lý.
enable_prompt_expansiontùy chọn
Kiểuboolean
Mặc địnhfalse
Kiểm soát việc bật mở rộng lời nhắc.
image_urltùy chọn image
Kiểuurl · image
URL hình ảnh được sử dụng cho quá trình tạo sinh hình ảnh sang hình ảnh hoặc tô lại. Cung cấp mask_image_url sẽ chọn chế độ tô lại; bỏ qua tham số này sẽ chọn chế độ tạo sinh hình ảnh sang hình ảnh.
mask_image_urltùy chọn
Kiểuurl · image
URL mặt nạ inpainting được cung cấp cùng image_url bắt buộc. Mặt nạ giữ nguyên các vùng đen và tạo lại các vùng trắng.
strengthtùy chọn
Kiểunumber
Mặc định0.6
≤ 1> 0
Cường độ biến đổi chỉ áp dụng cho hình ảnh được cung cấp qua image_url; nếu không thì không được sử dụng.
tile_sizetùy chọn
Kiểuinteger
Mặc định128
32 – 256
Kích thước ô trong không gian tiềm ẩn, trong đó 64 tương ứng với 512px, 128 tương ứng với 1024px và 256 tương ứng với 2048px. Kích thước của hình ảnh được tạo sẽ tự động giới hạn kích thước dọc theo các trục được chia ô; quá trình phân mảnh yêu cầu giá trị chẵn, chia hết cho 2.
tile_stridetùy chọn
Kiểuinteger
Mặc định64
16 – 128
Bước trượt của ô trong không gian tiềm ẩn, với các giá trị tương đương theo pixel là 32 = 256px, 64 = 512px và 128 = 1024px. Chỉ các bội số của 2 mới hợp lệ; mọi giá trị lớn hơn một nửa kích thước ô hiệu dụng sẽ tự động được giảm xuống giới hạn đó.
tiling_modetùy chọn
Kiểuenum
Mặc địnhboth
bothhorizontalvertical
Hướng chia ô: 'both' bao phủ mọi hướng, 'horizontal' chỉ bao phủ từ trái sang phải và 'vertical' chỉ bao phủ từ trên xuống dưới.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
images
array of object {url, content_type, file_name, file_size, width, height}Thông tin tệp của các hình ảnh được tạo.
timings
objectThông tin thời gian của quá trình tạo sinh.
seed
integerSeed tạo sinh hình ảnh, bao gồm giá trị được chọn ngẫu nhiên nếu đầu vào không cung cấp seed; nếu không, lặp lại giá trị đã cung cấp.
has_nsfw_concepts
array of booleanCho biết các khái niệm NSFW có xuất hiện trong hình ảnh được tạo sinh hay không.
prompt
stringLời nhắc được sử dụng trong quá trình tạo sinh hình ảnh.

Thêm mô hình: Văn bản sang hình ảnh

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/z-image/turbo/tiling.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt