Z-Image adalah model teks-ke-gambar ringan yang menghasilkan gambar dengan cepat, mendukung rendering teks dalam bahasa Tiongkok dan Inggris, serta menyesuaikan berbagai resolusi dan rasio aspek.
Akses Cepat: Pengalaman Online (Singapura | Beijing) | Blog Teknis
Contoh Gambar
Prompt Input | Gambar Output |
Foto seorang wanita muda bergaya dengan rambut pendek hitam yang berdiri percaya diri di depan dinding mural bergaya kartun yang cerah. Ia mengenakan pakaian serba hitam: jaket bomber bantalan dengan kerah berkerut, celana cargo pendek, stoking jaring ikan, dan sepatu bot hitam tebal Doc Martens, dengan rantai emas menjuntai dari pinggangnya. Latar belakang menampilkan empat panel bergaya komik berwarna-warni: satu bertuliskan “GRAND STAGE” dan berisi sepatu kets serta botol Gatorade; yang lain menampilkan sepatu kets Nike hijau dan sepotong pizza; yang ketiga bertuliskan “HARAJUKU st” dengan sepatu melayang; dan yang keempat menunjukkan seekor tikus biru menaiki skateboard dengan teks “Takeshita WELCOME.” Warna-warna cerah dominan meliputi kuning, teal, oranye, pink, dan hijau. Gelembung ucapan, pola halftone, dan karakter bermain meningkatkan estetika seni jalanan urban. Cahaya siang hari menerangi adegan secara merata, dan lantai di bawah kakinya adalah ubin putih. Potret seluruh tubuh, komposisi terpusat, postur sedikit miring, kontak mata langsung dengan kamera. Detail tinggi, fokus tajam, bingkai dinamis. |
|
Ikhtisar Model
Nama Model | Deskripsi Model | Spesifikasi Gambar Output |
z-image-turbo | Model ringan, menghasilkan gambar dengan cepat | Resolusi gambar: Total piksel antara 512×512 hingga 2048×2048. Untuk resolusi yang direkomendasikan, lihat pengaturan parameter ukuran Format gambar: PNG Jumlah gambar: Tetap 1 |
Sebelum memanggil API, periksa daftar model yang didukung untuk setiap wilayah.
Prasyarat
Dapatkan Kunci API, dan konfigurasikan Kunci API sebagai variabel lingkungan (akan ditinggalkan dan digabung ke Konfigurasi Kunci API).
Panggilan HTTP Sinkron
Wilayah Singapura: POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Wilayah Beijing: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Parameter Permintaan | Teks-ke-GambarContoh ini mengembalikan gambar secara langsung dan memberikan waktu respons cepat. Untuk mengaktifkan penalaran cerdas, atur |
Header Permintaan | |
Content-Type Tipe konten permintaan. Harus berupa | |
Authorization Kredensial otentikasi menggunakan Kunci API Model Studio. Contoh: | |
Body Permintaan | |
model Nama model. Harus berupa z-image-turbo. | |
input Informasi input dasar. | |
parameters Parameter pengeditan gambar. |
Parameter Respons | Eksekusi tugas berhasilData tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dihapus. Segera simpan gambar yang dihasilkan. Eksekusi tugas gagalJika tugas gagal dieksekusi, respons dikembalikan dengan detail kesalahan. Bidang code dan message menunjukkan alasan kegagalan tersebut. Untuk informasi lebih lanjut, lihat Pesan kesalahan. |
output Informasi output tugas. | |
usage Statistik penggunaan output. Hanya hasil yang berhasil yang dihitung. | |
request_id Pengidentifikasi unik untuk permintaan. Gunakan untuk pelacakan dan troubleshooting masalah. | |
code Kode kesalahan. Dikembalikan hanya saat permintaan gagal. Lihat kode kesalahan untuk detailnya. | |
message Pesan kesalahan detail. Dikembalikan hanya saat permintaan gagal. Lihat kode kesalahan untuk detailnya. |
Batasan
URLgambar hanya disimpan selama 24 jam. Unduh segera.Moderasi konten:
Promptinput dan gambar output keduanya dikenai moderasi konten. Permintaan yang berisi konten terlarang menghasilkan kesalahanIPInfringementSuspectatauDataInspectionFailed. Lihat kode kesalahan untuk detailnya.
Penagihan dan Pembatasan Laju
Untuk kuota gratis dan harga satuan model, lihat harga model.
Untuk pembatasan laju model, lihat Z-Image.
Penagihan didasarkan pada jumlah gambar yang berhasil dihasilkan, tergantung apakah penulisan ulang cerdas diaktifkan. Panggilan model yang gagal atau kesalahan pemrosesan tidak dikenai biaya apa pun atau menghabiskan kuota gratis.
Kode Kesalahan
Jika panggilan model gagal dan mengembalikan pesan kesalahan, lihat pesan kesalahan untuk solusinya.
FAQ
T: Bagaimana cara melihat metrik pemanggilan model?
J: Satu jam setelah pemanggilan model selesai, buka halaman Monitoring (Singapura) atau Monitoring (China (Beijing)) untuk melihat metrik seperti jumlah pemanggilan dan tingkat keberhasilan. Untuk informasi lebih lanjut, lihat Kueri tagihan dan manajemen biaya.
T: Bagaimana cara mendapatkan daftar putih nama domain untuk penyimpanan gambar?
J: Gambar yang dihasilkan model disimpan di OSS. API mengembalikan URL publik sementara. Untuk mengonfigurasi daftar putih firewall untuk URL unduhan ini, perhatikan hal berikut: Penyimpanan dasar dapat berubah secara dinamis. Topik ini tidak menyediakan daftar putih nama domain OSS tetap untuk mencegah masalah akses akibat informasi yang kedaluwarsa. Jika Anda memiliki persyaratan kontrol keamanan, hubungi manajer akun Anda untuk mendapatkan daftar nama domain OSS terbaru.
