Topik ini menjawab pertanyaan umum tentang API gambar, termasuk debugging, penagihan, Pembatasan laju, dan kesalahan API yang sering terjadi.
Model gambar yang dibahas dalam topik ini mencakup Wan teks-ke-gambar V2, segmentasi instans orang, dan penghapusan serta penyelesaian gambar.
Debug API secara lokal
API Gambar mendukung panggilan HTTP. Bagian berikut menggunakan API Wan teks-ke-gambar sebagai contoh untuk menunjukkan cara men-debug panggilan API HTTP secara lokal.
Aktifkan layanan model dan dapatkan Kunci API. Kemudian, atur Kunci API sebagai variabel lingkungan.
Temukan perintah
curldi dokumentasi API gambar.
Jika Anda menggunakan macOS atau Linux, jalankan perintah curl di terminal.
Jika Anda menggunakan Windows, gunakan platform API seperti Postman atau Apifox untuk mengirim permintaan HTTP.
Catatan: Saat menggunakan platform API untuk mengirim permintaan, ganti$DASHSCOPE_API_KEYdi perintah curlBearer $DASHSCOPE_API_KEYdengan kunci API Anda yang sebenarnya, misalnya,Bearer sk-xxxxxx.
Penagihan dan Pembatasan Laju
Contoh Penagihan
Catatan: Model Gambar 1 dan Model Gambar 2 dalam tabel hanya merupakan contoh dan bukan nama model nyata.
Model | Kuota gratis (Lihat) | Harga satuan | Batas laju (dibagikan oleh Akun Alibaba Cloud dan Pengguna RAM) | |
Batas QPS untuk pengiriman tugas | Jumlah tugas bersamaan | |||
Model Gambar 1 | 500 gambar | Gratis untuk sementara waktu | 2 | 1 |
Model Gambar 2 | 500 gambar | $0,02/gambar | 2 | 1 |
Kuota gratis
Deskripsi: Kuota gratis didasarkan pada jumlah gambar yang berhasil dihasilkan oleh model. Gambar input atau pemrosesan model yang gagal tidak akan mengonsumsi kuota.
Cara mendapatkan: Kuota gratis diberikan secara otomatis setelah Anda mengaktifkan layanan Alibaba Cloud Model Studio dan berlaku selama 90 hari.
Penggunaan: Akun Alibaba Cloud dan Pengguna RAM-nya berbagi kuota gratis.
Untuk informasi lebih lanjut, lihat Kuota gratis untuk pengguna baru.
Gratis untuk sementara waktu
Jika metode penagihan adalah "Gratis untuk sementara waktu", model tersebut dalam pratinjau publik. Anda tidak dapat menggunakan model setelah kuota gratis habis.
Deskripsi penagihan
Jika harga satuan tertentu disediakan, seperti $0,02/gambar, model tersebut telah dikomersialkan. Anda akan dikenakan biaya untuk menggunakan model setelah kuota gratis Anda habis atau kedaluwarsa.
Item tagihan: Anda hanya dikenakan biaya untuk gambar keluaran yang berhasil dihasilkan. Tidak ada biaya yang dikenakan dalam kasus lainnya.
Metode penagihan: Biaya ditagihkan ke Akun Alibaba Cloud Anda. Pengguna RAM tidak dapat diukur atau ditagih secara independen. Semua penggunaan ditagihkan ke Akun Alibaba Cloud yang memiliki Pengguna RAM. Untuk melihat informasi penagihan Anda, kunjungi halaman Ikhtisar Penagihan di Konsol Manajemen Alibaba Cloud.
Metode isi ulang: Anda dapat menambahkan dana ke akun Anda di halaman Biaya dan Pengeluaran di Konsol Manajemen Alibaba Cloud.
Statistik panggilan model: Untuk melihat volume panggilan model dan jumlahnya, kunjungi halaman Observasi Model (Singapura atau Beijing) di platform Alibaba Cloud Model Studio.
Untuk informasi lebih lanjut tentang penagihan, lihat Item yang Dapat Ditagih.
Pembatasan laju
Deskripsi: Akun Alibaba Cloud dan Pengguna RAM-nya berbagi batas laju.
Kesalahan API
Unduhan gambar gagal
Skenario: Saat menggunakan URL gambar Anda sendiri (bukan URL contoh dari dokumentasi) untuk meminta API, pesan kesalahan "Pengunduhan gambar referensi gagal, silakan periksa url gambar." dikembalikan.
{
"request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
"output": {
"task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
"task_status": "FAILED",
"code": "BadRequest.InputDownloadFailed",
"message": "Pengunduhan gambar referensi gagal, silakan periksa url gambar."
}
}Penyebab Potensial: URL gambar salah, tidak dapat diakses, atau memiliki izin unduhan yang dibatasi. Hal ini mencegah layanan model mengunduh gambar dengan sukses.
Solusi: Pastikan bahwa URL gambar lengkap dan memungkinkan akses jaringan publik. Unggah gambar ke layanan penyimpanan mandiri yang dapat diakses publik atau gunakan layanan penyimpanan cloud seperti OSS. Pastikan bahwa URL gambar memungkinkan akses jaringan publik.
Perintah curl untuk API pembuatan tugas gagal
Skenario: Anda menyalin perintah curl untuk API pembuatan tugas dari dokumentasi dan terjadi kesalahan saat mengeksekusinya. Perintah curl berikut untuk model pembuatan latar belakang gambar digunakan sebagai contoh.
Pesan kesalahan "Badan permintaan yang diperlukan tidak valid, silakan periksa format badan permintaan." dikembalikan.
{
"request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
"code": "InvalidParameter",
"message": "Badan permintaan yang diperlukan tidak valid, silakan periksa format badan permintaan."
}Penyebab Potensial: Badan permintaan API pembuatan tugas berisi karakter Cina. Jika klien yang mengeksekusi perintah curl tidak mendukung penguraian karakter Cina, badan permintaan mungkin tidak diuraikan dengan benar, sehingga menyebabkan kesalahan.
Solusi: Jika Anda menggunakan macOS atau Linux, jalankan perintah curl langsung di terminal. Jika Anda menggunakan Windows, gunakan platform API HTTP seperti Postman atau Apifox untuk mengirim permintaan.
Timeout unduhan sumber daya saat memanggil API dari luar Tiongkok
Skenario: Saat memanggil API dari luar Tiongkok dan sumber daya gambar disimpan di wilayah luar daratan Tiongkok, kemungkinan besar akan terjadi kesalahan timeout unduhan sumber daya. Pesan kesalahan adalah sebagai berikut:
Timeout mengunduh sumber daya media selama proses pemeriksaan dataPenyebab Utama: Ketidakstabilan jaringan antara wilayah luar daratan Tiongkok dan titik akhir layanan dapat menyebabkan timeout ketika layanan mencoba mengunduh gambar.
Solusi: Simpan sumber daya gambar di wilayah dalam daratan Tiongkok dan konfigurasikan percepatan. Perhatikan bahwa Anda tidak dapat mengonfigurasi periode timeout unduhan gambar untuk Akun Alibaba Cloud.
Pertanyaan lainnya
Konfigurasikan daftar putih domain untuk mengakses tautan OSS gambar
Gambar yang dihasilkan oleh model disimpan di Alibaba Cloud OSS. Setiap gambar memiliki tautan OSS, seperti https://dashscope-result-xx.oss-cn-xxxx.aliyuncs.com/xxx.png, yang dapat diakses secara publik. Anda dapat menggunakan tautan ini untuk melihat atau mengunduh gambar.
Jika bisnis Anda memiliki persyaratan keamanan tinggi dan jaringan internal tidak dapat mengakses tautan OSS Alibaba Cloud, konfigurasikan daftar putih untuk akses jaringan eksternal. Tambahkan nama domain berikut ke daftar putih agar Anda tetap dapat mengakses tautan gambar.
# Daftar nama domain OSS gambar
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