Langkau ke kandungan

Z-Image Turbo Seamless Tiling

Integrasikan

ID model 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"

Fail seperti contoh: $0.02 20 kredit API fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Alibaba · Imej

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Prompt yang memandu penjanaan imej.

image_size lalai square_hd

Dimensi imej yang dijana, dengan 'auto' memilih 1024x1024 melainkan imej input dibekalkan; dalam keadaan itu, dimensinya digunakan.

num_images lalai 1

Bilangan imej yang diminta untuk penjanaan.

Lanjutan 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
Lepaskan fail, atau

URL imej yang digunakan untuk penjanaan imej-ke-imej atau inpainting. Membekalkan mask_image_url memilih inpainting; meninggalkannya memilih penjanaan imej-ke-imej.

Lepaskan fail, atau

URL topeng inpainting yang dibekalkan bersama image_url yang diperlukan. Topeng mengekalkan kawasan hitam tanpa perubahan dan menjana semula kawasan putih.

output_format lalai png

Format fail untuk imej yang terhasil.

acceleration lalai regular

Tahap pecutan yang digunakan pada pemprosesan.

tiling_mode lalai both

Arah penjubinan: 'both' meliputi semua arah, 'horizontal' hanya dari kiri ke kanan, dan 'vertical' hanya dari atas ke bawah.

lalai 8

Bilangan langkah inferens yang perlu dijalankan.

lalai 0.6

Kekuatan transformasi yang hanya digunakan pada imej yang dibekalkan melalui image_url; jika tidak, tidak digunakan.

lalai 128

Saiz jubin ruang laten, dengan 64 bersamaan 512px, 128 bersamaan 1024px dan 256 bersamaan 2048px. Dimensi imej yang dijana mengehadkan saiz secara automatik sepanjang paksi berjubin; patchification memerlukan nilai genap yang boleh dibahagi dengan 2.

lalai 64

Langkah jubin ruang laten, dengan kesetaraan piksel 32 = 256px, 64 = 512px dan 128 = 1024px. Hanya gandaan 2 yang sah; sebarang nilai melebihi separuh saiz jubin berkesan akan dikurangkan secara automatik kepada had tersebut.

Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.

POST /run/z-image/turbo/tiling?wait=20 sebut harga → $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"

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Z-Image Turbo Seamless Tiling

Menjana imej yang berulang merentasi tepi, dikawal oleh `tiling_mode` (both, horizontal atau vertical), `tile_size` dan `tile_stride`. Menjalankan sehingga 8 langkah inferens dan mengembalikan 1 hingga 4 imej dalam png, jpeg atau webp. Membekalkan `image_url` membolehkan imej-ke-imej, manakala menambah `mask_image_url` membolehkan inpainting. `strength` menetapkan tahap perubahan pada input.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Prompt yang memandu penjanaan imej.
image_sizepilihan
Jenisobject
Lalaisquare_hd
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Dimensi imej yang dijana, dengan 'auto' memilih 1024x1024 melainkan imej input dibekalkan; dalam keadaan itu, dimensinya digunakan.
num_inference_stepspilihan
Jenisinteger
Lalai8
1 – 8
Bilangan langkah inferens yang perlu dijalankan.
seedpilihan
Jenisinteger | null
Seed untuk imej yang boleh dihasilkan semula: prompt dan seed yang sama menghasilkan imej yang sama apabila versi model tidak berubah.
num_imagespilihan num_outputs
Jenisinteger
Lalai1
1 – 4
Bilangan imej yang diminta untuk penjanaan.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Pemeriksaan keselamatan, yang mengembalikan imej hitam menggantikan imej yang ditandai tidak selamat. Nilai true mendayakan pemeriksaan; false melumpuhkannya hanya untuk akaun yang dibenarkan, manakala permintaan tanpa kebenaran tetap diperiksa.
output_formatpilihan
Jenisenum
Lalaipng
jpegpngwebp
Format fail untuk imej yang terhasil.
accelerationpilihan
Jenisenum
Lalairegular
noneregularhigh
Tahap pecutan yang digunakan pada pemprosesan.
enable_prompt_expansionpilihan
Jenisboolean
Lalaifalse
Mengawal sama ada pengembangan prompt didayakan.
image_urlpilihan image
Jenisurl · image
URL imej yang digunakan untuk penjanaan imej-ke-imej atau inpainting. Membekalkan mask_image_url memilih inpainting; meninggalkannya memilih penjanaan imej-ke-imej.
mask_image_urlpilihan
Jenisurl · image
URL topeng inpainting yang dibekalkan bersama image_url yang diperlukan. Topeng mengekalkan kawasan hitam tanpa perubahan dan menjana semula kawasan putih.
strengthpilihan
Jenisnumber
Lalai0.6
≤ 1> 0
Kekuatan transformasi yang hanya digunakan pada imej yang dibekalkan melalui image_url; jika tidak, tidak digunakan.
tile_sizepilihan
Jenisinteger
Lalai128
32 – 256
Saiz jubin ruang laten, dengan 64 bersamaan 512px, 128 bersamaan 1024px dan 256 bersamaan 2048px. Dimensi imej yang dijana mengehadkan saiz secara automatik sepanjang paksi berjubin; patchification memerlukan nilai genap yang boleh dibahagi dengan 2.
tile_stridepilihan
Jenisinteger
Lalai64
16 – 128
Langkah jubin ruang laten, dengan kesetaraan piksel 32 = 256px, 64 = 512px dan 128 = 1024px. Hanya gandaan 2 yang sah; sebarang nilai melebihi separuh saiz jubin berkesan akan dikurangkan secara automatik kepada had tersebut.
tiling_modepilihan
Jenisenum
Lalaiboth
bothhorizontalvertical
Arah penjubinan: 'both' meliputi semua arah, 'horizontal' hanya dari kiri ke kanan, dan 'vertical' hanya dari atas ke bawah.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
images
array of object {url, content_type, file_name, file_size, width, height}Maklumat fail untuk imej yang dijana.
timings
objectMaklumat masa untuk proses penjanaan.
seed
integerSeed penjanaan imej, termasuk nilai yang dipilih secara rawak jika input tidak membekalkan seed; jika tidak, nilai yang dibekalkan diulang.
has_nsfw_concepts
array of booleanMenunjukkan sama ada konsep NSFW muncul dalam imej yang dijana.
prompt
stringPrompt yang digunakan semasa penjanaan imej.

Lebih banyak model: Teks ke Imej

Untuk ejen AI: halaman ini dalam Markdown tersedia di https://doitong.com/ms/developers/models/z-image/turbo/tiling.md. Semua model dan panduan: https://doitong.com/developers/llms.txt