Skip to main content
Wan

Wan2.6 - pembuatan dan pengeditan gambar

Wan2.6 mendukung input multi-gambar, pengeditan gambar, dan keluaran teks-gambar interleaved.

Ikhtisar model

Model

Deskripsi

Spesifikasi gambar output

wan2.6-image

Mengedit gambar dan menghasilkan output teks-gambar interleaved.

Format gambar: PNG

Resolusi dan dimensi gambar dikonfigurasi melalui parameter size.

Sebelum memanggil API, periksa daftar model dan harga yang didukung di setiap wilayah.

Prasyarat

Dapatkan Kunci API dan ekspor Kunci API sebagai Variabel lingkungan.
Wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) memiliki Kunci API dan titik akhir permintaan yang terpisah serta tidak dapat saling dipertukarkan. Pemanggilan lintas-wilayah akan menyebabkan kegagalan autentikasi atau error layanan. Untuk informasi selengkapnya, lihat Pilih wilayah dan cakupan penerapan layanan.

HTTP sinkron

Mengembalikan hasil dalam satu permintaan. Direkomendasikan untuk sebagian besar skenario.
  • Singapura
  • AS (Virginia)
  • China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationSaat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.

Parameter permintaan

  • Pengeditan gambar
  • Output teks-gambar interleaved (streaming saja)
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --data '{
        "model": "wan2.6-image",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "text": "Generate a tomato and egg stir-fry based on the style of image 1 and the background of image 2"
                        },
                        {
                            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                        },
                        {
                            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                        }
                    ]
                }
            ]
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": false,
            "n": 1,
            "enable_interleave": false,
            "size": "1K"
        }
    }'
Request headers
Content-Type string (Wajib)Tipe konten permintaan. Harus berupa application/json.
Authorization string (Wajib)Mengautentikasi permintaan dengan kunci API Model Studio. Contoh: Bearer sk-xxxx.
X-DashScope-SSE string (Opsional)Mengaktifkan keluaran streaming.
  • Ketika parameters.enable_interleave=true, atur ke enable.
  • Dalam kasus lain, abaikan header ini.
Request body
model string (Wajib)Nama model. Tetapkan ke wan2.6-image.
input object (Wajib)Konfigurasi input.

Properties

messages array (Wajib)Array konten permintaan. Hanya percakapan satu giliran yang didukung — berikan satu pasangan role-content.

Properties

role string (Wajib)Peran pesan. Tetapkan ke user.content array (Wajib)Array konten pesan.

Properties

text string (Wajib)Prompt positif yang menjelaskan konten, gaya, dan komposisi gambar yang diinginkan.Mendukung bahasa Tiongkok dan Inggris. Maksimal 2.000 karakter (setiap karakter Tiongkok, huruf, angka, atau simbol dihitung sebagai satu). Akan dipotong otomatis jika melebihi batas.Contoh: Hasilkan tumis tomat dan telur berdasarkan gaya gambar ini.Catatan: Array content harus berisi tepat satu objek dengan bidang text.image string (Opsional)URL atau string gambar yang dikodekan dalam Base64.Batasan gambar:
  • Format gambar: JPEG, JPG, PNG (saluran alfa tidak didukung), BMP, WebP.
  • Resolusi gambar: Lebar dan tinggi masing-masing harus antara 240 hingga 8.000 piksel.
  • Ukuran file: Tidak boleh melebihi 10 MB.
Batas jumlah gambar:
  • Jumlah gambar input bergantung pada parameter parameters.enable_interleave.
    • Saat enable_interleave=true (output teks-gambar berselang-seling), Anda dapat memasukkan 0 hingga 1 gambar.
    • Saat enable_interleave=false (pengeditan gambar), Anda harus memasukkan 1 hingga 4 gambar.
  • Jika Anda memasukkan beberapa gambar, sertakan beberapa objek image dalam array content, dengan urutan gambar ditentukan oleh urutan elemen dalam array.
Format input yang didukung:
  1. Gunakan URL yang dapat diakses publik
    • Mendukung protokol HTTP atau HTTPS.
    • Contoh: http://wanx.alicdn.com/material/xxx.jpeg.
  2. Berikan string gambar yang dikodekan dalam Base64
    • Format: data:{MIME_type};base64,{base64_data}
    • Contoh: data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (hanya ilustrasi; berikan string lengkap saat penggunaan sebenarnya)
    • Untuk panduan pengkodean Base64, lihat Metode input gambar.
parameters object (Opsional)Parameter generasi.

Properties

