All Products
Search
Document Center

Alibaba Cloud Model Studio:FAQ

Last Updated:Mar 01, 2026

Topik ini menjawab pertanyaan yang sering diajukan mengenai API gambar, termasuk debugging, penagihan, pembatasan laju, dan error API umum.

Model gambar yang dibahas dalam topik ini mencakup Wan text-to-image V2, segmentasi instans orang, dan pelengkapan penghapusan gambar.

Debug API secara lokal

API gambar mendukung panggilan HTTP. Bagian berikut menggunakan API Wan text-to-image sebagai contoh untuk menunjukkan cara melakukan debug panggilan API HTTP secara lokal.

  1. Aktifkan layanan model dan peroleh Kunci API. Kemudian, tetapkan Kunci API sebagai variabel lingkungan.

  2. Temukan perintah curl dalam 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": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
    },
    "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 dalam header Bearer $DASHSCOPE_API_KEY dengan Kunci API aktual Anda, misalnya, Bearer sk-xxxxxx.

Penagihan dan pembatasan laju

Contoh penagihan

Catatan: Model Gambar 1 dan Model Gambar 2 dalam tabel hanya bersifat contoh dan bukan nama model yang sebenarnya.

Model

Kuota gratis (Lihat)

Harga satuan

Batas laju (dibagi bersama oleh Akun Alibaba Cloud dan Pengguna RAM)

Batas QPS untuk pengiriman tugas

Jumlah tugas konkuren

Model Gambar 1

500 gambar

Gratis untuk waktu terbatas

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 mengurangi kuota.

  • Cara memperoleh: 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 tersebut.

  • Untuk informasi lebih lanjut, lihat Kuota gratis untuk pengguna baru.

Gratis untuk waktu terbatas

  • Jika metode penagihan adalah "Gratis untuk waktu terbatas", model tersebut sedang dalam pratinjau publik. Anda tidak dapat menggunakan model tersebut setelah kuota gratis habis.

Deskripsi penagihan

  • Jika harga satuan tertentu diberikan, seperti $0,02/gambar, model tersebut telah dikomersialkan. Anda akan dikenai biaya untuk penggunaan model setelah kuota gratis Anda habis atau kedaluwarsa.

  • Item yang dikenai biaya: Anda hanya dikenai biaya untuk gambar output yang berhasil dihasilkan. Tidak ada biaya yang dikenakan dalam kasus lain.

  • Metode penagihan: Biaya dibebankan ke Akun Alibaba Cloud Anda. Pengguna RAM tidak dapat diukur atau ditagih secara terpisah. Seluruh penggunaan dikenakan ke Akun Alibaba Cloud yang memiliki Pengguna RAM tersebut. Untuk melihat informasi penagihan Anda, buka 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 pemanggilan model: Untuk melihat volume dan jumlah pemanggilan model, buka halaman Pemantauan (Singapura atau Beijing) di platform Alibaba Cloud Model Studio.

  • Untuk informasi lebih lanjut tentang penagihan, lihat Item yang dikenai biaya.

Pembatasan laju

  • Deskripsi: Akun Alibaba Cloud dan Pengguna RAM-nya berbagi batas laju.

Error API

Gagal mengunduh gambar

Skenario: Saat Anda menggunakan URL gambar Anda sendiri (bukan URL contoh dari dokumentasi) untuk meminta API, pesan error "Reference image download failed, please check image url." dikembalikan.

{
    "request_id": "657f0d1b-76d0-9e3e-b6d6-xxxxxx",
    "output": {
        "task_id": "5e6fa974-9a25-4271-8659-xxxxxx",
        "task_status": "FAILED",
        "code": "BadRequest.InputDownloadFailed",
        "message": "Reference image download failed, please check image url."
    }
}

Kemungkinan penyebab: URL gambar input salah, tidak dapat diakses, atau memiliki izin unduhan yang dibatasi, sehingga mencegah layanan model mengunduh gambar tersebut.

Solusi: Pastikan URL gambar lengkap dan mengizinkan akses jaringan publik. Anda dapat mengunggah gambar ke layanan penyimpanan yang dikelola sendiri yang dapat diakses publik atau ke layanan penyimpanan cloud seperti OSS, serta memastikan URL tersebut mengizinkan akses jaringan publik.

Perintah curl untuk API pembuatan tugas gagal

Skenario: Anda menyalin perintah curl untuk API pembuatan tugas dari dokumentasi dan terjadi error saat menjalankannya. 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": "mountains and sunset clouds",
        "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": [
                "pink peach blossoms",
                "cute puppy"
            ],
            "background_edge_prompt": [
                "leaves"
            ]
        }
    },
    "parameters": {
        "n": 4,
        "ref_prompt_weight": 0.5,
        "model_version": "v3"
    }
}'

Pesan error "Required body invalid, please check the request body format." dikembalikan.

{
    "request_id": "d306ae65-3f6d-9d6c-acfb-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}

Kemungkinan penyebab: Badan permintaan API pembuatan tugas berisi karakter Cina. Jika klien yang menjalankan perintah curl tidak mendukung penguraian karakter Cina, badan permintaan mungkin tidak diurai dengan benar, sehingga menyebabkan error tersebut.

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 pengunduhan resource saat memanggil API dari luar Tiongkok

Skenario: Saat Anda memanggil API dari luar Tiongkok dan resource gambar disimpan di wilayah luar Tiongkok daratan, kemungkinan besar terjadi error timeout pengunduhan resource. Pesan error-nya sebagai berikut:

Download the media resource timed out during the data inspection process

Penyebab utama: Ketidakstabilan jaringan antara wilayah luar Tiongkok daratan dan titik akhir layanan dapat menyebabkan timeout saat layanan mencoba mengunduh gambar.

Solusi: Simpan resource gambar di wilayah dalam Tiongkok daratan dan konfigurasikan akselerasi. Perlu diperhatikan bahwa Anda tidak dapat mengonfigurasi periode timeout pengunduhan gambar untuk Akun Alibaba Cloud.