Model teks-ke-gambar ringan untuk generasi cepat, dengan dukungan rendering teks Tiongkok dan Inggris serta resolusi fleksibel.
Contoh
Input prompt | Output image |
|---|---|
Photo of a stylish young woman with short black hair standing confidently in front of a vibrant cartoon-style mural wall. She wears an all-black outfit: a puffed bomber jacket with a ruffled collar, cargo shorts, fishnet tights, and chunky black Doc Martens, with a gold chain dangling from her waist. The background features four colorful comic-style panels: one reads “GRAND STAGE” and includes sneakers and a Gatorade bottle; another displays green Nike sneakers and a slice of pizza; the third reads “HARAJUKU st” with floating shoes; and the fourth shows a blue mouse riding a skateboard with the text “Takeshita WELCOME.” Dominant bright colors include yellow, teal, orange, pink, and green. Speech bubbles, halftone patterns, and playful characters enhance the urban street-art aesthetic. Daylight evenly illuminates the scene, and the ground beneath her feet is white tiled pavement. Full-body portrait, centered composition, slightly tilted stance, direct eye contact with the camera. High detail, sharp focus, dynamic framing. | ![]() |
Ikhtisar model
Model Name | Description | Output image specifications |
|---|---|---|
z-image-turbo | A fast lightweight image generation model | Resolusi gambar: 512×512 hingga 2048×2048 piksel. Lihat resolusi yang direkomendasikan di pengaturan parameter size. Format gambar: png Jumlah gambar: Tetap 1. |
Prasyarat
Buat Kunci API dan tetapkan Kunci API sebagai Variabel lingkungan.
Pemanggilan HTTP sinkron
Singapura:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
Parameter permintaanHeader permintaanContent-Typestring (Wajib)Tipe konten permintaan. Harus berupa application/json.Authorization string (Wajib)Mengautentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Body permintaanmodelstring (Wajib)Nama model: z-image-turbo.input object (Wajib)Konten input.
Properti messages array (Wajib)Array konten permintaan. Hanya satu giliran (single-turn) — kirim satu set role dan content. Multi-turn tidak didukung.
Properti role string (Wajib)Peran pesan: user.contentarray (Wajib)Array konten pesan. Harus berisi satu objek teks.
Properti text string(Wajib)Prompt positif yang menjelaskan konten, gaya, dan komposisi yang diinginkan.Mendukung bahasa Tiongkok dan Inggris. Maksimal 800 karakter (setiap karakter, huruf, angka, atau simbol dihitung sebagai satu). Karakter tambahan akan dipotong.Contoh: Seekor kucing oranye duduk dengan ekspresi bahagia, lincah dan imut, realistis dan akurat.Catatan: Hanya satu objek teks yang didukung. Mengirim nol atau beberapa objek teks akan menghasilkan error.object (Opsional)Parameter generasi gambar.
Properti size string (Opsional)Resolusi gambar output dalam format lebar×tinggi.
Resolusi yang direkomendasikan untuk total 1024*1024 piksel:
Resolusi yang direkomendasikan untuk total 1280*1280 piksel:
Resolusi yang direkomendasikan untuk total 1536*1536 piksel:
bool (Opsional)Aktifkan penulisan ulang prompt cerdas melalui optimasi LLM dan output reasoning.
integer (opsional)Seed angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika diabaikan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda. |
Contoh ini mengembalikan gambar secara langsung untuk respons lebih cepat. Untuk mengaktifkan penulisan ulang cerdas, atur prompt_extend=true — sistem akan mengembalikan prompt yang dioptimalkan, alasan, dan gambar (meningkatkan waktu respons). |
Parameter responsoutputobjectOutput model.
Properti choices arrayKonten output model. Array berisi satu elemen.
Properti finish_reason stringAlasan penyelesaian. Nilai stop menunjukkan keberhasilan.message objectPesan respons model.
Properti role stringPeran pesan. Nilainya adalah assistant.contentarray
Properti image stringURL gambar yang dihasilkan (PNG). Berlaku 24 jam — segera unduh.text stringIni mengembalikan prompt input (prompt_extend=false) atau prompt yang ditulis ulang (prompt_extend=true).stringProses reasoning model. Hanya dikembalikan saat prompt_extend=true.objectIni mencakup statistik penggunaan hanya untuk generasi yang berhasil.
Properti width integerLebar gambar yang dihasilkan (piksel).height integerTinggi gambar yang dihasilkan (piksel).image_count integerJumlah gambar yang dihasilkan: 1.input_tokens integerToken input (0 saat prompt_extend=false).output_tokens integerToken output (0 saat prompt_extend=false).output_tokens_detailsobjectDetail token output (hanya saat prompt_extend=true).
Properti reasoning_tokens integerToken yang digunakan untuk reasoning.integerTotal token (0 saat prompt_extend=false).stringIdentifier unik permintaan untuk pelacakan dan troubleshooting.code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error. |
Data tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dihapus. Segera simpan gambar yang dihasilkan. |
Batasan
- URL gambar berlaku selama 24 jam. Segera unduh.
- Moderasi konten: Baik
promptinput maupun gambar output menjalani moderasi konten. Konten yang tidak sesuai akan mengembalikan errorIPInfringementSuspectatauDataInspectionFailed. Lihat Kode error.
Penagihan dan pembatasan laju
- Untuk harga dan kuota gratis, lihat Harga model.
- Untuk batas laju, lihat Z-Image.
- Penagihan didasarkan pada jumlah gambar yang berhasil dihasilkan dan status prompt_extend. Pemanggilan yang gagal tidak dikenai biaya atau mengonsumsi kuota gratis.