negative_prompt string (Opsional)Prompt negatif yang menggambarkan hal yang tidak Anda inginkan dalam gambar.Mendukung bahasa Tiongkok dan Inggris. Panjang maksimum 500 karakter. Karakter berlebih akan dipotong secara otomatis.Contoh: Resolusi rendah, kualitas rendah, anggota tubuh terdistorsi, jari cacat, warna terlalu jenuh, tampilan seperti lilin, tidak ada detail wajah, permukaan terlalu halus, tampilan hasil AI. Komposisi kacau. Teks buram atau terdistorsi.size string (Opsional)Resolusi gambar output. Mendukung dua metode: merujuk pada proporsi gambar input atau langsung menentukan dimensi.Saat enable_interleave=false (mode pengeditan gambar):
  • Metode 1: Merujuk pada proporsi gambar input (direkomendasikan) Opsi resolusi output yang tersedia: 1K (default), 2K.
    • 1K: Total piksel output mendekati 1.280×1.280, mempertahankan rasio aspek gambar input terakhir.
    • 2K: Total piksel output mendekati 2.048×2.048, mempertahankan rasio aspek gambar input terakhir.
  • Metode 2: Menentukan lebar dan tinggi gambar output dalam piksel Total piksel harus berada dalam rentang [768×768, 2.048×2.048], dengan rasio aspek antara [1:4, 4:1].
    Nilai piksel output aktual merupakan kelipatan 16 yang paling mendekati nilai yang ditentukan.
Saat enable_interleave=true (mode output teks-gambar interleaved):
  • Metode 1: Merujuk pada proporsi gambar input (metode default)
    • Jika total piksel gambar input ≤ 1.280×1.280, output akan sesuai dengan total piksel dan rasio aspek input.
    • Jika total piksel gambar input > 1.280×1.280, total piksel output mendekati 1.280×1.280, mempertahankan rasio aspek input.
    • Jika tidak ada gambar input yang diberikan, ukuran output adalah 1.280×1.280.
  • Metode 2: Menentukan lebar dan tinggi gambar output dalam piksel Total piksel harus berada dalam rentang [768×768, 1.280×1.280], dengan rasio aspek antara [1:4, 4:1].
    Nilai piksel output aktual merupakan kelipatan 16 yang paling mendekati nilai yang ditentukan.

Resolusi yang direkomendasikan untuk rasio aspek umum

  • 1:1: 1.280×1.280
  • 2:3: 800×1.200
  • 3:2: 1.200×800
  • 3:4: 960×1280
  • 4:3: 1.280×960
  • 9:16: 720×1280
  • 16:9: 1.280×720
  • 21:9: 1.344×576
enable_interleave bool (Opsional)Mengontrol mode generasi gambar:
  • false (default): Menunjukkan mode pengeditan gambar (mendukung input multi-gambar dan generasi konsistensi subjek).
    • Kasus penggunaan: Mengedit, menerapkan style transfer, atau menghasilkan gambar konsisten subjek berdasarkan 1 hingga 4 gambar input.
    • Input: Harus menyediakan setidaknya satu gambar referensi.
    • Output: Dapat menghasilkan 1 hingga 4 gambar hasil.
  • true: Mengaktifkan mode output teks-gambar interleaved (mendukung input satu gambar atau tanpa gambar).
    • Kasus penggunaan: Menghasilkan konten gabungan teks dan gambar berdasarkan deskripsi teks, atau melakukan generasi teks-ke-gambar murni.
    • Input: Dapat tidak memberikan gambar (teks-ke-gambar) atau hingga satu gambar referensi.
    • Output: Menghasilkan konten campuran yang berisi teks dan gambar.
n integer (Opsional)
Parameter ini memengaruhi biaya (dikenakan per gambar yang berhasil dihasilkan — lihat pricing).
Jumlah gambar yang akan dihasilkan. Perilaku bergantung pada enable_interleave:
  • Saat enable_interleave=false (mode pengeditan gambar):
    • Secara langsung mengontrol jumlah gambar yang dihasilkan.
    • Rentang: 1 hingga 4. Nilai default adalah 4.
    • Saat pengujian, atur nilai ini ke 1 untuk validasi berbiaya rendah.
  • Saat enable_interleave=true (mode teks-gambar interleaved):
    • Default bernilai 1 dan harus tetap 1. Nilai lain akan menyebabkan error.
    • Gunakan max_images untuk mengontrol jumlah gambar dalam mode ini.
max_images integer (Opsional)
Parameter ini memengaruhi biaya (dikenakan per gambar yang berhasil dihasilkan — lihat pricing).
Hanya berlaku dalam mode teks-gambar interleaved (enable_interleave=true).
  • Jumlah maksimum gambar yang dihasilkan model dalam satu respons.
  • Rentang: 1 hingga 5. Nilai default adalah 5.
  • Menetapkan batas atas. Model dapat menghasilkan lebih sedikit gambar daripada yang diminta.
