Alibaba Cloud Model Studio:FAQ

Pertanyaan umum mengenai API gambar di Alibaba Cloud Model Studio, mencakup debugging, penagihan, batas laju, dan error API.

Debugging

Bagaimana cara melakukan debugging panggilan API gambar secara lokal?

API gambar menggunakan protokol HTTP standar. Contoh berikut menggunakan API teks-ke-gambar Wan dengan curl.

1. Aktifkan layanan model dan dapatkan Kunci API, lalu tetapkan sebagai variabel lingkungan.
2. Temukan perintah curl dalam dokumentasi API. Misalnya:

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. Pada macOS atau Linux, jalankan perintah tersebut langsung di terminal.
2. Pada Windows, gunakan platform API seperti Postman atau Apifox untuk mengirim permintaan HTTP.

Catatan: Saat menggunakan platform API, ganti $DASHSCOPE_API_KEY pada header Authorization dengan Kunci API aktual Anda, misalnya, Bearer sk-xxxxxx.

Penagihan dan batas laju

Bagaimana mekanisme penagihan untuk model gambar?

Setiap model gambar memiliki kuota gratis dan mungkin dikenai biaya per gambar:

Kuota gratis dan batas laju dibagi bersama oleh Akun Alibaba Cloud dan semua Pengguna RAM.

Apa arti "gratis untuk waktu terbatas"?

Model tersebut sedang dalam masa pratinjau publik. Setelah kuota gratis habis, model tidak lagi tersedia.

Apa yang dihitung sebagai gambar yang dikenai biaya?

Hanya gambar yang berhasil dihasilkan yang dikenai biaya. Gambar input dan permintaan yang gagal tidak mengurangi kuota atau menimbulkan biaya.

Bagaimana cara mendapatkan kuota gratis?

Kuota gratis diberikan secara otomatis saat Anda mengaktifkan Model Studio. Kuota berlaku selama 90 hari dan dibagi bersama oleh akun serta semua Pengguna RAM.

Untuk detail selengkapnya, lihat Kuota gratis untuk pengguna baru.

Kapan biaya berbayar mulai diberlakukan?

Model dengan harga satuan tertentu (misalnya, $0,02/gambar) telah dikomersialkan. Biaya mulai dikenakan setelah kuota gratis habis atau kedaluwarsa.

Biaya ditagihkan ke Akun Alibaba Cloud — seluruh penggunaan digabungkan ke akun induk.

• Lihat tagihan: Buka halaman Ikhtisar Penagihan di Konsol Manajemen Alibaba Cloud.
• Tambahkan dana: Buka halaman Biaya dan Pengeluaran.
• Monitor penggunaan: Periksa halaman Monitoring di platform Model Studio (Singapura | Beijing).

Untuk detail penagihan lengkap, lihat Item yang dikenai biaya.

Error API

Error API gambar umum dan solusinya:

BadRequest.InputDownloadFailed: "Reference image download failed"

{
    "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."
    }
}

Penyebab: URL gambar salah, tidak dapat dijangkau, atau diakses dengan pembatasan. Layanan mengunduh gambar dari URL tersebut selama pemrosesan.

Solusi: Pastikan URL lengkap dan dapat diakses publik. Jika gambar memerlukan otentikasi, unggah ke layanan penyimpanan publik seperti OSS dan gunakan URL baru tersebut.

InvalidParameter: "url error"

{
    "code": "InvalidParameter",
    "message": "url error, please check url！"
}

Penyebab: Parameter model tidak sesuai dengan titik akhir yang dipanggil. Titik akhir sintesis gambar (/api/v1/services/aigc/text2image/image-synthesis) hanya menerima nama model generasi gambar. Nama model generasi teks seperti qwen-turbo akan ditolak dengan pesan url error, meskipun URL permintaan benar. Dalam mode kompatibel OpenAI, nama model generasi teks menghasilkan respons kosong.

Solusi: Atur model ke nama model generasi gambar seperti wanx2.1-t2i-turbo dan panggil titik akhir tersebut secara asinkron.

curl -X POST https://{WorkspaceId}.cn-beijing.maas.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 cute cat"
    },
    "parameters": {
        "size": "1024*1024",
        "n": 1
    }
}'

Generasi gambar bersifat asinkron. Panggilan pembuatan task mengembalikan task_id. Lakukan polling GET /api/v1/tasks/{task_id} hingga task_status berubah menjadi SUCCEEDED untuk mendapatkan URL gambar yang dihasilkan.

InvalidParameter: "Required body invalid"

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

Penyebab: Badan permintaan curl berisi karakter Tionghoa yang tidak dapat diurai oleh klien.

Solusi: Pada macOS atau Linux, jalankan curl langsung di terminal (secara native mendukung UTF-8). Pada Windows, gunakan platform API seperti Postman atau Apifox.

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"
    }
}'

Timeout unduhan resource dari luar Tiongkok daratan

Download the media resource timed out during the data inspection process

Penyebab: Ketidakstabilan jaringan antara wilayah luar Tiongkok daratan dan titik akhir layanan DashScope menyebabkan timeout saat mengunduh.

Solusi: Simpan resource gambar di dalam Tiongkok daratan dan konfigurasikan akselerasi. Periode timeout tidak dapat dikonfigurasi.