Tongyi - teks-ke-gambar - Z-Image adalah model ringan yang menghasilkan citra secara cepat, mendukung rendering teks dalam bahasa Tiongkok dan Inggris, serta menyesuaikan berbagai resolusi dan rasio aspek.
Tautan cepat: Blog teknis
Prasyarat
Anda harus telah memperoleh dan mengonfigurasi Kunci API serta menyetel Kunci API sebagai variabel lingkungan (langkah ini sedang ditinggalkan dan akan digabungkan ke dalam konfigurasi Kunci API).
Contoh
Masukkan prompt | Citra output |
Foto seorang perempuan 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 Doc Martens hitam tebal, dengan rantai emas menjuntai dari pinggangnya. Latar belakang menampilkan empat panel bergaya komik berwarna-warni: satu bertuliskan “GRAND STAGE” dan menampilkan sepatu kets serta botol Gatorade; yang lain menampilkan sepatu Nike hijau dan sepotong pizza; yang ketiga bertuliskan “HARAJUKU st” dengan sepatu-sepatu melayang; dan yang keempat menunjukkan seekor tikus biru menaiki skateboard dengan teks “Takeshita WELCOME.” Warna-warna cerah dominan termasuk kuning, teal, oranye, merah muda, dan hijau. Gelembung ucapan, pola halftone, dan karakter lucu memperkuat 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
Model | Deskripsi | Spesifikasi citra output |
z-image-turbo | Model ringan untuk pembuatan citra cepat | Resolusi citra: Total piksel antara 512×512 hingga 2048×2048. Untuk resolusi yang direkomendasikan, lihat parameter size. Format citra: png Jumlah citra: Tetap 1. |
Sebelum melakukan panggilan, periksa daftar model yang didukung di setiap Wilayah.
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 berikut mengembalikan citra secara langsung untuk waktu respons lebih cepat. Untuk mengaktifkan fitur penulisan ulang cerdas, atur Contoh berikut menggunakan URL dasar untuk Wilayah Singapura. Jika Anda menggunakan model dari Wilayah China (Beijing), ganti URL dasar dengan |
Header permintaan | |
Content-Type Tipe konten permintaan. Atur parameter ini ke | |
Authorization Kredensial otentikasi identitas untuk permintaan. API ini menggunakan Kunci API Model Studio untuk otentikasi identitas. Contoh: Bearer sk-xxxx. | |
Body permintaan | |
model Nama model. Contoh: z-image-turbo. | |
input Input untuk model. | |
parameters Parameter untuk pembuatan citra. |
Parameter respons | Eksekusi tugas berhasilData tugas, seperti status tugas dan URL citra, hanya disimpan selama 24 jam dan secara otomatis dihapus setelah periode tersebut. Anda harus segera menyimpan citra yang dihasilkan. Eksekusi tugas gagalJika tugas gagal, sistem mengembalikan informasi kegagalan tersebut. Bidang `code` dan `message` menunjukkan penyebab error. Untuk informasi selengkapnya, lihat Pesan error. |
output Output dari tugas. | |
usage Statistik penggunaan untuk tugas. Hanya tugas yang berhasil yang termasuk dalam statistik ini. | |
request_id ID permintaan unik yang dapat digunakan untuk melacak dan memecahkan masalah. | |
code Kode error untuk permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi selengkapnya, lihat Pesan error. | |
message Informasi detail tentang permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi selengkapnya, lihat Pesan error. |
Batasan
Validitas data:
task_iddanurlcitra hanya disimpan selama 24 jam. Setelah periode tersebut, data tersebut tidak dapat diakses atau diunduh.Moderasi konten:
promptinput dan citra output keduanya dikenai tinjauan moderasi konten. Permintaan yang berisi konten terlarang akan menghasilkan error `IPInfringementSuspect` atau `DataInspectionFailed`. Untuk informasi selengkapnya, lihat Pesan error.Konfigurasi akses jaringan: URL citra disimpan di Object Storage Service. Jika sistem bisnis Anda tidak dapat mengakses URL OSS eksternal karena kebijakan keamanan, Anda harus menambahkan nama domain OSS berikut ke daftar putih.
# Daftar nama domain OSS dashscope-result-bj.oss-cn-beijing.aliyuncs.com dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com dashscope-result-sh.oss-cn-shanghai.aliyuncs.com dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com dashscope-result-zjk.oss-cn-zhangjiakou.aliyuncs.com dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com dashscope-result-hy.oss-cn-heyuan.aliyuncs.com dashscope-result-cd.oss-cn-chengdu.aliyuncs.com dashscope-result-gz.oss-cn-guangzhou.aliyuncs.com dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com
Penagihan dan pembatasan laju
Untuk kuota gratis dan harga satuan model, lihat Harga model.
Untuk batas laju model, lihat Tongyi - teks-ke-gambar - Z-Image.
Detail penagihan:
Penagihan didasarkan pada jumlah citra yang berhasil dihasilkan dan apakah penulisan ulang cerdas diaktifkan. Anda hanya dikenai biaya ketika respons API mengembalikan
task_statusbernilaiSUCCEEDEDdan citra berhasil dihasilkan.Panggilan model yang gagal atau error pemrosesan tidak dikenai biaya apa pun dan tidak mengurangi kuota gratis Anda.
Kode error
Jika panggilan model gagal dan mengembalikan pesan error, lihat Pesan error untuk mengatasi masalah tersebut.
FAQ
T: Bagaimana cara melihat volume panggilan model?
J: Sekitar satu jam setelah panggilan model, Anda dapat membuka halaman Observasi Model (Singapura), atau Observasi Model (Beijing) untuk melihat metrik seperti jumlah panggilan dan tingkat keberhasilan. Untuk informasi selengkapnya, lihat Bagaimana cara melihat catatan panggilan model?