prompt_extend bool (Opsional)Hanya berlaku dalam mode pengeditan gambar (enable_interleave = false).Mengaktifkan penulisan ulang prompt cerdas. Hanya mengoptimalkan prompt positif; prompt negatif tetap tidak berubah.
  • true (default)
  • false
stream bool (Opsional)Mengaktifkan keluaran streaming. Wajib (atur ke true) saat enable_interleave=true.
  • false (default)
  • true
watermark bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
  • false (default)
  • true
seed integer (Opsional)Seed angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output yang serupa. Jika dihilangkan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya dapat bervariasi.

Parameter respons

  • Eksekusi tugas berhasil
  • Eksekusi tugas berhasil (keluaran streaming)
  • Kegagalan eksekusi tugas
Data tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dipurge. Segera simpan gambar yang dihasilkan.
{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ],
                    "role": "assistant"
                }
            }
        ],
        "finished": true
    },
    "usage": {
        "image_count": 1,
        "input_tokens": 0,
        "output_tokens": 0,
        "size": "1376*768",
        "total_tokens": 0
    },
    "request_id": "a3f4befe-cacd-49c9-8298-xxxxxx"
}
output objectOutput tugas.

Properties

choices array of objectKonten output yang dihasilkan model.

Properties

finish_reason stringAlasan penghentian tugas.Skema keluaran non-streaming: Berhenti secara alami dengan stop.Skema keluaran streaming: Parameter ini menunjukkan apakah aliran data telah selesai ditransmisikan.
  • Selama transmisi: Paket data sebelumnya terus-menerus mengembalikan "finish_reason": "null", yang menandakan konten masih dalam proses pembuatan. Lanjutkan penerimaan.
  • Pada akhir transmisi: Hanya struktur JSON terakhir yang mengembalikan "finish_reason":"stop", yang menandakan permintaan streaming telah sepenuhnya selesai. Hentikan penerimaan.
message objectPesan yang dikembalikan oleh model.

Properties

role stringPeran pesan, tetap sebagai assistant.content array

Properties

type stringJenis output. Nilai enumerasi: text, image.text stringTeks yang dihasilkan.image stringURL gambar yang dihasilkan dalam format PNG.Tautan kedaluwarsa setelah 24 jam. Segera unduh dan simpan gambarnya.
finished boolFlag penyelesaian permintaan.
  • true
  • false
usage objectStatistik output. Hanya menghitung hasil yang berhasil.

Properties

image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376*768.input_tokens integerDitagih berdasarkan jumlah gambar.
  • Pada mode Pengeditan gambar, tetap 0.
  • Pada mode teks-gambar interleaved, bidang ini menghitung token teks input (tidak ditagih).
output_tokens integerDitagih berdasarkan jumlah gambar.
  • Pada mode Pengeditan gambar, tetap 0.
  • Pada mode teks-gambar interleaved, bidang ini menghitung token teks output (tidak ditagih).
total_tokens integerDitagih berdasarkan jumlah gambar.
  • Pada mode Pengeditan gambar, tetap 0.
  • Pada mode teks-gambar interleaved, bidang ini menghitung total token (tidak ditagih).
request_id stringIdentifier unik permintaan untuk pelacakan dan troubleshooting.
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.

HTTP asinkron

Proses: Buat tugas → Poll hasil

Langkah 1: Buat tugas dan dapatkan ID tugas

  • Singapura
  • AS (Virginia)
  • China (Beijing)
  • Jerman (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationSaat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
  • Setelah tugas dibuat, gunakan task_id yang dikembalikan untuk menanyakan hasilnya. task_id berlaku selama 24 jam. Jangan membuat tugas duplikat. Sebagai gantinya, gunakan polling untuk mengambil hasilnya.
  • Untuk panduan pemula, lihat Panggil API dengan Postman atau cURL.

Parameter permintaan

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
    --header 'Content-Type: application/json' \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header 'X-DashScope-Async: enable' \
    --data '{
        "model": "wan2.6-image",
        "input": {
            "messages": [
                {
                    "role": "user",
                    "content": [
                        {
                            "text": "Generate a tomato and egg stir-fry based on the style of image 1 and the background of image 2"
                        },
                        {
                            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
                        },
                        {
                            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
                        }
                    ]
                }
            ]
        },
        "parameters": {
            "prompt_extend": true,
            "watermark": false,
            "n": 1,
            "enable_interleave": false,
            "size": "1K"
        }
    }'
