全部产品
Search
文档中心

Alibaba Cloud Model Studio:FAQ

更新时间:Nov 07, 2025

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.

  1. Aktifkan layanan model dan dapatkan Kunci API. Kemudian, atur Kunci API sebagai variabel lingkungan.

  2. Temukan perintah curl di dokumentasi API gambar.

Contoh: perintah curl untuk teks-ke-gambar

curl -X POST https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-t2i-turbo",
    "input": {
        "prompt": "Toko bunga dengan jendela indah, pintu kayu cantik, dan bunga-bunga dipajang"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'    
  1. Jika Anda menggunakan macOS atau Linux, jalankan perintah curl di terminal.

  2. 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_KEY di perintah curl Bearer $DASHSCOPE_API_KEY dengan 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.

Contoh: Perintah curl untuk API Pembuatan Tugas Pembuatan Latar Belakang Gambar

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/background-generation/generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "wanx-background-generation-v2",
    "input": {
        "base_image_url": "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/main_images/new_main_img/a.png",
        "ref_image_url": "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_images/c5e50d27be534709817b2ab080b0162f_0.jpg",
        "ref_prompt": "gunung dan awan matahari terbenam",
        "reference_edge": {
            "foreground_edge": [
                "https://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/huaban_soft_edge/6cdd13941cef1b11d885aea1717b983ae566b8efc9094-vcsvxa_fw658webp.png",
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/2c36cc4b7da027279e87311dac48fc2d5d784b1e72c0e-x4f1wC_fw658webp.png"
            ],
            "background_edge": [
                "http://vision-poster.oss-cn-shanghai.aliyuncs.com/lllcho.lc/data/test_data/images/ref_edge/0718a9741e07c52ca5506e75c4f2b99e22fff68a4c7d3-P9WGLr_fw658webp.png"
            ],
            "foreground_edge_prompt": [
                "bunga persik merah muda",
                "anak anjing lucu"
            ],
            "background_edge_prompt": [
                "daun"
            ]
        }
    },
    "parameters": {
        "n": 4,
        "ref_prompt_weight": 0.5,
        "model_version": "v3"
    }
}'

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 data

Penyebab 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