Header permintaan
Content-Type string (Wajib)Tipe konten permintaan. Harus application/json.
Authorization string (Wajib)Mengautentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.
X-DashScope-Asyncstring(Wajib)Sakelar mode asinkron. Harus ditetapkan ke enable.
Mengabaikan header ini mengembalikan error: “current user api does not support synchronous calls”.
Body permintaan
model string (Wajib)Nama model.Contoh: wan2.6-image
input object (Wajib)Konfigurasi input.

Properti

messages array (Wajib)Array konten permintaan. Hanya percakapan satu putaran yang didukung — berikan satu pasangan role-content. Percakapan multi-putaran tidak didukung.

Properti

rolestring (Wajib)Peran pesan. Tetapkan ke user.contentarray (Wajib)Array konten pesan.

Properti

textstring(Wajib)Prompt positif yang menjelaskan konten, gaya, dan komposisi gambar yang diinginkan.Mendukung bahasa Mandarin dan Inggris. Maksimal 2.000 karakter (setiap karakter Mandarin, huruf, angka, atau simbol dihitung sebagai satu). Dipotong otomatis jika melebihi batas.Contoh: Generate a tomato and egg stir-fry based on this image style.Catatan: Array content harus berisi tepat satu objek dengan bidang text.imagestring(Opsional)URL atau string Base64 dari gambar input.Batasan gambar:
  • Format gambar: JPEG, JPG, PNG (saluran alfa tidak didukung), BMP, WebP.
  • Resolusi gambar: Lebar dan tinggi masing-masing harus antara 240 hingga 8.000 piksel.
  • Ukuran file: Tidak boleh melebihi 10 MB.
Batas jumlah gambar:
  • Jumlah gambar input bergantung pada parameter parameters.enable_interleave.
    • Saat enable_interleave=true (output teks-gambar interleaved), Anda dapat menginput 0 hingga 1 gambar.
    • Saat enable_interleave=false (pengeditan gambar), Anda harus menginput 1 hingga 4 gambar.
  • Saat Anda menginput beberapa gambar, sertakan beberapa objek image dalam array content, menentukan urutan gambar berdasarkan urutan array.
Format input yang didukung:
  1. Gunakan URL yang dapat diakses publik
    • Mendukung protokol HTTP atau HTTPS.
    • Contoh: http://wanx.alicdn.com/material/xxx.jpeg.
  2. Berikan string gambar Base64
    • Format: data:{MIME_type};base64,{base64_data}
    • Contoh: data:image/jpeg;base64,GDU7MtCZzEbTbmRZ... (hanya ilustrasi; berikan string lengkap dalam praktiknya)
    • Untuk panduan pengkodean Base64, lihat Metode input gambar.
parameters object (Opsional)Parameter generasi.

Properti

negative_prompt string (opsional)Prompt negatif yang menjelaskan apa yang tidak Anda inginkan dalam gambar.Mendukung bahasa Mandarin dan Inggris. Panjang maksimum 500 karakter. Karakter berlebih dipotong otomatis.Contoh: Resolusi rendah, kualitas rendah, anggota tubuh terdistorsi, jari cacat, warna terlalu jenuh, penampilan seperti lilin, tanpa detail wajah, permukaan terlalu halus, tampilan hasil AI. Komposisi kacau. Teks buram atau terdistorsi.size string (Opsional)Resolusi gambar output. Mendukung dua metode: merujuk proporsi gambar input atau langsung menentukan dimensi.Saat enable_interleave=false (mode pengeditan gambar):
  • Metode 1: Merujuk proporsi gambar input (direkomendasikan) Opsi resolusi output yang tersedia: 1K (default), 2K.
    • 1K: Total piksel output mendekati 1280*1280, mempertahankan rasio aspek gambar input terakhir.
    • 2K: Total piksel output mendekati 2048*2048, mempertahankan rasio aspek gambar input terakhir.
  • Metode 2: Tentukan lebar dan tinggi gambar output dalam piksel Total piksel harus berada di antara [768768, 20482048], dengan rentang rasio aspek [1:4, 4:1].
    Nilai piksel output aktual adalah kelipatan 16 terdekat dari nilai yang ditentukan.
Saat enable_interleave=true (mode output teks-gambar interleaved):
  • Metode 1: Merujuk proporsi gambar input (metode default)
    • Jika total piksel gambar input ≤ 1280*1280, output sesuai dengan total piksel dan rasio aspek input.
    • Jika total piksel gambar input > 12801280, total piksel output mendekati 12801280, mempertahankan rasio aspek input.
    • Jika tidak ada gambar input yang diberikan, ukuran output adalah 1280*1280.
  • Metode 2: Tentukan lebar dan tinggi gambar output dalam piksel Total piksel harus berada di antara [768768, 12801280], dengan rentang rasio aspek [1:4, 4:1].
    Nilai piksel output aktual adalah kelipatan 16 terdekat dari nilai yang ditentukan.

Resolusi yang direkomendasikan untuk rasio aspek umum

  • 1:1: 1280*1280
  • 2:3: 800*1200
  • 3:2: 1200*800
  • 3:4: 960*1280
  • 4:3: 1280*960
  • 9:16: 720*1280
  • 16:9: 1280*720
  • 21:9: 1344*576
enable_interleave bool (Opsional)Mengontrol mode generasi gambar:
  • false (default): Menunjukkan mode pengeditan gambar (mendukung input multi-gambar dan generasi konsistensi subjek).
    • Kasus penggunaan: Edit, terapkan transfer gaya, atau hasilkan gambar konsisten subjek berdasarkan 1 hingga 4 gambar input.
    • Input: Harus menyediakan setidaknya satu gambar referensi.
    • Output: Dapat menghasilkan 1 hingga 4 gambar hasil.
  • true: Mengaktifkan mode output teks-gambar interleaved (mendukung input satu gambar atau tanpa gambar).
    • Kasus penggunaan: Hasilkan konten yang menggabungkan teks dan gambar berdasarkan deskripsi teks, atau lakukan generasi teks-ke-gambar murni.
    • Input: Dapat memberikan tanpa gambar (teks-ke-gambar) atau hingga satu gambar referensi.
    • Output: Menghasilkan konten campuran yang berisi teks dan gambar.
n integer (Opsional)
Parameter ini memengaruhi biaya (ditagih per gambar berhasil — lihat harga).
Jumlah gambar yang akan dihasilkan. Perilaku bergantung pada enable_interleave:
  • Saat enable_interleave=false (mode pengeditan gambar):
    • Secara langsung mengontrol jumlah gambar yang dihasilkan.
    • Rentang: 1 hingga 4. Nilai default adalah 4.
    • Saat pengujian, tetapkan nilai ini ke 1 untuk validasi berbiaya rendah.
  • Saat enable_interleave=true (mode teks-gambar interleaved):
    • Default ke 1 dan harus tetap 1. Nilai lain menyebabkan error.
    • Gunakan max_images untuk mengontrol jumlah gambar dalam mode ini.
max_images integer (Opsional)
Parameter ini memengaruhi biaya (ditagih per gambar berhasil — lihat harga).
Hanya efektif dalam mode teks-gambar interleaved (enable_interleave=true).
  • Jumlah maksimum gambar yang dihasilkan model dalam satu respons.
  • Rentang: 1 hingga 5. Nilai default adalah 5.
  • Menetapkan batas atas. Model mungkin menghasilkan lebih sedikit gambar daripada yang diminta.
prompt_extend bool (Opsional)Hanya efektif dalam mode pengeditan gambar (enable_interleave = false).Mengaktifkan penulisan ulang prompt cerdas. Hanya mengoptimalkan prompt positif; prompt negatif tetap tidak berubah.
  • true (default)
  • false
watermark bool (Opsional)Menambahkan label watermark di pojok kanan bawah gambar dengan teks tetap "AI Generated".
  • false (default)
  • true
seed integer (opsional)Bibit angka acak. Rentang valid: [0,2147483647].Menggunakan seed yang sama menghasilkan output serupa. Jika diabaikan, algoritma menggunakan seed acak.Catatan: Generasi gambar bersifat probabilistik. Bahkan dengan seed yang sama, hasilnya mungkin berbeda.

Parameter respons

  • Respons berhasil
  • Respons error
Simpan task_id untuk menanyakan status dan hasil tugas.
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}
output objectOutput tugas.

Properti

task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.

Nilai enumerasi

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui.
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting.
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.

Langkah 2: Tanyakan hasil menggunakan ID tugas

  • Singapura
  • AS (Virginia)
  • China (Beijing)
  • Jerman (Frankfurt)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Saat memanggil, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
  • Rekomendasi polling: Generasi gambar memakan waktu. Gunakan mekanisme polling dengan interval yang masuk akal, misalnya 10 detik.
  • Transisi status tugas: PENDING → RUNNING → SUCCEEDED atau FAILED.
  • Tautan hasil: Setelah tugas berhasil, URL gambar yang berlaku selama 24 jam dikembalikan. Unduh dan simpan gambar ke penyimpanan permanen, seperti OSS.

Parameter permintaan

  • Tanyakan hasil tugas
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam, Ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Header permintaan
Authorization string (Wajib)Mengautentikasi permintaan dengan Kunci API Model Studio. Contoh: Bearer sk-xxxx.
Parameter path URL
task_id string (Wajib)ID tugas.

Parameter respons

  • Eksekusi tugas berhasil
  • Kegagalan eksekusi tugas
Data tugas (status tugas dan URL gambar) hanya disimpan selama 24 jam, lalu secara otomatis dihapus. Segera simpan gambar yang dihasilkan.
{
    "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
    "output": {
        "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-12-16 04:21:02.275",
        "scheduled_time": "2025-12-16 04:21:02.304",
        "end_time": "2025-12-16 04:24:46.658",
        "finished": true,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            },
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ]
    },
    "usage": {
        "size": "1376*768",
        "total_tokens": 0,
        "image_count": 2,
        "output_tokens": 0,
        "input_tokens": 0
    }
}
output objectInformasi output tugas.

Properti

task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.

Nilai enumerasi

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui.
Transisi status selama polling:
  • PENDING → RUNNING → SUCCEEDED atau FAILED.
  • Status kueri awal biasanya PENDING atau RUNNING.
  • Saat status berubah menjadi SUCCEEDED, respons berisi URL gambar yang dihasilkan.
  • Jika statusnya FAILED, periksa pesan error dan coba ulang tugas tersebut.
submit_time stringWaktu saat tugas diajukan. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu saat tugas dieksekusi. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu saat tugas selesai. Waktu dalam UTC+8 dan formatnya YYYY-MM-DD HH:mm:ss.SSS.finished boolFlag penyelesaian permintaan.
  • true
  • false
choices array of objectKonten output yang dihasilkan model.

Properti

finish_reason stringAlasan penghentian tugas. Berhenti secara alami dengan stop.message objectPesan yang dikembalikan oleh model.

Properti

rolestringPeran pesan, tetap sebagai assistant.contentarray

Properti

type stringTipe output. Nilai enumerasi: text, image.text stringTeks yang dihasilkan.image stringURL gambar yang dihasilkan dalam format PNG.Tautan kedaluwarsa setelah 24 jam. Unduh dan simpan gambar segera.
usage objectStatistik output. Hanya menghitung hasil yang berhasil.

Properti

image_count integerJumlah gambar yang dihasilkan.size stringResolusi gambar yang dihasilkan. Contoh: 1376×768.input_tokens integerJumlah token input. Ditagih per jumlah gambar. Saat ini tetap 0.output_tokens integerJumlah token output. Ditagih per jumlah gambar. Saat ini tetap 0.total_tokensintegerJumlah total token. Ditagih per jumlah gambar. Saat ini tetap 0.
request_id stringIdentifier permintaan unik untuk pelacakan dan troubleshooting.
code stringKode error. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.
message stringPesan error detail. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode error.

DashScope Python SDK

Parameter SDK sejalan dengan antarmuka HTTP, disesuaikan sesuai konvensi bahasa. SDK menangani pemanggilan asinkron secara internal dan mendukung pemanggilan sinkron maupun asinkron.
Durasi aktual bervariasi tergantung panjang antrian dan beban layanan.
Membutuhkan DashScope Python SDK versi 1.25.8 atau lebih baru. Instal SDK.
Parameter base_url dan Kunci API bersifat spesifik wilayah. Contoh panggilan dari wilayah Singapura:
  • Singapura
  • AS (Virginia)
  • China (Beijing)
  • Jerman (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.

Pengeditan gambar

  • Sinkron
  • Asinkron
Contoh permintaan
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# base_url wilayah Singapura. URL dasar berbeda tiap wilayah.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: api_key="sk-xxx"
# Kunci API berbeda tiap wilayah. Dapatkan Kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

message = Message(
    role="user",
    # Mendukung file lokal, contoh: "image": "file://umbrella1.png"
    content=[
        {
            "text": "Generate a tomato and egg stir-fry based on the style of image 1 and the background of image 2"
        },
        {
            "image": "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"
        },
        {
            "image": "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp"
        }
    ]
)
print("----sync call, wait a moment----")
rsp = ImageGeneration.call(
        model='wan2.6-image',
        api_key=api_key,
        messages=[message],
        negative_prompt="",
        prompt_extend=True,
        watermark=False,
        n=1,
        enable_interleave=False,
        size="1K"
    )

print(rsp)
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
{
    "status_code": 200,
    "request_id": "b6a4c68d-3a91-4018-ae96-3cf373xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "text": null,
        "finish_reason": null,
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxxx.png?Expires=xxxxxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "audio": null,
        "finished": true
    },
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "characters": 0,
        "image_count": 1,
        "size": "1376*768",
        "total_tokens": 0
    }
}
Statistik output dikembalikan di bidang usage tingkat atas, pada level yang sama dengan output. Baca sebagai response.usage["image_count"]. Objek output tidak membawa statistik: response.output.usage dikembalikan sebagai {} dan tidak berisi image_count.

Output teks-gambar interleaved

  • Sinkron (streaming saja)
  • Asinkron
Contoh permintaan
import os
import dashscope
from dashscope.aigc.image_generation import ImageGeneration
from dashscope.api_entities.dashscope_response import Message

# URL wilayah Singapura. URL dasar berbeda tiap wilayah.
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: api_key="sk-xxx"
# Kunci API berbeda tiap wilayah. Dapatkan Kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

def sync_call_with_stream():
    print("\n========== Synchronous call - Streaming text-image output ==========")

    image_message = Message(
        role="user",
        content=[
            {
                "text": "Give me a three-image tutorial for stir-fried pork with chili peppers"
            }
        ]
    )

    image_stream_res = ImageGeneration.call(
        model="wan2.6-image",
        api_key=api_key,
        messages=[image_message],
        stream=True,  # Streaming saja
        negative_prompt="",
        enable_interleave=True,
        max_images=3,
        size="1280*1280"
    )

    print("Streaming output results:")
    for stream_res in image_stream_res:
        print(stream_res)

if __name__ == "__main__":
    sync_call_with_stream()
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Chili"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 0, "characters": 0, "total_tokens": 28, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Stir-fry"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 1, "characters": 0, "total_tokens": 29, "image_count": 0, "size": "0*0"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "Pork"}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 2, "characters": 0, "total_tokens": 30, "image_count": 0, "size": "0*0"}}

......

{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": null, "choices": [{"finish_reason": "null", "message": {"role": "assistant", "content": [{"type": "text", "text": "."}]}}], "audio": null, "finished": false}, "usage": {"input_tokens": 28, "output_tokens": 398, "characters": 0, "total_tokens": 426, "image_count": 2, "size": "1280*1280"}}
{"status_code": 200, "request_id": "5b98e8f3-aeff-4c20-a26c-499a7525axxx", "code": "", "message": "", "output": {"text": null, "finish_reason": "stop", "choices": [{"finish_reason": "stop", "message": {"role": "assistant", "content": [{"type": "image", "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}], "audio": null, "finished": true}, "usage": {"input_tokens": 28, "output_tokens": 523, "characters": 0, "total_tokens": 551, "image_count": 3, "size": "1280*1280"}}

DashScope Java SDK

Parameter SDK sejalan dengan antarmuka HTTP, dikemas sesuai konvensi bahasa. SDK menangani pemanggilan asinkron secara internal dan mendukung pemanggilan sinkron maupun asinkron.
Durasi aktual bergantung pada panjang antrian dan beban layanan.
Membutuhkan DashScope Java SDK versi 2.22.6 atau lebih baru.
Parameter base_url dan Kunci API tidak dapat saling dipertukarkan antar wilayah. Contoh untuk wilayah Singapura:
  • Singapura
  • AS (Virginia)
  • China (Beijing)
  • Jerman (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Saat melakukan panggilan, ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.
Cakupan penerapan global (wilayah Frankfurt) hanya mendukung pemanggilan asinkron.

Pengeditan gambar

  • Sinkron
  • Asinkron
Contoh permintaan
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.Arrays;
import java.util.Collections;

/**
 * wan2.6-image Pengeditan gambar - Contoh pemanggilan sinkron
 */
public class Main {

    static {
        // URL wilayah Singapura. URL dasar berbeda tiap wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: apiKey="sk-xxx"
    // Kunci API berbeda tiap wilayah. Dapatkan Kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void basicCall() throws ApiException, NoApiKeyException, UploadFileException {
        // Bangun pesan input multi-gambar
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Arrays.asList(
                        // Mendukung input multi-gambar; berikan beberapa gambar referensi
                        Collections.singletonMap("text", "Generate a tomato and egg stir-fry based on the style of image 1 and the background of image 2"),
                        Collections.singletonMap("image", "https://cdn.wanx.aliyuncs.com/tmp/pressure/umbrella1.png"),
                        Collections.singletonMap("image", "https://img.alicdn.com/imgextra/i3/O1CN01SfG4J41UYn9WNt4X1_!!6000000002530-49-tps-1696-960.webp")
                )).build();

        // Pengeditan gambar menggunakan pemanggilan sinkron standar; tidak perlu mengatur stream atau enable_interleave
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .n(1)
                .size("1K")
                .negativePrompt("")
                .promptExtend(true)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        ImageGenerationResult result = null;
        try {
            System.out.println("---sync call for image editing, wait a moment----");
            result = imageGeneration.call(param);
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            basicCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
    }
}
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
{
    "requestId": "b148327e-830f-414c-a8df-724dec28exxx",
    "usage": {
        "input_tokens": 0,
        "output_tokens": 0,
        "total_tokens": 0,
        "image_count": 1,
        "size": "1376*768"
    },
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": [
                        {
                            "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx",
                            "type": "image"
                        }
                    ]
                }
            }
        ],
        "finished": true
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

Output teks-gambar interleaved

  • Pemanggilan sinkron (streaming saja)
  • Pemanggilan asinkron
Contoh permintaan
import com.alibaba.dashscope.aigc.imagegeneration.*;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;
import io.reactivex.Flowable;

import java.util.Collections;

/**
 * wan2.6-image Output teks-gambar - Contoh pemanggilan streaming
 */
public class Main {

    static {
        // URL wilayah Singapura. URL dasar berbeda tiap wilayah.
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: apiKey="sk-xxx"
    // Kunci API berbeda tiap wilayah. Dapatkan Kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void streamCall() throws ApiException, NoApiKeyException, UploadFileException {
        ImageGenerationMessage message = ImageGenerationMessage.builder()
                .role("user")
                .content(Collections.singletonList(
                        Collections.singletonMap("text", "Give me a three-image tutorial for stir-fried pork with chili peppers")
                )).build();

        // Output teks-gambar memerlukan pemanggilan streaming
        ImageGenerationParam param = ImageGenerationParam.builder()
                .apiKey(apiKey)
                .model("wan2.6-image")
                .messages(Collections.singletonList(message))
                .stream(true) // Harus mengaktifkan output streaming
                .enableInterleave(true)
                .size("1280*1280")
                .negativePrompt("")
                .maxImages(3)
                .build();

        ImageGeneration imageGeneration = new ImageGeneration();
        try {
            System.out.println("---stream call for image interleave----");
            Flowable<ImageGenerationResult> resultFlowable = imageGeneration.streamCall(param);
            resultFlowable.blockingForEach(result -> {
                System.out.println(JsonUtils.toJson(result));
            });
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            throw new RuntimeException(e.getMessage());
        }
    }

    public static void main(String[] args) {
        try {
            streamCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
Contoh respons
URL kedaluwarsa setelah 24 jam. Unduh gambar segera.
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":0,"total_tokens":28,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Chili"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":1,"total_tokens":29,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"stir-fry"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":2,"total_tokens":30,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"pork"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":73,"total_tokens":101,"image_count":0,"size":"0*0"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":198,"total_tokens":226,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":199,"total_tokens":227,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Next"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":245,"total_tokens":273,"image_count":1,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":368,"total_tokens":396,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":369,"total_tokens":397,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"Finally"}]}}],"finished":false},"status_code":200,"code":"","message":""}

......

{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":416,"total_tokens":444,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"pot"}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":417,"total_tokens":445,"image_count":2,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"null","message":{"role":"assistant","content":[{"type":"text","text":"."}]}}],"finished":false},"status_code":200,"code":"","message":""}
{"requestId":"12c7432c-8028-4289-a97c-4e22df98bxxx","usage":{"input_tokens":28,"output_tokens":541,"total_tokens":569,"image_count":3,"size":"1280*1280"},"output":{"choices":[{"finish_reason":"stop","message":{"role":"assistant","content":[{"type":"image","image":"https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"}]}}],"finished":true},"status_code":200,"code":"","message":""}

Batasan

  • Validitas data: task_id dan url gambar hanya disimpan selama 24 jam. Setelah periode ini, mereka tidak dapat ditanyakan atau diunduh.
  • Moderasi konten: Baik prompt input maupun gambar output menjalani moderasi konten. Konten yang tidak sesuai mengembalikan error IPInfringementSuspect atau DataInspectionFailed. Lihat Kode error.

Penagihan dan pembatasan laju

  • Kuota gratis dan harga: Harga model.
  • Untuk batas laju model, lihat Wanxiang.
  • Anda ditagih per gambar yang berhasil dihasilkan. Pemanggilan yang gagal tidak dikenai biaya dan tidak menghabiskan kuota gratis.

Kode error

Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode error untuk resolusi.

FAQ

T: Bagaimana cara melihat biaya inferensi dan volume pemanggilan model? J: Lihat Pertanyaan tagihan dan manajemen biaya. T: Mengapa saya tidak bisa menjalankan contoh kode? J: Tingkatkan SDK Anda ke versi terbaru. Instal SDK.
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Realtime API
Penyematan Teks
TokenPlan
Model production