Alibaba Cloud Model Studio:Kode kesalahan

Topik ini menjelaskan pesan kesalahan umum yang mungkin Anda temui saat menggunakan Alibaba Cloud Model Studio dan menyediakan solusinya.

400-InvalidParameter

parameter.enable_thinking must be set to false for non-streaming calls/parameter.enable_thinking only support stream call

Penyebab: Anda memanggil model mode berpikir menggunakan metode output non-streaming.

Solusi: Atur parameter enable_thinking ke false, atau gunakan metode streaming output untuk memanggil model mode berpikir.

The thinking_budget parameter must be a positive integer and not greater than xxx

Penyebab: Parameter thinking_budget berada di luar rentang yang diizinkan.

Solusi: Rujuk panjang maksimum rantai-pikiran yang tercantum untuk model tersebut dalam Daftar Model dan atur parameter ini ke nilai lebih dari 0 dan tidak melebihi batas tersebut.

This model only support stream mode, please enable the stream parameter to access the model. / current user api does not support http call.

Penyebab: Model hanya mendukung streaming output, tetapi streaming tidak diaktifkan selama pemanggilan.

Solusi: Gunakan metode streaming output untuk memanggil model.

This model does not support enable_search.

Penyebab: Model saat ini tidak mendukung kemampuan pencarian web, tetapi parameter enable_search diatur ke true.

Solusi: Panggil model yang mendukung pencarian web.

Current language settings are not supported!

Penyebab: Saat menggunakan model Qwen-MT, format parameter source_lang atau target_lang salah atau tidak termasuk dalam daftar bahasa yang didukung.

Solusi: Berikan nama bahasa Inggris yang benar atau kode bahasa.

The incremental_output parameter must be "true" when enable_thinking is true

Penyebab: Saat mode berpikir diaktifkan, model hanya mendukung output streaming inkremental, tetapi parameter incremental_output tidak diatur ke true.

Solusi: Atur parameter incremental_output ke true sebelum memanggil. API kemudian akan mengembalikan konten inkremental.

The incremental_output parameter of this model cannot be set to False.

Penyebab: Model hanya mendukung output streaming inkremental, tetapi parameter incremental_output tidak diatur ke true.

Solusi: Atur parameter incremental_output ke true sebelum memanggil. API kemudian akan mengembalikan konten inkremental.

Range of input length should be [1, xxx] (InternalError.Algo.InvalidParameter)

Penyebab: Panjang input melebihi batas maksimum model.

Solusi:

• Jika memanggil melalui kode, pastikan jumlah total token dalam array messages tetap berada dalam batas token input maksimum model.
• Saat menggunakan klien chat (seperti Chatbox) atau konsol Alibaba Cloud Model Studio untuk percakapan berkelanjutan, setiap permintaan mencakup riwayat percakapan, yang dapat dengan mudah melebihi batas model. Jika hal ini terjadi, mulai percakapan baru.

Range of max_tokens should be [1, xxx]

Penyebab: Parameter max_tokens tidak berada dalam rentang [1, token output maksimum untuk model].

Solusi: Rujuk nilai "Token Output Maksimum" dalam dokumentasi Daftar Model untuk batas atas max_tokens.

Temperature should be in [0.0, 2.0)/'temperature' must be Float

Penyebab: Parameter temperature berada di luar rentang [0.0, 2.0).

Solusi: Atur parameter temperature ke angka lebih besar atau sama dengan 0 dan kurang dari 2.

Range of top_p should be (0.0, 1.0]/'top_p' must be Float

Penyebab: Parameter top_p berada di luar rentang (0.0, 1.0].

Solusi: Atur parameter top_p ke angka lebih besar dari 0 dan kurang dari atau sama dengan 1.

Parameter top_k be greater than or equal to 0

Penyebab: Parameter top_k diatur ke angka kurang dari 0.

Solusi: Atur parameter top_k ke angka lebih besar atau sama dengan 0.

Repetition_penalty should be greater than 0.0

Penyebab: Parameter repetition_penalty diatur ke angka kurang dari atau sama dengan 0.

Solusi: Atur parameter repetition_penalty ke angka lebih besar dari 0.

Presence_penalty should be in [-2.0, 2.0]

Penyebab: Parameter presence_penalty berada di luar rentang [-2.0,2.0].

Solusi: Atur parameter presence_penalty dalam rentang [-2.0,2.0].

Range of n should be [1, 4]

Penyebab: Parameter n tidak berada dalam rentang [1, 4].

Solusi: Atur parameter n dalam rentang [1, 4].

Range of seed should be [0, 9223372036854775807]

Penyebab: Saat menggunakan protokol DashScope, parameter seed tidak berada dalam rentang [0, 9223372036854775807].

Solusi: Atur parameter seed dalam rentang [0, 9223372036854775807].

Request method 'GET' is not supported.

Penyebab: API saat ini tidak mendukung metode permintaan GET.

Solusi: Konsultasikan referensi API dan gunakan metode permintaan yang didukung (seperti POST) untuk mengirim ulang permintaan.

messages with role "tool" must be a response to a preceeding message with "tool_calls"

Penyebab: Selama pemanggilan alat, Anda tidak menambahkan Pesan Asisten ke array messages.

Solusi: Tambahkan respons Pesan Asisten pertama dari model ke array messages sebelum menambahkan Pesan Alat.

An assistant message with "tool_calls" must be followed by tool messages responding to each "tool_call_id"

Penyebab: Pesan asisten yang berisi tool_calls harus diikuti oleh pesan dengan peran tool yang merespons setiap tool_call_id. Kesalahan ini biasanya menunjukkan bahwa urutan pesan yang dikirim ke API Model Studio selama pemanggilan alat salah, misalnya pesan pengguna langsung mengikuti pesan asisten yang berisi tool_calls.

Solusi: Setelah pesan asisten yang berisi tool_calls, dan sebelum Anda mengirim pesan pengguna berikutnya, sisipkan pesan yang sesuai dengan peran tool. Setiap pesan ini harus membawa tool_call_id yang sesuai dan hasil eksekusi alat tersebut. Setiap tool_call_id dalam pesan asisten harus dijawab oleh tepat satu pesan tool.

Required body invalid, please check the request body format.

Penyebab: Format badan permintaan tidak memenuhi persyaratan API.

Solusi: Periksa badan permintaan untuk memastikan JSON-nya valid. Masalah umum termasuk koma tambahan (,), tanda kurung tidak tertutup, dan tanda kutip tidak tertutup.

Contoh salah (bidang text kehilangan tanda kutip penutup, sehingga badan bukan JSON yang valid):

{"model":"qwen-image-edit","input":{"messages":[{"role":"user","content":[{"image":"https://example.com/img.png"},{"text":"Change the image background to blue}]}]}}

Contoh benar:

{"model":"qwen-image-edit","input":{"messages":[{"role":"user","content":[{"image":"https://example.com/img.png"},{"text":"Change the image background to blue"}]}]}}

Sebelum mengirim ulang permintaan, Anda dapat memvalidasi sintaks badan permintaan dengan validator JSON seperti jsonlint.com. Anda juga dapat menggunakan large model untuk membantu memperbaiki format badan permintaan.

input content must be a string.

Penyebab: Model teks biasa tidak mendukung pengaturan bidang content dalam messages ke tipe non-string.

Solusi: Jangan atur content ke tipe array seperti [{"type": "text","text": "Who are you?"}].

The content field is a required field.

Penyebab: Saat membuat permintaan, Anda tidak menentukan parameter content, misalnya: {"role": "user"}.

Solusi: Tentukan parameter content, misalnya: {"role": "user","content": "Who are you?"}.

Either "prompt" or "messages" must exist and cannot both be none

Penyebab: Saat memanggil model bahasa besar, Anda tidak menentukan parameter messages maupun parameter prompt (yang sudah tidak digunakan lagi). Jika Anda menentukan messages tetapi masih menerima kesalahan, formatnya mungkin salah—misalnya, saat menggunakan DashScope-HTTP, messages harus ditempatkan di dalam objek input, bukan pada level yang sama dengan parameter model.

Solusi: Tentukan parameter messages. Jika Anda sudah melakukannya tetapi masih mendapat kesalahan, lihat referensi API text generation untuk memverifikasi penempatannya.

'messages' must contain the word 'json' in some form, to use 'response_format' of type 'json_object'.

Penyebab: Saat menggunakan structured output, prompt tidak menyertakan kata kunci json.

Solusi: Tambahkan kata kunci json (tidak peka huruf besar/kecil) ke prompt Anda, misalnya: “Silakan keluarkan dalam format JSON.”

Json mode response is not supported when enable_thinking is true

Penyebab: Anda mengaktifkan mode berpikir model saat menggunakan structured output.

Solusi: Saat menggunakan structured output, atur enable_thinking ke false untuk menonaktifkan mode berpikir. Atau, lihat FAQ How to use structured output with thinking-mode models?

Tool names are not allowed to be [search]

Penyebab: Nama alat tidak boleh diatur ke search.

Solusi: Atur nama alat ke nilai selain search.

Unknown format of response_format, response_format should be a dict, includes 'type' and an optional key 'json_schema'. The response_format type from user is xxx.

Penyebab: Parameter response_format yang ditentukan tidak mematuhi persyaratan.

Solusi: Untuk menggunakan structured output, atur parameter response_format ke {"type": "json_object"}.

The value of the enable_thinking parameter is restricted to True.

Penyebab: Untuk model tertentu (seperti qwen3-235b-a22b-thinking-2507), Anda tidak dapat mengatur parameter enable_thinking ke false.

Solusi:

• Jika memanggil melalui alat pihak ketiga (seperti Cherry Studio), aktifkan toggle berpikir di kotak input.
• Jika memanggil melalui kode, atur enable_thinking ke true.

'audio' output only support with stream=true

Penyebab: Saat menggunakan model Qwen-Omni, Anda tidak menggunakan output streaming, tetapi model hanya mendukung streaming.

Solusi: Atur parameter stream ke true untuk mengaktifkan output streaming.

tool_choice is one of the strings that should be ["none", "auto"]

Penyebab: Parameter tool_choice salah selama Function Calling.

Solusi: Atur ke "auto" (biarkan LLM memilih alat secara otonom) atau "none" (paksa tanpa penggunaan alat).

Model not exist.

Penyebab: Parameter model tidak valid atau formatnya salah.

Solusi:

• Periksa format nama model: Verifikasi bahwa parameter model menggunakan kapitalisasi yang benar dan tidak mengandung spasi tambahan.
• Gunakan nama model yang benar: Periksa model yang Anda masukkan terhadap nama model dalam Daftar Model untuk memastikan kebenarannya. Jangan mencampur nama model dari komunitas open-source dengan ID model Model Studio, seperti menggunakan qwen3-235b-a22b-instruct-2507 alih-alih Qwen/Qwen3-235B-A22B-Instruct-2507.

The result_format parameter must be "message" when enable_thinking is true

Penyebab: Saat memanggil model mode berpikir, parameter result_format tidak diatur ke "message".

Solusi: Atur parameter result_format ke "message".

The audio is empty

Penyebab: Audio input terlalu pendek, mengakibatkan titik sampling tidak mencukupi.

Solusi: Tingkatkan durasi audio.

File parsing in progress, please try again later.

Penyebab: Saat menggunakan model Qwen-Long, file belum selesai diparsing.

Solusi: Tunggu hingga parsing file selesai sebelum mencoba lagi.

The "stop" parameter must be of type "str", "list[str]", "list[int]", or "list[list[int]]", and all elements within the list must be of the same type.

Penyebab: Parameter stop tidak sesuai dengan format yang diperlukan: str, list[str], list[int], atau list[list[int]].

Solusi: Lihat referensi API text generation dan atur parameter stop dengan benar.

Value error, batch size is invalid, it should not be larger than xxx.

Penyebab: Saat memanggil model Embedding, jumlah teks melebihi batas model.

Solusi: Rujuk informasi batch size dalam dokumentasi Embedding dan kendalikan jumlah teks input.

[] is too short

Penyebab: Array messages input kosong.

Solusi: Tambahkan pesan sebelum mengirim permintaan.

The tool call is not supported.

Penyebab: Model yang Anda gunakan tidak mendukung parameter tools.

Solusi: Beralihlah ke model Qwen atau DeepSeek yang mendukung Function Calling.

The provided messages input is invalid. The error info is [Unexpected item type in content] / Input should be a valid string / Input should be a valid dictionary or instance of ... (input.messages.x.content...)

Penyebab: Bidang content dari pesan dalam array messages berisi item dengan tipe yang tidak didukung. Saat content adalah array, setiap elemen harus berupa string atau objek valid (seperti {"type": "text", "text": "..."} atau {"type": "image_url", ...}). Melewatkan angka, boolean, array bersarang, atau objek yang type-nya tidak didukung memicu kesalahan ini. Kode status HTTP yang sesuai adalah 400 dan kode kesalahan adalah InternalError.Algo.InvalidParameter.

Skenario umum: Saat Anda menggunakan model teks saja (seperti seri teks Qwen-Max, termasuk qwen3-max) dan messages (terutama riwayat percakapan multi-putaran) berisi item content multimodal seperti gambar (image_url), kesalahan ini juga dipicu, karena model teks saja tidak menerima input gambar atau modalitas lainnya. Di beberapa alat atau agen terintegrasi, kesalahan ini mungkin muncul sebagai pesan seperti "penyedia model mengembalikan konten kosong".

Solusi:

• Model teks saja: Atur content ke string alih-alih array atau tipe lainnya. Jika kasus penggunaan Anda memerlukan input gambar atau multimodal lainnya, beralihlah ke model multimodal (seperti seri Qwen-VL atau Qwen3-VL); jika Anda harus tetap menggunakan model teks saja, hapus item multimodal seperti gambar (image_url) dari messages dan riwayat percakapan sebelum memanggil.
• Model multimodal: Setiap elemen dalam array content harus berupa objek valid yang type-nya merupakan salah satu tipe modalitas yang didukung oleh model, seperti text, image_url, video_url, atau video. Jangan sertakan angka, boolean, array bersarang, atau elemen yang kehilangan type atau nilai type-nya tidak valid.

Required parameter(xxx) missing or invalid, please check the request parameters.

Penyebab: Parameter pemanggilan API tidak valid.

Solusi: Periksa parameter permintaan untuk memastikan semua parameter yang diperlukan telah disediakan dan diformat dengan benar.

Saat pesan kesalahan menentukan parameter data_sources, biasanya berarti bahwa saat memanggil API CreateIndex, parameter yang diperlukan SourceType dihilangkan, menyebabkan API SubmitIndexJob berikutnya gagal. Saat membuat basis pengetahuan dari dokumen, atur parameter ini ke DATA_CENTER_FILE; saat membuat dari kategori, atur ke DATA_CENTER_CATEGORY. Lihat dokumentasi CreateIndex untuk detailnya.

input must contain file_urls

Penyebab: Saat menggunakan pengenalan suara (Paraformer) untuk pengenalan file rekaman, Anda tidak memberikan nilai ke parameter permintaan file_urls.

Solusi: Sertakan parameter file_urls dalam permintaan Anda dan berikan nilainya.

The provided URL does not appear to be valid. Ensure it is correctly formatted.

Penyebab: Saat menggunakan model pemahaman visual, omni-modal, atau pemahaman audio, URL atau path lokal yang diberikan tidak valid atau tidak memenuhi persyaratan.

Solusi:

• Melewatkan URL: Harus dimulai dengan http://, https://, atau data:. Jika dimulai dengan data:, sertakan "base64" sebelum data Base64.

• Melewatkan path lokal: Harus dimulai dengan file://.

• Melewatkan URL sementara:
  • Untuk panggilan HTTP, pastikan header permintaan menyertakan X-DashScope-OssResourceResolve: enable.
  • Untuk panggilan SDK: Hanya SDK DashScope yang didukung—jangan gunakan SDK OpenAI.

Input should be a valid dictionary or instance of GPT3Message

Penyebab: Format bidang messages tidak valid—misalnya, tanda kurung tidak cocok atau pasangan kunci-nilai hilang.

Solusi: Periksa bahwa struktur JSON dari bidang messages benar.

Value error, contents is neither str nor list of str.: input.contents

Penyebab: Saat menggunakan model Embedding, input bukan string maupun daftar string.

Solusi: Ubah format input menjadi string atau daftar string.

No backend server available

Penyebab: Layanan backend Model Studio sementara tidak tersedia. Hal ini dapat disebabkan oleh pembaruan layanan, penskalaan, penjadwalan sumber daya, atau kegagalan sementara.

Solusi:

1. Masuk ke konsol Alibaba Cloud dan buka halaman Biaya dan Pengeluaran untuk memastikan akun Anda tidak tertunggak. Jika akun Anda tertunggak, isi ulang akun dan tunggu beberapa menit hingga pembayaran berlaku.
2. Gunakan curl atau ping untuk menguji konektivitas ke dashscope.aliyuncs.com.
3. Masuk ke konsol Model Studio dan periksa status layanan.
4. Setelah Anda memastikan akun dan jaringan Anda normal, tunggu beberapa menit lalu panggil API lagi.

The video modality input does not meet the requirements because: the range of sequence images shoule be (4, 512)./(4,80).

Penyebab: Saat menggunakan model Qwen VL untuk memasukkan video sebagai daftar gambar, jumlah gambar tidak memenuhi persyaratan.

Solusi: Untuk model seri Qwen3-VL dan Qwen2.5-VL, berikan 4–512 gambar; untuk model lainnya, berikan 4–80 gambar. Lihat Image and Video Understanding untuk detailnya.

Exceeded limit on max bytes per data-uri item : 10485760'. / Multimodal file size is too large

Penyebab: File gambar atau video lokal yang dilewatkan ke model multimodal (Qwen-VL, QVQ, Qwen-Omni) melebihi batas ukuran.

Solusi:

• File lokal: Setelah encoding Base64, satu file tidak boleh melebihi 10 MB.

• URL file: File gambar tidak boleh melebihi 10 MB; untuk file video:

  • Qwen3-VL, qwen-vl-max: hingga 2 GB;
  • seri qwen-vl-plus: hingga 1 GB;
  • Model lainnya: hingga 150 MB.

Lihat Cara mengompres gambar atau video agar memenuhi persyaratan ukuran

Input should be 'Cherry', 'Serena', 'Ethan' or 'Chelsie': parameters.audio.voice

Penyebab: Saat menggunakan Qwen-Omni atau Qwen-TTS, parameter voice salah.

Solusi: Atur ke salah satu: 'Cherry', 'Serena', 'Ethan', atau 'Chelsie'.

The image length and width do not meet the model restrictions.

Penyebab: Dimensi (lebar dan tinggi) gambar yang dilewatkan ke model Qwen VL tidak memenuhi persyaratan model.

Solusi: Dimensi gambar harus memenuhi: lebar dan tinggi minimal 10 piksel, dan rasio aspek tidak boleh melebihi 200:1 atau 1:200.

Failed to decode the image during the data inspection.

Penyebab: Dekoding gambar gagal.

Solusi: Konfirmasi gambar tidak rusak dan formatnya didukung.

The file format is illegal and cannot be opened. / The audio format is illegal and cannot be opened. / The media format is not supported or incorrect for the data inspection.

Penyebab: Format file tidak didukung atau file tidak dapat dibuka.

Solusi: Konfirmasi file tidak rusak, ekstensi nama file sesuai dengan format aktual, dan formatnya didukung.

The input messages do not contain elements with the role of user.

Penyebab:

• Saat memanggil model, Anda tidak melewatkan Pesan Pengguna;
• Atau, saat memanggil aplikasi alur kerja Alibaba Cloud Model Studio melalui API, parameter yang dilewatkan ke node awal harus dikirim melalui parameter biz_params (bukan user_prompt_params).

Solusi: Pastikan Anda melewatkan Pesan Pengguna ke model atau melewatkan parameter kustom dengan benar.

Failed to download multimodal content. /Download the media resource timed out during the data inspection process./Unable to download the media resource during the data inspection process.

Penyebab: Server tidak dapat mengunduh file media dari URL publik, kemungkinan disebabkan oleh:

• Masalah konektivitas: Menggunakan alamat jaringan internal dari Alibaba Cloud Object Storage Service.
• Latensi jaringan: Akses lintas wilayah menyebabkan timeout.
• Ketidakstabilan layanan: Layanan penyimpanan sumber lambat atau tidak dapat dijangkau.
• Pemblokiran kebijakan keamanan: Identifier DashScopeUserBot yang dikirim server saat mengunduh URL publik mungkin diblokir oleh kebijakan keamanan server pihak ketiga, menyebabkan unduhan gagal.

Solusi:

• Ubah layanan penyimpanan

  Gunakan layanan penyimpanan di wilayah yang sama dengan layanan model. Kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service untuk menghasilkan URL publik (jangan gunakan alamat internal).

• Sesuaikan metode transfer

  Jika melewatkan URL publik gagal, rujuk Pass local files (Base64 encoded or file paths) dan beralih ke metode yang direkomendasikan:

  Jenis file	Spesifikasi file	DashScope SDK (Python, Java)	OpenAI-compatible / DashScope HTTP
  Gambar	Lebih besar dari 7 MB tetapi lebih kecil dari 10 MB	Melewatkan path lokal	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service
  	Lebih kecil dari 7 MB	Melewatkan path lokal	Diencode Base64
  Video	Lebih besar dari 100 MB	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service
  	Lebih besar dari 7 MB tetapi lebih kecil dari 100 MB	Melewatkan path lokal	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service
  	Lebih kecil dari 7 MB	Melewatkan path lokal	Diencode Base64
  Audio	Lebih besar dari 10 MB	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service
  	Lebih besar dari 7 MB tetapi lebih kecil dari 10 MB	Melewatkan path lokal	Hanya URL publik; kami merekomendasikan menggunakan Alibaba Cloud Object Storage Service
  	Lebih kecil dari 7 MB	Melewatkan path lokal	Diencode Base64

  Encoding Base64 meningkatkan ukuran data; file asli harus lebih kecil dari 7 MB.

  Menggunakan Base64 atau path lokal menghindari timeout unduhan di sisi server dan meningkatkan stabilitas.

• IzinkanDashScopeUserBot

  Jika gambar dihosting di server yang Anda kendalikan, izinkan permintaan yang User-Agent-nya mengandung DashScopeUserBot dalam kebijakan keamanan Anda. Atau, lewatkan file lokal (diencode Base64 atau path file) sehingga server tidak perlu mengunduh URL publik.

Failed to find the requested media resource during the data inspection process.

Penyebab: URL sumber daya yang diberikan tidak valid atau tidak dapat diakses.

Solusi:

• Konfirmasi URL diformat dengan benar dan dapat diakses.
• Konfirmasi file sumber daya belum dihapus atau dipindahkan.
• Konfirmasi URL belum kedaluwarsa (untuk URL OSS yang ditandatangani, periksa periode validitas).

url error, please check url！

• Penyebab 1: Nama model tidak sesuai dengan titik akhir API: Misalnya, menggunakan titik akhir multimodal untuk model teks biasa, atau titik akhir teks biasa untuk model multimodal.

  Solusi:

  1. Saat menggunakan model multimodal seperti qwen3.7-plus, qwen3-vl-plus, qwen3.8-max, atau qwen3.8-flash melalui DashScope: gunakan MultiModalConversation.call() atau titik akhir multimodal-generation. Lihat Image and Video Understanding. Saat beralih dari model teks biasa (seperti qwen3.7-max) ke model multimodal (seperti qwen3.8-max/qwen3.8-flash), ubah pemanggilan dari Generation.call() ke MultiModalConversation.call(); jika tidak, pemanggilan akan mengembalikan kesalahan url.

     Jika menggunakan framework spring-ai-alibaba, konfirmasi Anda telah mengatur parameter multimodal withMultiModel.

  2. Saat menggunakan model teks biasa seperti qwen3-max, qwen-plus, atau deepseek-v4-pro melalui DashScope, gunakan Generation.call() atau titik akhir text-generation. Lihat Overview.

  3. Saat menggunakan API voice cloning CosyVoice melalui DashScope: API ini mencakup parameter model dan target_model. Atur model ke voice-enrollment dan target_model ke model CosyVoice spesifik. Lihat CosyVoice Voice Cloning/Design API.

• Penyebab 2: Versi SDK DashScope usang: Versi SDK lama tidak dapat mengenali alamat server yang benar saat memanggil model generasi gambar/video.

  Solusi: Tingkatkan versi SDK

Don't have authorization to access the media resource during the data inspection process.

Penyebab: URL file OSS yang ditandatangani yang dilewatkan selama pemanggilan model telah kedaluwarsa.

Solusi: Pastikan Anda mengakses file dalam periode validitas URL.

The item of content should be a message of a certain modal.

Penyebab: Saat menggunakan SDK DashScope untuk memanggil model multimodal, setiap elemen dalam array content harus memiliki kunci yang merupakan salah satu: image, video, audio, atau text.

Solusi: Gunakan parameter content yang benar.

Invalid video file.

Penyebab: File video yang diberikan tidak valid.

Solusi: Periksa apakah file video rusak atau formatnya benar.

The video modality input does not meet the requirements because: The video file is too long.

Penyebab: Durasi video melebihi batas untuk model Qwen VL atau Qwen-Omni.

Solusi:

• Qwen2.5-VL mendukung video antara 2 detik dan 10 menit.
• Model Qwen VL atau Qwen-Omni lainnya mendukung video antara 2 detik dan 40 detik.

Field required: xxx

Penyebab: Parameter input yang diperlukan hilang.

Solusi: Tambahkan parameter yang hilang seperti yang ditunjukkan oleh pesan kesalahan xxx.

The request is missing required parameters or in a wrong format, please check the parameters that you send.

Penyebab: Parameter yang diperlukan hilang atau diformat salah.

Solusi: Periksa bahwa semua parameter permintaan lengkap dan diformat dengan benar.

Missing training files.

Penyebab: Kesalahan parameter—parameter hilang atau format salah.

The style is invalid.

Penyebab: Nilai style berada di luar enumerasi yang diizinkan.

Solusi: Periksa bahwa nilai parameter style benar.

The style_level is invalid.

Penyebab: Nilai style_level berada di luar enumerasi yang diizinkan.

Solusi: Lihat EMO Video Generation untuk detailnya.

parameters.video_ratio must be 9:16 or 3:4.

Penyebab: Parameter video_ratio hanya bisa 9:16 atau 3:4.

Solusi: Atur parameter video_ratio ke "9:16" atau "3:4".

the xxx parm is invalid!

Penyebab: Parameter input melebihi rentang yang diizinkan.

Solusi: Lihat Video Style Redrawing untuk detailnya.

input json error.

Penyebab: JSON input tidak valid.

Solusi: Periksa bahwa format JSON permintaan benar.

read image error.

Penyebab: Gagal membaca gambar.

Solusi: Periksa apakah file gambar rusak atau formatnya benar.

the parameters must conform to the specification: xxx.

Penyebab: Nilai parameter input melebihi rentang yang diizinkan.

Solusi: Periksa dan perbaiki nilai parameter seperti yang ditunjukkan oleh pesan kesalahan xxx.

The size of person image and coarse_image are not the same.

Penyebab: Resolusi coarse_image tidak sesuai dengan person_image.

Solusi: Pastikan resolusi coarse_image dan person_image identik.

The request is missing required parameters or the parameters are out of the specified range, please check the parameters that you send.

Penyebab: Parameter API yang diperlukan hilang atau di luar rentang.

Solusi: Periksa dan perbaiki parameter permintaan.

image format error

Penyebab: Format gambar salah.

Solusi: Harus berupa URL gambar atau string Base64.

No messages found in input

Penyebab: Parameter permintaan harus mencakup bidang messages.

Solusi: Lihat Qwen - Image Editing untuk detailnya.

Invalid image format or corrupted file

Penyebab: Format gambar input salah atau file rusak.

Solusi: Periksa bahwa file dapat dibuka dan diunduh secara normal, dan pastikan file tersebut lengkap serta dalam format yang didukung.

download image failed

Penyebab: Gambar tidak dapat diunduh.

Solusi: Periksa bahwa file dapat diunduh secara normal.

messages length only support 1

Penyebab: Panjang array messages hanya mendukung 1.

Solusi: Hanya satu pesan percakapan yang dapat dilewatkan. Lihat Qwen - Image Editing untuk detailnya.

content length only support 2

Penyebab: Panjang array content hanya mendukung 2.

Solusi: Hanya satu teks dan satu gambar yang dapat dilewatkan. Lihat Qwen - Image Editing untuk detailnya.

lack of image or text

Penyebab: Parameter permintaan kehilangan bidang gambar atau teks.

Solusi: Lihat Qwen - Image Editing untuk detailnya.

num_images_per_prompt must be 1.

Penyebab: Parameter permintaan tidak valid; parameter n (jumlah gambar yang dihasilkan) hanya dapat diatur ke 1.

Solusi: Atur nilai parameter n ke 1.

Input files format not supported.

Penyebab: Format audio atau gambar tidak memenuhi persyaratan.

Solusi: Format audio yang didukung: mp3, wav, aac; format gambar yang didukung: jpg, jpeg, png, bmp, webp. Lihat LivePortrait Video Generation untuk detailnya.

Failed to download input files.

Penyebab: Unduhan file input gagal.

Solusi: Periksa bahwa URL file dapat diakses dan jaringan stabil.

oss download error.

Penyebab: Unduhan gambar input gagal.

Solusi: Periksa bahwa tautan OSS untuk gambar benar dan dapat diakses.

The image content does not comply with green network verification.

Penyebab: Konten gambar melanggar kebijakan kepatuhan.

Solusi: Ganti gambar dengan yang mematuhi kebijakan Moderasi Konten.

read video error.

Penyebab: Gagal membaca video.

Solusi: Periksa apakah file video rusak atau formatnya tidak didukung.

the size of input image is too small or too large.

Penyebab: Dimensi gambar input terlalu kecil atau terlalu besar.

Solusi: Sesuaikan dimensi gambar agar memenuhi persyaratan API.

The request parameter is invalid, please check the request parameter.

Penyebab: Ini adalah kesalahan umum yang terjadi dalam berbagai skenario: parameter clothes_type tidak sesuai (OutfitAnyone - Image Segmentation), atau parameter rasio aspek tidak sesuai.

Solusi: Lihat OutfitAnyone - Image Segmentation untuk detailnya. Untuk parameter rasio aspek: Opsi yang valid adalah "1:1" atau "3:4".

The type or value of {parameter} is out of definition.

Penyebab: Jenis atau nilai parameter tidak memenuhi persyaratan.

Solusi: Lihat LivePortrait Video Generation untuk detailnya.

request timeout after 23 seconds.

Penyebab: Tidak ada data yang dikirim ke layanan selama lebih dari 23 detik. Kesalahan ini terjadi saat menggunakan speech recognition (Paraformer), dan real-time speech synthesis (CosyVoice).

Solusi: Periksa mengapa tidak ada data yang dikirim ke server dalam waktu lama. Jika tidak ada pesan yang dikirim ke server selama lebih dari 23 detik, segera akhiri tugas.

Please ensure input text is valid.

Penyebab: Jika Anda menggunakan real-time speech synthesis (CosyVoice), kesalahan ini biasanya terjadi karena tidak ada teks yang dikirim untuk sintesis. Kemungkinan penyebabnya termasuk: parameter hilang (tidak ada nilai yang diberikan ke parameter text) atau pengecualian kode (penugasan ke text gagal).

Solusi: Debug kode Anda untuk memastikan parameter text ditugaskan dan dikirim dengan benar.

Missing required parameter 'xxx'! Please follow the protocol!

Contoh kesalahan:

• Missing required parameter 'payload.model'! Please follow the protocol!
• Missing required parameter 'payload.task_group'! Please follow the protocol!

Penyebab:

1. Format JSON event WebSocket salah (penyebab umum).

   Saat memanggil model menggunakan protokol WebSocket, format JSON yang dikirim tidak valid. Masalah umum termasuk:

   • Persarangan JSON salah—parameter tidak ditempatkan di level hierarkis yang benar.
   • Nama parameter salah eja—misalnya, task_group ditulis sebagai taskgroup.
   • Nilai parameter kosong atau tidak ditugaskan dengan benar.

2. Metode call() tidak dipanggil ulang setelah stop() (skenario spesifik).

   Hanya berlaku untuk: SDK Java DashScope untuk pengenalan suara real-time Fun-ASR atau Paraformer.

   Setelah memanggil metode stop() untuk mengakhiri pengenalan, Anda tidak memanggil ulang metode call() sebelum mengirim lebih banyak data, menyebabkan status sesi tidak valid dan memicu kesalahan ini.

   Perbedaan antara pengguna SDK dan pengguna WebSocket: "Missing required parameter" adalah kesalahan tingkat protokol yang dikembalikan oleh server dan hanya muncul saat menggunakan protokol WebSocket secara langsung. Jika Anda menggunakan kelas Recognition SDK Java DashScope, SDK mencegat operasi ini di sisi klien dan melemparkan pengecualian "Invalid state" ("Expected recognition state should be started, but current state is idle") alih-alih mengembalikan kesalahan "Missing required parameter".

Solusi:

1. Untuk penyebab 1, periksa format dan parameter JSON.
2. Untuk penyebab 2, pastikan bahwa setelah setiap pemanggilan stop(), Anda memanggil ulang metode call() sebelum putaran pengenalan berikutnya. Jika menggunakan SDK Java DashScope, waspadai pengecualian "Invalid state" di sisi klien; jika menggunakan protokol WebSocket secara langsung, Anda akan menerima kesalahan "Missing required parameter".

[tts:]Engine return error code: 418

Penyebab: Saat menggunakan real-time speech synthesis (CosyVoice), parameter permintaan voice (timbre) salah, atau versi model dan voice tidak cocok.

Solusi:

1. Periksa penugasan parameter voice:

   • Jika menggunakan timbre default, verifikasi terhadap bagian "parameter voice" dalam Python SDK.
   • Jika menggunakan timbre hasil kloning, gunakan CosyVoice Voice Cloning/Design API untuk mengonfirmasi status timbre adalah "OK" dan timbre tersebut milik akun yang sama dengan akun pemanggil.

2. Periksa kompatibilitas versi: model v2 hanya dapat menggunakan timbre v2; model v1 hanya dapat menggunakan timbre v1. Jangan mencampur versi.

Request voice is invalid!

Penyebab: Jika Anda menggunakan real-time speech synthesis (CosyVoice), kesalahan ini biasanya terjadi karena tidak ada timbre yang diatur.

Solusi: Periksa bahwa parameter voice diberi nilai. Jika Anda menggunakan WebSocket API reference, konfigurasikan parameter dalam format JSON yang benar seperti yang ditentukan dalam dokumentasi API.

ref_images_url and obj_or_bg must be the same length.

Penyebab: Saat menggunakan fitur referensi multi-gambar di Wanxiang - Video Editing (2.1), panjang array ref_images_url dan obj_or_bg tidak cocok.

Solusi: Pastikan panjang array ref_images_url dan obj_or_bg identik.

check input data style.

Penyebab: Parameter input tidak memenuhi persyaratan.

Solusi: Periksa dan perbaiki parameter input.

An error during model pre-process.

Penyebab: Bidang content dilewatkan dalam format yang salah.

Solusi:

• Jika memanggil melalui kode, jangan atur content ke tipe array seperti [{"type": "text", "text": "Who are you?"}].

The image size is not supported for the data inspection.

Penyebab:

• Dimensi (lebar dan tinggi) gambar yang dilewatkan ke model Qwen VL tidak memenuhi persyaratan model.
• Ukuran gambar output melebihi batas 10 MB.

Solusi:

• Dimensi gambar harus memenuhi:

  • Lebar dan tinggi minimal 10 piksel.
  • Rasio aspek tidak boleh melebihi 200:1 atau 1:200.

• Sesuaikan parameter untuk gambar yang dihasilkan.

Wrong Content-Type of multimodal url

Penyebab: Bidang Content-Type dalam header respons URL salah.

Jenis Konten yang Didukung untuk model Qwen VL: image/bmp, image/icns, image/x-icon, image/jpeg, image/jp2, image/png, image/sgi, image/tiff, image/webp. Lihat Image formats supported by Qwen VL models untuk detailnya.

Solusi:

Periksa bidang Content-Type

1. Buka browser (seperti Chrome atau Firefox).
2. Buka Developer Tools (biasanya dengan menekan F12 atau klik kanan dan pilih "Inspect").
3. Beralih ke tab Network.
4. Masukkan URL gambar di bilah alamat dan kunjungi.
5. Temukan permintaan yang sesuai dan cari di Headers > Response Headers untuk bidang Content-Type.

Field required: image_url

Penyebab: Parameter input image_url hilang.

Solusi: Rujuk Emoji Video Generation dan lewatkan parameter image_url.

Field required: driven_id

Penyebab: Parameter input driven_id hilang.

Solusi: Rujuk Emoji Video Generation dan lewatkan parameter driven_id.

Invalid ext_bbox

Penyebab: Parameter input ext_bbox tidak valid.

Solusi: Rujuk Emoji Video Generation dan lewatkan ext_bbox yang benar.

Driven not exist: driven_id

Penyebab: Input driven_id tidak ada.

Solusi: Rujuk Emoji Video Generation dan lewatkan driven_id yang benar.

Text request limit violated, expected 1.

Penyebab: Saat memanggil API referensi WebSocket sintesis suara CosyVoice, Anda mengatur enable_ssml ke true dan mengirim instruksi continue-task beberapa kali.

Solusi: Saat enable_ssml diatur ke true, Anda hanya dapat mengirim instruksi continue-task sekali.

SSML text is not supported at the moment!

Penyebab: Saat menggunakan sintesis suara CosyVoice, model atau timbre saat ini tidak mendukung SSML, atau fungsionalitas SSML tidak diaktifkan dengan benar.

Solusi: Pecahkan masalah sesuai Limits and Constraints.

[tts:]Engine return error code: 428

Penyebab: Parameter instruction sintesis suara CosyVoice digunakan salah. Masalah spesifik mungkin termasuk:

• Panjang melebihi: instruction tidak boleh melebihi 100 karakter (karakter Cina dihitung sebagai 2 karakter; lainnya sebagai 1).

• Kesalahan format atau bahasa: Hanya model berikut yang mendukung instruction, dengan aturan berbeda:

  • cosyvoice-v3.5-flash, cosyvoice-v3.5-plus: instruksi bebas diizinkan (misalnya, emosi, kecepatan).

  • cosyvoice-v3-flash:

    • Harus mengikuti format tetap.
    • Hanya instruction dalam bahasa Cina yang didukung.
    • instruction yang didukung bervariasi berdasarkan timbre. Lihat CosyVoice Timbre List untuk detailnya.

Solusi:

• Periksa bahwa panjang karakter instruction tidak melebihi 100.
• Konfirmasi bahwa model Anda mendukung parameter instruction.
• Saat menggunakan cosyvoice-v3-flash, pastikan instruction dalam bahasa Cina dan mengikuti format tetap untuk timbre yang sesuai.

At least one of 'lyrics' or 'prompt' must be provided.

Penyebab: Saat menggunakan model Fun-Music, permintaan tidak menyertakan parameter lyrics atau prompt.

Solusi: Sertakan setidaknya salah satu dari lyrics atau prompt dalam permintaan.

Lyrics content is illegal and cannot be used for music generation.

Penyebab: Saat menggunakan model Fun-Music, konten lirik gagal pemeriksaan kepatuhan, kemungkinan berisi materi yang melanggar.

Solusi: Modifikasi lirik untuk memastikan tidak berisi konten yang melanggar atau tidak sesuai, lalu coba lagi.

400-invalid_request_error-invalid_value

-1 is lesser than the minimum of 0 - 'seed'/'seed' must be Integer

Penyebab: Saat menggunakan protokol kompatibel OpenAI, parameter seed tidak berada dalam rentang [0, 2³¹-1].

Solusi: Atur parameter seed dalam rentang [0, 2³¹-1].

400-invalid_request_error

you must provide a model parameter.

Penyebab: Permintaan tidak menyertakan parameter model.

Solusi: Tambahkan parameter model ke permintaan.

400-InvalidParameter.NotSupportEnableThinking

The model xxx does not support enable_thinking.

Penyebab: Model saat ini tidak mendukung parameter enable_thinking.

Solusi: Hapus parameter enable_thinking dari permintaan, atau gunakan model yang mendukung mode berpikir.

400-invalid_value

The requested voice 'xxx' is not supported.

Penyebab: Selama sintesis suara real-time Qwen-TTS, timbre yang dipilih dihasilkan menggunakan kloning suara Qwen-TTS, tetapi model yang digunakan berbeda.

Solusi: Periksa bahwa parameter target_model yang digunakan selama kloning suara sesuai dengan parameter model yang digunakan selama sintesis suara.

400-Arrearage

Access denied, please make sure your account is in good standing.

Penyebab: Akun Alibaba Cloud yang terkait dengan Kunci API memiliki pembayaran tertunda, menyebabkan penolakan akses.

Solusi: Buka Biaya dan Pengeluaran untuk memeriksa pembayaran tertunda:

• Tidak ada pembayaran tertunda: Konfirmasi bahwa Kunci API milik akun saat ini. Jika akun Anda tidak tertunggak, akun Anda mungkin tidak normal. Untuk detailnya, hubungi layanan pelanggan untuk pemecahan masalah lebih lanjut.
• Pembayaran tertunda: Isi ulang segera. Setelah pengisian ulang, pembaruan saldo sistem mungkin tertunda; tunggu sebentar sebelum mencoba lagi.

API provider returned a billing error — your API key has run out of credits or has an insufficient balance. Check your provider's billing dashboard and top up or switch to a different API key.

Penyebab: Saat Anda memanggil Model Studio melalui klien pihak ketiga seperti OpenClaw, jika akun dasar memiliki pembayaran tertunda atau saldo tidak mencukupi, klien menggabungkan kesalahan penagihan sisi server menjadi pesan ini. Kode kesalahan sisi server Model Studio yang mendasarinya adalah Arrearage (yaitu, pesan Access denied, please make sure your account is in good standing. di atas). Ini bukan masalah penagihan klien itu sendiri.

Solusi: Buka Biaya dan Pengeluaran untuk memeriksa pembayaran tertunda: jika ada pembayaran tertunda, isi ulang segera (pembaruan saldo sistem mungkin tertunda setelah pengisian ulang, jadi tunggu sebentar sebelum mencoba lagi); jika tidak ada pembayaran tertunda, konfirmasi bahwa Kunci API yang digunakan milik akun saat ini.

isv.OUT_OF_SERVICE

Penyebab: Saldo akun Alibaba Cloud tidak mencukupi, sehingga layanan ditangguhkan.

Solusi: Isi ulang akun Alibaba Cloud Anda. Layanan dilanjutkan secara otomatis begitu saldo mencukupi.

400-DataInspectionFailed/data_inspection_failed

Input or output data may contain inappropriate content. / Input data may contain inappropriate content. / Output data may contain inappropriate content.

Penyebab: Input atau output berisi konten sensitif yang diduga diblokir oleh Green Net.

Solusi: Modifikasi konten input dan coba lagi.

Input xxx data may contain inappropriate content.

Penyebab: Data input (seperti prompt atau gambar) mungkin berisi konten sensitif. Solusi: Lakukan pemeriksaan kepatuhan konten dan modifikasi input sebelum mencoba lagi.

Qwen rejected the input image before model inference; no actual ad/porn/OCR result was produced.

Penyebab: Sebelum gambar input memasuki inferensi model, gambar tersebut ditandai oleh pemeriksaan pra-keamanan konten (Green Net) sebagai diduga berisi konten sensitif atau tidak sesuai dan karenanya diblokir. Model tidak menjalankan inferensi pada gambar, sehingga tidak ada hasil pengenalan, OCR, atau analisis yang dikembalikan. Ini adalah pemeriksaan kepatuhan konten pra-inferensi pada gambar input multimodal dan termasuk dalam mekanisme keamanan konten yang sama dengan pemblokiran Green Net yang dijelaskan di atas.

Solusi: Ganti atau modifikasi gambar input dan coba lagi. Jika gambar dikonfirmasi sesuai tetapi masih terus-menerus diblokir, kirim tiket untuk verifikasi lebih lanjut.

APIConnectionError (client-side network error, no HTTP status returned)

Connection error.

Penyebab: Masalah jaringan lokal, biasanya karena proxy diaktifkan.

Solusi: Nonaktifkan atau mulai ulang proxy.

400-InvalidFile.DownloadFailed

The audio file cannot be downloaded.

Penyebab: Saat menggunakan speech recognition (Paraformer) untuk pengenalan file rekaman, file yang akan dikenali gagal diunduh.

Solusi: Periksa bahwa URL file audio dapat diakses melalui jaringan publik.

400-InvalidFile.AudioLengthError

Audio length must be between 1s and 300s.

Penyebab: Panjang audio tidak memenuhi persyaratan.

Solusi: Pastikan durasi audio berada dalam [1, 300] detik.

Audio length must be between 1s and 180s.

Penyebab: Panjang audio tidak memenuhi persyaratan.

Solusi: Pastikan durasi audio berada dalam [1, 180] detik.

400-InvalidFile.NoHuman

The input image has no human body. Please upload other image with single person.

Penyebab: Gambar input tidak berisi orang atau wajah tidak terdeteksi.

Solusi: Unggah foto satu orang.

400-InvalidFile.BodyProportion

The proportion of the detected person in the picture is too large or too small, please upload other image.

Penyebab: Proporsi orang dalam gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Unggah gambar yang memenuhi persyaratan proporsi orang.

400-InvalidFile.FacePose

The pose of the detected face is invalid, please upload other image with whole face and expected orientation.

Penyebab: Pose wajah dalam gambar yang diunggah tidak memenuhi persyaratan (wajah harus terlihat dengan sedikit kemiringan kepala).

Solusi: Unggah gambar yang memenuhi persyaratan.

The pose of the detected face is invalid, please upload other image with the expected oriention.

Alasan: Orientasi wajah dalam gambar yang diunggah tidak memenuhi persyaratan (wajah tidak boleh memiliki offset signifikan).

Solusi: Pastikan wajah dalam gambar tidak miring.

The pose of the detected face is invalid, please upload other image with the expected orientation.

Alasan: Pose wajah dalam gambar yang diunggah tidak memenuhi persyaratan (wajah tidak boleh memiliki offset signifikan).

Solusi: Pastikan wajah dalam gambar tidak miring.

400-InvalidFile.Resolution

The image resolution is invalid, please make sure that the largest length of image is smaller than 7000, and the smallest length of image is larger than 400.

Penyebab: Ukuran gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Resolusi gambar tidak boleh melebihi 7000×7000 dan harus minimal 400×400.

The image resolution is invalid, please make sure that the largest length of image is smaller than 4096, and the smallest length of image is larger than 224.

Penyebab: Ukuran gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Resolusi gambar harus memiliki sisi terpanjang di bawah 4096 piksel dan sisi terpendek di atas 224 piksel.

The image resolution is invalid, please make sure that the largest length of image is smaller than xxx, and the smallest length of image is larger than yyy.

Penyebab: Ukuran gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Resolusi gambar tidak boleh melebihi xxx×xxx dan harus minimal yyy×yyy.

The image resolution is invalid, please make sure that the aspect ratio is smaller than xxx, and largest length of image is smaller than yyy.

Penyebab: Ukuran gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Rasio aspek gambar harus kurang dari xxx, dan resolusi tidak boleh melebihi yyy×yyy.

Invalid video resolution. The height or width of video must be xxx ~ yyy.

Penyebab: Resolusi video tidak memenuhi persyaratan.

Solusi: Panjang sisi video harus antara xxx dan yyy.

400-InvalidFile.FPS

Invalid video FPS. The video FPS must be 15 ~ 60.

Penyebab: Laju frame video tidak memenuhi persyaratan.

Solusi: Laju frame video harus antara 15 dan 60 fps.

400-InvalidFile.Value

The value of the image is invalid, please upload other clearer image.

Penyebab: Gambar yang diunggah terlalu gelap.

Solusi: Pastikan wajah dalam gambar jelas.

400-InvalidFile.FrontBody

The pose of the detected person is invalid, please upload other image with the front view.

Penyebab: Gambar yang diunggah menunjukkan orang dari belakang.

Solusi: Pastikan orang menghadap kamera secara langsung.

400-InvalidFile.FullFace

The pose of the detected face is invalid, please upload other image with whole face.

Penyebab: Pose wajah dalam gambar yang diunggah tidak memenuhi persyaratan (wajah harus terlihat).

Solusi: Pastikan wajah dalam gambar lengkap dan tidak terhalang.

400-InvalidFile.FaceNotMatch

There are no matched face in the video with the provided reference image.

Penyebab: Pencocokan wajah antara gambar referensi dan video gagal.

Solusi: Lihat VideoRetalk Video Generation untuk detailnya.

400-InvalidFile.Content

The first frame of input video has no human body. Please choose another clip.

Penyebab: Frame pertama video harus berisi orang.

Solusi: Pilih klip video yang mencakup orang.

The human is too small in the first frame of input video. Please choose another clip.

Penyebab: Orang dalam frame pertama video terlalu kecil.

Solusi: Pilih video di mana orang menempati proporsi lebih besar dalam frame pertama.

The human is not clear in the first frame of input video. Please choose another clip.

Penyebab: Orang dalam frame pertama video tidak jelas.

Solusi: Pilih video di mana orang jelas dalam frame pertama.

The input image has no human body or multi human bodies. Please upload other image with single person.

Penyebab: Gambar input tidak berisi orang atau berisi beberapa orang.

Solusi: Unggah foto satu orang.

The input image has no human body or has unclear human body. Please upload other image.

Penyebab: Gambar input berisi tubuh manusia yang tidak lengkap atau hilang.

Solusi: Unggah gambar yang berisi tubuh manusia yang lengkap dan jelas.

The input image has multi human bodies. Please upload other image with single person.

Penyebab: Gambar input berisi beberapa orang.

Solusi: Unggah foto satu orang.

400-InvalidFile.FullBody

The human is not fullbody in the first frame of input video. Please choose another clip.

Penyebab: Orang dalam frame pertama video tidak full-body.

Solusi: Seluruh tubuh harus terlihat.

The pose of the detected person is invalid, please upload other image with whole body, or change the ratio parameter to 1:1.

Penyebab: Pose orang dalam gambar yang diunggah tidak memenuhi persyaratan.

Solusi: Unggah gambar yang memenuhi persyaratan: untuk foto profil, kepala harus sepenuhnya terlihat; untuk foto setengah tubuh, area di atas pinggul harus sepenuhnya terlihat; atau sesuaikan rasio aspek gambar ke 1:1.

400-InvalidFile.BodyPose

The pose of the detected person is invalid, please upload other image with whole body and expected orientation.

Penyebab: Pose orang tunggal tidak memenuhi persyaratan.

Solusi: Unggah gambar yang memenuhi persyaratan: bahu dan pergelangan kaki harus terlihat, tidak dari belakang, tidak duduk, dan dengan sedikit kemiringan tubuh.

400-InvalidFile.Size

Invalid file size. The video file size must be less than 200MB, and the audio file size must be less than 15MB.

Penyebab: Ukuran file tidak memenuhi persyaratan.

Solusi: File video harus lebih kecil dari 200 MB; file audio harus lebih kecil dari 15 MB.

Invalid file size, The image file size must be smaller than 5MB.

Penyebab: Ukuran file tidak memenuhi persyaratan.

Solusi: File gambar harus lebih kecil dari 5 MB.

Invalid file size. The video/audio/image file size must be less than xxxMB.

Penyebab: Ukuran file tidak memenuhi persyaratan.

Solusi: File video/audio/gambar harus lebih kecil dari batas MB yang ditentukan.

400-InvalidFile.Duration

Invalid file duration. The file duration must be xxx s ~ yyy s.

Penyebab: Durasi file tidak memenuhi persyaratan.

Solusi: Durasi file video/audio harus antara xxx dan yyy detik.

400-InvalidFile.ImageSize

The size of image is beyond limit.

Penyebab: Ukuran gambar melebihi batas.

Solusi: Rasio aspek gambar tidak boleh melebihi 2, dan sisi terpanjang tidak boleh melebihi 4096.

400-InvalidFile.AspectRatio

Invalid file ratio. The file aspect ratio (height/width) must be between 3:1 and 1:3.

Penyebab: Rasio aspek file tidak memenuhi persyaratan.

Solusi: Rasio aspek file video harus antara 3:1 dan 1:3.

Invalid file ratio. The file aspect ratio (height/width) must be between 2.0 and 0.5.

Penyebab: Rasio aspek file tidak memenuhi persyaratan.

Solusi: Rasio aspek file gambar harus antara 2.0 dan 0.5.

400-InvalidFile.Openerror

Invalid file, cannot open file as video/audio/image.

Penyebab: File tidak dapat dibuka.

Solusi: Periksa apakah file rusak atau formatnya benar.

400-InvalidFile.Template.Content

Invalid template content.

Penyebab: Templat tindakan kekurangan izin atau kontennya tidak memenuhi persyaratan.

Solusi: Periksa izin dan konten templat.

400-InvalidFile.Format

Invalid file format, the request file format is one of the following types: MP4, AVI, MOV, MP3, WAV, AAC, JPEG, JPG, PNG, BMP, and WEBP.

Penyebab: Format file tidak memenuhi persyaratan.

Solusi: Gunakan format yang didukung: video—mp4, avi, mov; audio—mp3, wav, aac; gambar—jpg, jpeg, png, bmp, webp.

400-InvalidFile.MultiHuman

The input image has multi human bodies. Please upload other image with single person.

Penyebab: Gambar input berisi beberapa orang.

Solusi: Unggah foto satu orang.

400-InvalidPerson

The input image has no human body or multi human bodies. Please upload other image with single person.

Penyebab: Gambar input tidak berisi orang atau berisi beberapa orang.

Solusi: Unggah foto satu orang.

400-InvalidParameter.DataInspection

Unable to download the media resource during the data inspection process.

Penyebab: Pengunduhan file gambar atau audio mengalami timeout.

Solusi: Jika memanggil dari luar Tiongkok, ketidakstabilan jaringan lintas batas dapat menyebabkan timeout unduhan. Simpan file di OSS domestik sebelum memanggil model. Atau, gunakan ruang penyimpanan sementara untuk mengunggah file.

400-FlowNotPublished

Flow has not published yet, please publish flow and try again.

Penyebab: Alur belum dipublikasikan.

Solusi: Publikasikan alur dan coba lagi.

400-InvalidImage.ImageSize

The size of image is beyond limit.

Penyebab: Ukuran gambar melebihi batas.

Solusi: Rasio aspek gambar tidak boleh melebihi 2, dan sisi terpanjang tidak boleh melebihi 4096.

400-InvalidImage.NoHumanFace

No human face detected.

Penyebab: Tidak ada wajah terdeteksi (hanya untuk antarmuka kueri asinkron tugas generasi).

Solusi: Unggah gambar yang berisi wajah manusia yang jelas.

400-InvalidImageResolution

The input image resolution is too large or small.

Penyebab: Resolusi gambar input terlalu besar atau terlalu kecil.

Solusi: Resolusi gambar harus minimal 256×256 piksel dan tidak lebih dari 5760×3240 piksel.

400-InvalidImageFormat

The input image is in invalid format.

Penyebab: Format gambar tidak memenuhi persyaratan.

Solusi: Gunakan gambar dalam format JPEG, PNG, JPG, BMP, atau WEBP.

400-InvalidURL

Invalid URL provided in your request.

Penyebab: URL tidak valid.

Solusi: Gunakan URL yang valid.

Required URL is missing or invalid, please check the request URL.

Penyebab: URL input tidak valid atau hilang.

Solusi: Berikan URL yang benar.

The request URL is invalid, make sure the url is correct and is an image.

Penyebab: URL input tidak valid.

Solusi: Pastikan URL benar dan mengarah ke file gambar.

The input audio is longer than xxs.

Penyebab: File audio input melebihi durasi maksimum xx detik.

Solusi: Potong file audio hingga di bawah xx detik.

File size is larger than 15MB.

Penyebab: File audio input melebihi batas 15 MB.

Solusi: Kompres file audio hingga di bawah 15 MB.

File type is not supported. Allowed types are: .wav, .mp3.

Penyebab: Format audio input tidak sesuai.

Solusi: Hanya format wav dan mp3 yang didukung.

The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP.

Penyebab: Gambar tidak dapat diakses atau format file yang diunduh tidak didukung.

Solusi: Pastikan URL dapat diakses dan format gambar adalah JPEG, JPG, PNG, BMP, atau WEBP.

400-InvalidImage.FileFormat

Invalid image type. Please ensure the uploaded file is a valid image.

Penyebab: Format file gambar tidak didukung.

Solusi: Gunakan gambar dalam format JPG, JPEG, PNG, BMP, atau WEBP.

400-InvalidURL.ConnectionRefused

Connection to xxx refused, please provide available URL.

Penyebab: Unduhan ditolak.

Solusi: Berikan URL yang dapat diakses.

400-InvalidURL.Timeout

Download xxx timeout, please check network connection.

Penyebab: Unduhan mengalami timeout.

Solusi: Periksa konektivitas jaringan.

400-BadRequestException

Invalid part type.

Penyebab: Hanya berlaku untuk skenario percakapan model Qwen-Long di mana pengguna mengunggah jenis file yang belum didukung oleh Qwen-Long.

Solusi: Unggah jenis file yang didukung oleh Qwen-Long.

400-BadRequest.EmptyInput

Required input parameter missing from request.

Penyebab: Permintaan tidak menyertakan parameter input.

Solusi: Tambahkan parameter input ke permintaan.

400-BadRequest.EmptyParameters

Required parameter "parameters" missing from request.

Penyebab: Permintaan tidak menyertakan parameter parameters.

Solusi: Tambahkan parameter parameters ke permintaan.

400-BadRequest.EmptyModel

Required parameter "model" missing from request.

Penyebab: Permintaan tidak menyediakan parameter model.

Solusi: Tambahkan parameter model ke permintaan.

400-BadRequest.IllegalInput

The input parameter requires json format.

Penyebab: Format parameter input tidak memenuhi persyaratan JSON API.

Solusi: Periksa format parameter input dan pastikan JSON-nya valid.

400-BadRequest.InputDownloadFailed

Failed to download the input file: xxx.

Penyebab: Unduhan file input gagal, kemungkinan disebabkan oleh timeout, kegagalan unduhan, atau ukuran file melebihi batas.

Solusi: Pecahkan masalah berdasarkan pesan kesalahan detail xxx.

Failed to download the input file.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, server gagal mengunduh file audio untuk kloning.

Solusi: Periksa apakah file audio dapat diunduh secara normal. Jika ya, verifikasi bahwa ukuran file tidak melebihi batas (10 MB).

400-BadRequest.UnsupportedFileFormat

File format unsupported.

Penyebab: Saat menggunakan CosyVoice voice cloning, format audio yang diunggah tidak memenuhi persyaratan model.

Solusi: Format audio harus WAV (16bit), MP3, atau M4A. Perhatikan bahwa ekstensi file saja tidak dapat diandalkan—misalnya, file dengan ekstensi .mp3 mungkin sebenarnya Opus. Gunakan alat (seperti ffprobe, mediainfo) atau perintah (seperti perintah file Linux/macOS) untuk memverifikasi format encoding audio aktual.

Input file format is not supported.

Penyebab: Format file input tidak didukung.

Solusi: Gunakan format file yang didukung.

400-BadRequest.TooLarge

Payload Too Large.

Penyebab: Ukuran file melebihi batas.

Solusi:

• Saat "purpose" adalah "file-extract", dokumen tidak boleh melebihi 150 MB dan gambar tidak boleh melebihi 20 MB.
• Saat "purpose" adalah "batch", file tidak boleh melebihi 500 MB. Pisahkan dan unggah file secara batch.

400-BadRequest.ResourceNotExist

The Required resource not exist.

Penyebab:

• Saat memanggil antarmuka pembaruan, kueri, atau penghapusan untuk CosyVoice voice cloning, timbre yang sesuai tidak ada.

400-Throttling.AllocationQuota

Your current quota is xxx

Penyebab: Jumlah timbre kloning suara CosyVoice telah mencapai batas.

Solusi: Hapus beberapa timbre.

Maximum voice storage limit exceeded, please delete existing voices.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, Anda melebihi batas timbre akun utama.

Solusi: Hapus beberapa timbre.

400-InvalidGarment

Missing clothing image.Please input at least one top garment or bottom garment image.

Penyebab: Gambar pakaian hilang.

Solusi: Berikan setidaknya satu gambar pakaian atas (top_garment_url) atau pakaian bawah (bottom_garment_url).

400-InvalidSchema

Database schema is invalid for text2sql.

Penyebab: Informasi skema database tidak disediakan.

Solusi: Masukkan informasi skema database.

400-InvalidSchemaFormat

Database schema format is invalid for text2sql.

Penyebab: Format informasi tabel input tidak valid.

Solusi: Periksa dan perbaiki format informasi tabel.

400-Audio.AudioShortError

valid audio too short!

Penyebab: Durasi audio untuk CosyVoice voice cloning terlalu pendek.

Solusi: Pertahankan durasi audio sekitar 10–15 detik. Pastikan ada ucapan berkelanjutan dengan setidaknya satu segmen lebih dari 5 detik.

400-Audio.AudioSilentError

silent audio error.

Penyebab: File audio CosyVoice voice cloning hening atau segmen tidak hening terlalu pendek.

Solusi: Pertahankan durasi audio sekitar 10–15 detik dan sertakan setidaknya satu segmen ucapan berkelanjutan lebih dari 5 detik.

400-InvalidInputLength

The image resolution is invalid, please make sure that the largest length of image is smaller than 4096, and the smallest length of image is larger than 150. and the size of image ranges from 5KB to 5MB.

Penyebab: Dimensi atau ukuran file gambar tidak memenuhi persyaratan.

Solusi: Lihat Input Image Requirements.

400-FaqRuleBlocked

Input or output data is blocked by faq rule.

Penyebab: Memicu modul intervensi aturan FAQ.

400-ClientDisconnect

Client disconnected before task finished!

Penyebab: Klien terputus sebelum tugas selesai. Kesalahan ini terjadi saat menggunakan layanan sintesis atau pengenalan suara.

Solusi: Periksa kode Anda untuk menghindari pemutusan dari server sebelum tugas selesai.

400-ServiceUnavailableError

Role must be user or assistant and Content length must be greater than 0.

Penyebab: Panjang konten input adalah 0 atau role salah.

Solusi: Pastikan panjang konten input lebih dari 0 dan format parameter (seperti role) sesuai dengan dokumentasi API.

400-IPInfringementSuspect

Input data is suspected of being involved in IP infringement.

Penyebab: Data input (seperti prompt atau gambar) diduga melanggar hak kekayaan intelektual.

Solusi: Lakukan pemeriksaan kepatuhan konten dan pastikan input tidak berisi konten yang melanggar.

400-UnsupportedOperation

The operation is unsupported on the referee object.

Penyebab: Objek terkait tidak mendukung operasi ini.

Solusi: Verifikasi bahwa objek operasi dan jenis operasi cocok.

The fine-tune job can not be deleted because it is succeeded,failed or canceled.

Penyebab: Tidak dapat menghapus pekerjaan fine-tuning karena statusnya sudah "succeeded," "failed," atau "canceled."

Solusi: Hanya pekerjaan dalam status tertentu yang dapat dihapus; jangan hapus pekerjaan dalam status terminal.

400-CustomRoleBlocked

Input or output data may contain inappropriate content with custom rule.

Penyebab: Konten permintaan atau respons gagal pemeriksaan kebijakan kustom.

Solusi: Periksa konten atau sesuaikan kebijakan kustom.

400-Audio.PreprocessError

Audio preprocess error.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, preprocessing audio yang akan dikloning gagal, kemungkinan karena: konten parameter text sangat berbeda dari transkrip audio, ucapan valid terlalu pendek, atau tidak ada suara.

Solusi: Sesuaikan konten parameter text. Jika tidak efektif, rekam ulang audio mengikuti panduan perekaman.

No segments meet minimum duration requirement

Penyebab: Saat menggunakan kloning suara Qwen-TTS, ucapan valid dalam audio yang akan dikloning terlalu pendek.

Solusi: Rekam ulang audio mengikuti panduan perekaman.

400-BadRequest.VoiceNotFound

Voice '%s' not found.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, timbre yang ditentukan dalam pemanggilan antarmuka penghapusan telah dihapus atau tidak ada.

Solusi: Verifikasi bahwa parameter voice benar.

400-Audio.DecoderError

Decoder audio file failed.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, decoding audio yang akan dikloning gagal. / Decoding file audio kloning suara CosyVoice gagal.

Solusi: Periksa apakah file audio rusak dan pastikan memenuhi persyaratan format (WAV (16bit), MP3, atau M4A untuk CosyVoice).

400-Audio.AudioRateError

File sample rate unsupported.

Penyebab: Saat menggunakan kloning suara Qwen-TTS atau CosyVoice, laju sampel audio yang akan dikloning tidak memenuhi persyaratan.

Solusi: Laju sampel harus minimal 24.000 Hz.

400-Audio.DurationLimitError

Audio duration exceeds maximum allowed limit.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, audio yang akan dikloning terlalu panjang.

Solusi: Audio tidak boleh melebihi 60 detik.

401-InvalidApiKey/invalid_api_key

Invalid API-key provided. / Incorrect API key provided.

Penyebab: Kunci API salah.

Solusi: Penyebab dan perbaikan umum:

• Membaca variabel lingkungan yang salah

  • Salah: api_key=os.getenv("sk-xxx")—sistem mencoba membaca variabel lingkungan bernama sk-xxx, bukan menggunakan sk-xxx sebagai kunci.

  • Benar:

    • Jika variabel lingkungan dikonfigurasi: Gunakan api_key=os.getenv("DASHSCOPE_API_KEY");

      Pastikan variabel lingkungan DASHSCOPE_API_KEY diatur sebelum menjalankan.

    • Jika variabel lingkungan tidak dikonfigurasi: Gunakan api_key = "sk-xxx".

      Metode ini hanya untuk debugging; jangan gunakan di produksi.

• Kesalahan pengetikan: Kunci API Alibaba Cloud Model Studio dimulai dengan sk-. Konfirmasi Anda tidak salah menggunakan kunci penyedia lain dan penyalinan tidak menyertakan spasi atau jeda baris tambahan.

• Kunci API eksklusif Paket (Paket Coding / Paket Token Team Edition): Baik Paket Coding maupun Paket Token Team Edition menyediakan Kunci API eksklusif yang dimulai dengan sk-sp- yang harus digunakan dengan Base URL eksklusifnya sendiri, dan tidak boleh dicampur dengan Kunci API/Base URL umum (pencampuran mengembalikan kesalahan autentikasi ini). Untuk Paket Coding, titik akhir eksklusifnya adalah https://coding-intl.dashscope.aliyuncs.com/v1; untuk Paket Token Team Edition, Base URL eksklusifnya ditampilkan di area Kunci API di Langganan Saya di konsol. Konfirmasi Anda memperbarui Kunci API dan Base URL. Lihat Integrating AI Tools dan Token Plan Team Edition quick start untuk detail konfigurasi.

• Ketidakcocokan wilayah: Kunci API dan Base URL berasal dari wilayah berbeda—misalnya, menggunakan Kunci API Tiongkok (Beijing) dengan Base URL Singapura. Konfirmasi Kunci API Anda berasal dari halaman wilayah Singapura, atau halaman wilayah Beijing, atau halaman wilayah AS. Base URL berdasarkan wilayah:

  Wilayah	Kompatibel OpenAI	DashScope
  Singapura	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
  Tiongkok (Beijing)	https://dashscope.aliyuncs.com/compatible-mode/v1	https://dashscope.aliyuncs.com/api/v1
  AS (Virginia)	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1

  PentingAlibaba Cloud Model Studio telah merilis domain khusus ruang kerja untuk wilayah Tiongkok (Beijing) dan Singapura. Domain khusus baru memberikan kinerja unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami merekomendasikan migrasi ke domain baru:

  • Tiongkok (Beijing): dari https://dashscope.aliyuncs.com ke https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapura: dari https://dashscope-intl.aliyuncs.com ke https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

  {WorkspaceId} adalah ID ruang kerja Anda, yang dapat ditemukan di halaman Detail Ruang Kerja di konsol Alibaba Cloud Model Studio. Domain yang ada tetap berfungsi penuh.

• Masalah kompatibilitas alat: Alat pihak ketiga tidak disesuaikan dengan benar (misalnya, ketidakstabilan plugin Dify terbaru menyebabkan kesalahan; coba instal versi plugin Qwen yang lebih lama; untuk Cline lama, pilih OpenAI-Compatible alih-alih Alibaba Qwen sebagai Penyedia API).

Jika tidak ada yang berlaku, Kunci API Anda mungkin telah dihapus; dapatkan kembali dan coba lagi.

401-NOT AUTHORIZED

Access denied: Either you are not authorized to access this workspace, or the workspace does not exist. Please: Verify the workspace configuration. Check your API endpoint settings. Ensure you are targeting the correct environment.

Penyebab:

• WorkspaceId tidak valid, atau akun saat ini bukan anggota ruang kerja.
• Atau titik akhir permintaan (titik akhir layanan) salah.

Solusi:

• Konfirmasi WorkspaceId benar dan akun adalah anggota ruang kerja sebelum memanggil API.
• Pengguna situs Tiongkok: gunakan titik akhir wilayah Tiongkok (Beijing); pengguna situs internasional: gunakan titik akhir wilayah Singapura. Saat menggunakan debugging online, konfirmasi titik akhir layanan benar.

401-invalid access token or token expired

invalid access token or token expired.

Kemungkinan penyebab: Token Plan salah menggunakan Base URL dari Coding Plan atau paket lain.

Solusi: Gunakan Base URL khusus Token Plan:

• Titik akhir kompatibel Anthropic: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
• Titik akhir kompatibel OpenAI: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

403-AccessDenied/access_denied

Current user api does not support asynchronous calls.

Penyebab: API tidak mendukung panggilan asinkron.

Solusi: Hapus header X-DashScope-Async atau atur nilainya ke disable.

current user api does not support synchronous calls.

Penyebab: API tidak mendukung panggilan sinkron.

Solusi: Atur X-DashScope-Async: enable di header permintaan.

Invalid according to Policy: Policy expired.

Penyebab: Kredensial unggah file kedaluwarsa saat mendapatkan URL publik sementara.

Solusi: Panggil ulang API kredensial unggah file untuk menghasilkan kredensial baru.

Access denied.

Penyebab: Tidak ada izin untuk mengakses model ini. Model mungkin memerlukan persetujuan, kuota gratisnya habis dan tidak mendukung bayar sesuai penggunaan (misalnya, deepseek-r1-distill-llama-70b), atau model telah ditinggalkan.

Solusi: Jika model telah ditinggalkan, konfirmasi statusnya di Model Deprecation Policy dan beralih ke salah satu model alternatif yang direkomendasikan dalam topik tersebut.

Memanggil model eksklusif Paket Token dengan Kunci API umum

Penyebab: Model eksklusif Paket Token (seperti qwen3.8-max-preview) hanya dapat dipanggil oleh pelanggan Paket Token menggunakan Kunci API eksklusif paket (dimulai dengan sk-sp-) bersama Base URL eksklusif Paket Token. Memanggil model ini dengan Kunci API umum (dimulai dengan sk-) mengembalikan kesalahan 403 access_denied.

Solusi: Di konsol Alibaba Cloud Model Studio, buka Langganan Saya dan dapatkan Kunci API eksklusif Paket Token dan Base URL eksklusif dari area Kunci API. Pastikan Anda memperbarui keduanya. Untuk detail konfigurasi, lihat Token Plan Team Edition quick start. Jika Kunci API dan Base URL tidak cocok (misalnya, Kunci API eksklusif dengan Base URL umum), kesalahan autentikasi 401 dikembalikan; lihat 401-InvalidApiKey/invalid_api_key dalam dokumen ini.

403-AccessDenied.Unpurchased

Access to model denied. Please make sure you are eligible for using the model.

Penyebab:Layanan Alibaba Cloud Model Studio belum diaktifkan.

Solusi: Ikuti langkah-langkah di bawah ini untuk mengaktifkan layanan Alibaba Cloud Model Studio.

1. Buat akun: Jika Anda belum memiliki akun Alibaba Cloud, daftar terlebih dahulu.

2. Pilih wilayah: Alibaba Cloud Model Studio mendukung beberapa wilayah dengan titik akhir, model, dan harga berbeda. Buka konsol Model Studio untuk memilih wilayah yang sesuai.

3. Lengkapi pendaftaran: Gunakan Akun Alibaba Cloud Anda untuk membuka Lengkapi pendaftaran dan berikan informasi yang diperlukan. Untuk detailnya, lihat Register an Alibaba Cloud account.

   • Untuk menggunakan layanan model di wilayah Tiongkok (Beijing) (Tiongkok daratan), gunakan Akun Alibaba Cloud Anda untuk menyelesaikan verifikasi identitas, pilih pengguna individu atau tingkatkan ke perusahaan berdasarkan situasi Anda dan klik Verifikasi Sekarang, lalu ajukan Purchase cloud resources in the Chinese mainland or use acceleration regions that include it. Untuk informasi lebih lanjut, lihat Identity Verification Overview.

     Beli layanan cloud spesifik yang diterapkan di Tiongkok daratan atau aktifkan wilayah akselerasi yang mencakup Tiongkok daratan (tergantung ketersediaan produk), setelah verifikasi identitas dan permintaan pembelian.

4. Aktifkan Alibaba Cloud Model Studio: Gunakan Akun Alibaba Cloud Anda untuk membuka Alibaba Cloud Model Studio, baca dan setujui persyaratan, dan layanan akan diaktifkan secara otomatis. Jika perjanjian layanan tidak muncul, Anda sudah diaktifkan.

403-Model.AccessDenied

Model access denied.

Penyebab: Tidak ada izin untuk memanggil model standar yang ditentukan.

Solusi:

• Memanggil model standar: Saat menggunakan kunci API sub-ruang kerja untuk memanggil model standar (misalnya, qwen-plus), sub-ruang kerja harus memiliki izin pemanggilan. Lihat Model Calling Authorization.
• Memanggil model kustom: Setelah penerapan berhasil, model kustom hanya dapat dipanggil dengan kunci API ruang kerjanya dan tidak memerlukan otorisasi pemanggilan model.

403-App.AccessDenied

App access denied.

Penyebab: Tidak ada izin untuk mengakses aplikasi atau model.

Solusi:

• Konfirmasi izin akses diberikan untuk ruang kerja dan pengguna RAM.
• Verifikasi aplikasi dipublikasikan.
• Periksa ulang ID aplikasi dan kunci API.
• Jika ini adalah kesalahan Kode Claude, gunakan Kunci API ruang kerja default.
• Jika semua di atas benar, segarkan data, publikasikan ulang, dan coba lagi, atau buat ulang agen.

403-Workspace.AccessDenied

Workspace access denied.

Penyebab: Tidak ada izin untuk mengakses aplikasi atau model di ruang kerja.

Solusi:

• Jika memanggil model sub-ruang kerja, lihat Sub-workspace Model Calling.
• Atau, gunakan kunci API akun utama, yang memiliki izin untuk semua ruang kerja.

403-Endpoint.AccessDenied

Workspace endpoint access denied.

Penyebab: Anda mungkin memanggil model yang ditinggalkan (misalnya, versi snapshot historis seperti qwen-max-2025-01-25). Setelah ditinggalkan, titik akhir tidak lagi tersedia, menyebabkan kesalahan ini.

Solusi:

• Buka Model Deprecation Mechanism untuk mengonfirmasi apakah model tersebut ditinggalkan.
• Jika ditinggalkan, beralihlah ke model penggantinya yang direkomendasikan.

403-AllocationQuota.FreeTierOnly

The free tier of the model has been exhausted. If you want to continue access the model on a paid basis, please disable the "use free tier only" mode in the management console.

Penyebab 1: Pengguna baru menghabiskan kuota gratis dan membuat permintaan.

Solusi: Lengkapi pendaftaran sebelum memanggil.

Penyebab 2: Anda mengaktifkan free quota exhaustion stop dan membuat permintaan setelah kuota gratis habis.

Kuota gratis konsol diperbarui setiap menit (segarkan secara manual).

Solusi:

• Untuk melanjutkan pemanggilan berbasis bayar, Anda dapat menonaktifkan sakelar free quota exhaustion stop kapan saja tanpa menunggu hingga kuota gratis habis. Panggilan bayar sesuai penggunaan dilanjutkan begitu dinonaktifkan.
• Jika sakelar sudah dinonaktifkan tetapi panggilan masih gagal, periksa apakah Kunci API telah berubah atau menjadi tidak valid. Coba atur ulang kunci API atau buat yang baru untuk menguji panggilan.
• Jika tidak ada catatan panggilan untuk permintaan di konsol, permintaan mungkin belum mencapai server. Periksa konfigurasi plugin klien atau koneksi jaringan Anda.
• Jika menggunakan Paket Coding, ini biasanya kesalahan konfigurasi. Paket Coding memerlukan Base URL khusus dan Kunci API. Lihat Coding Plan QuickStart untuk detailnya.

404-ModelNotFound/model_not_found

The provided model xxx is not supported by the Batch API.

Penyebab: Model tidak mendukung panggilan Batch, atau nama model salah eja.

Solusi: Lihat OpenAI compatible - Batch (file input) untuk mengonfirmasi model yang didukung dan nama yang benar.

Model can not be found. / The model xxx does not exist. / The model xxx does not exist or you do not have access to it.

Penyebab: Model tidak ada atau Anda belum mengaktifkan Alibaba Cloud Model Studio.

Solusi:

• Bandingkan dengan nama model dalam Daftar Model untuk memverifikasi input Anda (nilai parameter model).
• Buka Model Marketplace untuk mengaktifkan layanan model.
• Jika Anda memanggil model melalui titik akhir API internasional (misalnya, {WorkspaceId}.us-east-1.maas.aliyuncs.com), perhatikan bahwa model yang tersedia bervariasi berdasarkan wilayah. Sebelum memanggil dari wilayah AS, verifikasi bahwa model target tersedia di wilayah tersebut. Beberapa model memerlukan akhiran -us dalam nama model (misalnya, qwen-max-us).

Titik akhir penerapan khusus: Jika Anda mendapatkan ModelNotFound saat memanggil model melalui titik akhir penerapan khusus, periksa juga hal berikut:

• Gunakan nama penerapan: Untuk titik akhir penerapan khusus, parameter model harus diatur ke nama penerapan (kode model, terlihat di halaman Model Deployment di konsol Model Studio, dalam format mirip qwen3.5-flash-2026-02-23-xxx), bukan nama model. Memanggil titik akhir penerapan khusus dengan nama model, atau memanggil titik akhir API standar dengan nama penerapan, mengembalikan model_not_found.
• Beda antara metode panggilan: Panggilan standar menggunakan titik akhir API standar dan nama model, sedangkan panggilan penerapan khusus menggunakan URL titik akhir penerapan khusus dan nama penerapan. Kunci API untuk keduanya mungkin berbeda, jadi jangan mencampurnya. Mencampurnya menyebabkan kesalahan autentikasi invalid_api_key.

404-model_not_supported

Unsupported model xxx for OpenAI compatibility mode.

Penyebab: Model tidak mendukung akses kompatibel OpenAI.

Solusi: Gunakan metode native DashScope untuk memanggil.

404-WorkSpaceNotFound

WorkSpace can not be found.

Penyebab: Ruang kerja tidak ada.

404-NotFound

Not found!

Penyebab:

• Sumber daya untuk dikueri/dioperasikan tidak ada.

Solusi:

• Periksa apakah ID sumber daya untuk dikueri/dioperasikan salah.

Request path not found.

Penyebab: Saat menggunakan model Fun-Music, titik akhir layanan tidak ada.

Solusi: Periksa kebenaran dan karakter abnormal pada path API.

429-Throttling

Requests throttling triggered.

Penyebab: Panggilan API memicu pembatasan laju.

Solusi: Kurangi frekuensi panggilan atau coba lagi nanti.

Too many requests in route. Please try again later.

Penyebab: Terlalu banyak permintaan memicu pembatasan laju.

Solusi: Coba lagi nanti.

All models are temporarily rate-limited. Please try again in a few minutes.

Penyebab: Saat menggunakan layanan seperti Paket Coding yang memanggil beberapa model melalui klien (misalnya, Kode Claude), pesan ini dikembalikan oleh klien saat semua model yang tersedia telah memicu pembatasan laju 429. Kode kesalahan sisi server Model Studio yang mendasarinya adalah Throttling.RateQuota atau Throttling.AllocationQuota.

Solusi:

• Tunggu beberapa menit dan coba lagi. Batas laju akan diangkat secara otomatis.
• Kurangi konkurensi permintaan untuk menghindari mengirim terlalu banyak permintaan dalam waktu singkat.
• Untuk meningkatkan batas laju Anda, lihat Rate Limiting untuk meminta peningkatan kuota.

429-Throttling.RateQuota/LimitRequests/limit_requests

You have exceeded your request limit./Requests rate limit exceeded, please try again later./You exceeded your current requests list.

Penyebab: Frekuensi panggilan (RPS/RPM) memicu pembatasan laju.

Solusi: Lihat Rate Limiting untuk mengontrol frekuensi panggilan.

Catatan: Jika satu panggilan mengembalikan 429, periksa apakah header permintaan mengatur X-DashScope-Async: enable. Beberapa model (seperti qwen-image-3.0-pro) tidak mendukung panggilan asinkron; saat header ini diatur, bahkan satu permintaan mengembalikan 429. Hapus header X-DashScope-Async atau atur nilainya ke disable, lalu coba lagi dengan panggilan sinkron. Untuk informasi lebih lanjut, lihat Current user api does not support asynchronous calls. di bawah 403-AccessDenied/access_denied dalam topik ini.

429-Throttling.BurstRate/limit_burst_rate

Request rate increased too quickly. To ensure system stability, please adjust your client logic to scale requests more smoothly over time.

Penyebab: Frekuensi panggilan melonjak tiba-tiba sebelum mencapai batas laju, memicu perlindungan stabilitas sistem.

Solusi: Optimalkan logika klien untuk menggunakan strategi permintaan yang lancar (misalnya, penjadwalan seragam, backoff eksponensial, atau buffering antrian permintaan) untuk mendistribusikan permintaan secara merata dari waktu ke waktu dan menghindari lonjakan.

429-Throttling.AllocationQuota/insufficient_quota

Allocated quota exceeded, please increase your quota limit./ You exceeded your current quota, please check your plan and billing details.

Penyebab: Konsumsi token per detik atau menit (TPS/TPM) memicu pembatasan laju.

Solusi: Lihat dokumentasi Rate Limiting untuk batas model dan sesuaikan strategi pemanggilan. Jika kuota default tidak mencukupi, minta peningkatan TPM sementara di konsol Model Studio di bawah Rate Limit Increase.

Lihat FAQ untuk menghindari memicu batas laju.

Too many requests. Batch requests are being throttled due to system capacity limits. Please try again later.

Penyebab: Terlalu banyak permintaan Batch memicu pembatasan laju.

Solusi: Permintaan Anda tidak dapat diproses sekarang; coba lagi nanti.

Free allocated quota exceeded.

Penyebab: Kuota gratis kedaluwarsa atau habis, dan model tidak mendukung bayar sesuai penggunaan.

Solusi: Ganti dengan model lain—misalnya, jika kuota model Qwen Audio habis, gunakan model non-real-time (Qwen-Omni).

Maximum voice-clone voice limit exceeded.

Penyebab: Saat menggunakan kloning suara Qwen-TTS, Anda melebihi batas timbre akun utama.

Solusi: Hapus beberapa timbre.

429-CommodityNotPurchased

Commodity has not purchased yet.

Penyebab: Langganan ruang kerja belum dibeli.

Solusi: Beli layanan ruang kerja terlebih dahulu.

429-PrepaidBillOverdue

The prepaid bill is overdue.

Penyebab: Tagihan prabayar ruang kerja kedaluwarsa.

429-PostpaidBillOverdue

The postpaid bill is overdue.

Penyebab: Layanan inferensi model kedaluwarsa.

430-Audio.DecoderError

Decoder audio file failed.

Penyebab: Decoding file audio CosyVoice voice cloning gagal.

Solusi: Gunakan alat (seperti ffprobe, mediainfo) atau perintah (seperti perintah file Linux/macOS) untuk memverifikasi format encoding audio aktual.

430-Audio.FileSizeExceed

File too large

Penyebab: Ukuran file audio CosyVoice voice cloning melebihi batas.

Solusi: File audio untuk kloning suara harus di bawah 10 MB.

430-Audio.AudioRateError

File sample rate unsupported

Penyebab: Laju sampel file audio CosyVoice voice cloning tidak didukung.

Solusi: Atur laju sampel ke 16 kHz atau lebih tinggi.

430-Audio.AudioSilentError

Silent file unsupported.

Penyebab:File audio CosyVoice voice cloning hening atau segmen tidak hening terlalu pendek.

Solusi: Pertahankan durasi audio sekitar 10–15 detik dan sertakan setidaknya satu segmen ucapan berkelanjutan lebih dari 5 detik.

500-InternalError/internal_error

An internal error has occured, please try again later or contact service support.

Penyebab: Kesalahan internal.

Solusi:

• Jika menggunakan model (Qwen-Omni), gunakan output streaming.

• Jika menggunakan CosyVoice voice cloning, kemungkinan penyebabnya:

  • File audio tidak standar—misalnya, kualitas audio buruk, noise, atau fluktuasi volume. Lihat Recording Guidelines dan coba lagi.
  • URL file rekaman tidak dapat diakses. Ikuti petunjuk di CosyVoice Voice Cloning/Design API dan coba lagi.
  • File rekaman terlalu panjang. Gunakan rekaman sekitar 10–15 detik dengan setidaknya satu segmen ucapan berkelanjutan lebih dari 5 detik.

Internal server error!

Penyebab: Kesalahan algoritma internal.

Solusi: Coba lagi nanti.

audio preprocess server error

Menggunakan CosyVoice voice cloning:

• Penyebab: File audio tidak standar—misalnya, kualitas audio buruk, noise, atau fluktuasi volume.

  Solusi: Lihat Recording Guidelines dan coba lagi.

• Penyebab: URL file rekaman tidak dapat diakses,

  Solusi: Ikuti petunjuk di CosyVoice Voice Cloning/Design API dan coba lagi.

• Penyebab: File rekaman terlalu panjang.

  Solusi: Gunakan rekaman sekitar 10–15 detik dengan setidaknya satu segmen ucapan berkelanjutan lebih dari 5 detik.

request asr failed

Penyebab: Saat menggunakan CosyVoice voice cloning, file audio tidak standar—tidak memiliki ucapan valid atau audio tidak jelas dengan noise berat.

Solusi: Lihat Recording Guidelines dan coba lagi.

Remote cancelled grpc stream.

Penyebab: Timbre yang digunakan dalam sintesis suara tidak ada.

Solusi: Periksa parameter voice dan pastikan nama timbre yang valid ditentukan. Lihat Real-time Speech Synthesis (CosyVoice) untuk timbre yang tersedia.

500-InternalError.FileUpload

oss upload error.

Penyebab: Unggahan file gagal.

Solusi: Periksa konfigurasi OSS dan jaringan.

500-InternalError.Upload

Failed to upload result.

Penyebab: Unggahan hasil gagal.

Solusi: Periksa konfigurasi penyimpanan atau coba lagi nanti.

500-InternalError.Algo

inference internal error.

Penyebab: Pengecualian layanan.

Solusi: Coba lagi terlebih dahulu untuk mengesampingkan masalah sementara.

Expecting ',' delimiter: line x column xxx (char xxx)

Penyebab: Data JSON yang dihasilkan model tidak valid, mencegah pemanggilan alat.

Solusi: Beralih ke model terbaru atau optimalkan prompt dan coba lagi.

Missing Content-Length of multimodal url.

Penyebab: Header respons URL kehilangan bidang Content-Length.

Solusi: Jika tidak terselesaikan, coba tautan gambar lain.

Periksa bidang Content-Length

1. Buka browser (seperti Chrome atau Firefox).
2. Buka Developer Tools (biasanya dengan menekan F12 atau klik kanan dan pilih "Inspect").
3. Beralih ke tab Network.
4. Masukkan URL gambar di bilah alamat dan kunjungi.
5. Temukan permintaan yang sesuai dan cari di Headers > Response Headers untuk bidang Content-Length.

An error occurred in model serving, error message is: [Request rejected by inference engine!]

Penyebab: Kesalahan server backend layanan model.

Solusi: Coba lagi nanti.

An error occurred in model serving, error message is: [Cluster 'xxx' not found!]

Penyebab: Permintaan API diarahkan ke kluster layanan yang tidak tersedia. Ini biasanya terjadi karena layanan model Alibaba Cloud Model Studio belum diterapkan di wilayah yang ditentukan dalam permintaan.

Solusi: Periksa bahwa wilayah dalam Base URL permintaan atau konfigurasi SDK Anda benar. Layanan model Studio saat ini tersedia di wilayah seperti Tiongkok (Beijing), Singapura, dan AS (Virginia). Pastikan Anda memanggil wilayah tempat layanan diterapkan. Jika Anda menggunakan titik akhir tingkat ruang kerja (dalam format https://{WorkspaceId}.{region}.maas.aliyuncs.com/compatible-mode/v1), konfirmasi bahwa {region} adalah pengidentifikasi wilayah tempat layanan diaktifkan.

An internal error has occured during algorithm execution.

Penyebab: Kesalahan runtime algoritma.

Solusi: Coba lagi nanti.

Inference error: Inference error.

Penyebab: Kesalahan inferensi.

Solusi: Periksa apakah file gambar rusak atau kualitas gambar orang cukup (harus berisi wajah yang lengkap dan jelas).

Role must be in [user, assistant]

Penyebab: Saat menggunakan model Qwen-MT, array messages berisi pesan dengan peran non-user.

Solusi: Pastikan array messages hanya berisi satu elemen, yang harus merupakan pesan pengguna (User Message).

Embedding_pipeline_Error: xxx

Penyebab: Kesalahan preprocessing gambar atau video.

Solusi: Konfirmasi gambar/video yang diunggah dan kode permintaan memenuhi persyaratan, lalu coba lagi.

Receive batching backend response failed!

Penyebab: Kesalahan layanan internal.

Solusi: Coba lagi nanti.

[music]Receive batching backend response failed!

Penyebab: Saat menggunakan model Fun-Music, batas konkurensi layanan terlampaui.

Solusi: Kurangi permintaan konkuren dan coba lagi.

Other kinds of server error.

Penyebab: Saat menggunakan model Fun-Music, pengecualian sistem internal yang tidak diketahui.

Solusi: Berikan ID permintaan kepada staf teknis untuk pemecahan masalah.

An internal error has occured during execution, please try again later or contact service support. / algorithm process error. / inference error. / An internal error occurs during computation, please try this model later.

Penyebab: Kesalahan algoritma internal.

Solusi: Coba lagi nanti.

list index out of range

Penyebab: Elemen terakhir dalam array messages harus berupa Pesan Pengguna.

Solusi: Sesuaikan urutan array messages untuk memastikan elemen terakhir adalah {"role": "user", ...}.

500-InternalError.Timeout

An internal timeout error has occured during execution, please try again later or contact service support.

Penyebab: Tugas asinkron tidak mengembalikan hasil dalam 3 jam, menyebabkan timeout.

Solusi: Periksa eksekusi tugas atau hubungi dukungan.

500-SystemError

An system error has occured, please try again later.

Penyebab: Kesalahan sistem.

Solusi: Coba lagi nanti.

500-ModelServiceFailed

Failed to request model service.

Penyebab: Panggilan layanan model gagal.

Solusi: Coba lagi nanti.

500-RequestTimeOut

Request timed out, please try again later. / Response timeout! /I/O error on POST request for "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions": timeout

Penyebab:

• Timeout permintaan saat memanggil model besar; kesalahan timeout terjadi setelah 300 detik.
• Saat menggunakan pengenalan suara (Paraformer), tidak ada audio yang dikirim ke server dalam waktu lama atau diam berkepanjangan.
• Saat memanggil model generasi atau pengeditan gambar, waktu pemrosesan melebihi batas karena ukuran gambar besar atau kompleksitas tinggi.

Solusi:

• Gunakan output streaming. Lihat Streaming Output.
• Atur parameter heartbeat ke true atau akhiri tugas pengenalan tepat waktu.
• Saat memanggil model gambar, coba turunkan resolusi, sederhanakan pengeditan, atau coba lagi nanti.

500-ResponseTimeout

Response stream timeout

Penyebab: Saat menggunakan model Fun-Music, eksekusi internal mengalami timeout.

Solusi: Ulangi pemanggilan.

500-InvokePluginFailed

Failed to invoke plugin.

Penyebab: Pemanggilan plugin gagal.

Solusi: Periksa konfigurasi dan ketersediaan plugin.

500-AppProcessFailed

Failed to proceed application request.

Penyebab: Pemrosesan alur aplikasi gagal.

Solusi: Periksa konfigurasi aplikasi dan node alur.

500-RewriteFailed

Failed to rewrite content for prompt.

Penyebab: Panggilan model besar untuk penulisan ulang prompt gagal.

Solusi: Coba lagi nanti.

500-RetrivalFailed

Failed to retrieve data from documents.

Penyebab: Pengambilan dokumen gagal.

Solusi: Periksa indeks dokumen dan konfigurasi pengambilan.

500/503-ModelServingError

Too many requests. Your requests are being throttled due to system capacity limits. Please try again later.

Penyebab: Sumber daya jaringan jenuh; permintaan Anda tidak dapat diproses sementara.

Solusi: Coba lagi nanti.

503-ModelUnavailable

Model is unavailable, please try again later.

Penyebab: Model sementara tidak tersedia.

Solusi: Coba lagi nanti.

SDK Errors

error.AuthenticationError: No api key provided. You can set by dashscope.api_key = your_api_key in code, or you can set it via environment variable DASHSCOPE_API_KEY= your_api_key.

Penyebab: Kunci API tidak disediakan saat menggunakan SDK DashScope.

Solusi: Lihat Configuring API Key as Environment Variable untuk detailnya.

openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY environment variable

Penyebab: Kunci API tidak dilewatkan saat menggunakan SDK OpenAI.

Solusi:

• Melewatkan Kunci API melalui variabel lingkungan (direkomendasikan)

  Atur DASHSCOPE_API_KEY sebagai variabel lingkungan (lihat Configuring API Key as Environment Variable), lalu inisialisasi client dengan membacanya menggunakan os.getenv:

  client = OpenAI(api_key=os.getenv("DASHSCOPE_API_KEY"),...)

• Kode keras Kunci API (hanya untuk pengujian)

  Langsung lewatkan Kunci API ke parameter api_key:

  client = OpenAI(api_key="sk-...", ...)

  Catatan: Ini menimbulkan risiko keamanan; jangan gunakan di produksi.

Bad Request for url:xxx

Penyebab: Saat menggunakan library permintaan Python, menambahkan response.raise_for_status() menyebabkan kesalahan tanpa mengembalikan konten kesalahan server spesifik.

Solusi: Gunakan print(response.json()) untuk melihat respons server.

Cannot resolve symbol 'ttsv2'

Penyebab: Jika menggunakan real-time speech synthesis (CosyVoice), masalah ini muncul dari versi SDK DashScope yang usang.

Solusi: Instal SDK DashScope terbaru.

NetworkError

NoApiKeyException: Can not find api-key.

Penyebab: Konfigurasi variabel lingkungan tidak berlaku.

Solusi: Mulai ulang klien atau IDE Anda dan coba lagi. Lihat FAQ untuk skenario lainnya.

ConnectException: Failed to connect to dashscope.aliyuncs.com

Penyebab: Lingkungan jaringan lokal tidak normal.

Solusi: Periksa jaringan lokal—misalnya, akses HTTPS diblokir oleh masalah sertifikat atau pengaturan firewall salah. Coba jaringan atau server berbeda.

InputRequiredException: Parameter invalid: text is null

Penyebab: Saat menggunakan real-time speech synthesis (CosyVoice), tidak ada teks yang dikirim untuk sintesis.

Solusi: Berikan nilai ke parameter text saat memanggil API sintesis suara.

MultiModalConversation.call() missing 1 required positional argument: 'messages'

Penyebab: Versi SDK DashScope saat ini usang.

Solusi: Instal SDK DashScope terbaru.

mismatched_model

The model 'xxx' for this request does not match the rest of the batch. Each batch must contain requests for a single model.

Penyebab: Dalam satu tugas Batch, semua permintaan harus menggunakan model yang sama.

Solusi: Periksa file input Anda terhadap OpenAI compatible - Batch (file input).

duplicate_custom_id

The custom_id 'xxx' for this request is a duplicate of another request. The custom_id parameter must be unique for each request in a batch.

Penyebab: Dalam satu tugas Batch, setiap ID permintaan harus unik.

Solusi: Periksa file input Anda terhadap OpenAI compatible - Batch (file input) untuk memastikan semua ID permintaan unik.

Upload file capacity exceed limit. / Upload file number exceed limit.

Penyebab: Unggahan file gagal karena ruang penyimpanan Alibaba Cloud Model Studio di bawah akun Anda penuh atau hampir penuh.

Solusi: Hapus file yang tidak perlu melalui antarmuka OpenAI compatible - File untuk mengosongkan ruang. Penyimpanan saat ini mendukung hingga 10.000 file dengan total tidak lebih dari 100 GB.

WebSocket Errors

The decoded text message was too big for the output buffer and the endpoint does not support partial messages

Penyebab: Saat menggunakan pengenalan suara streaming (Paraformer), layanan mengembalikan hasil pengenalan yang terlalu besar.

Solusi: Kirim audio dalam segmen—sekitar 100 ms per segmen, dengan ukuran data antara 1 KB dan 16 KB.

TimeoutError: websocket connection could not established within 5s. Please check your network connection, firewall settings, or server status.

Penyebab: Jika menggunakan sintesis suara (CosyVoice), koneksi WebSocket tidak dapat dibuat dalam 5 detik.

Solusi: Periksa jaringan lokal, pengaturan firewall, atau coba jaringan atau server berbeda.

unsupported audio format:xxx

Penyebab: Saat menggunakan kloning suara CosyVoice, format audio yang diunggah tidak memenuhi persyaratan model.

Solusi: Format audio harus WAV (16bit), MP3, atau M4A. Jangan hanya mengandalkan ekstensi file; gunakan alat (seperti ffprobe, mediainfo) atau perintah untuk memverifikasi format encoding aktual.

internal unknown error

Penyebab: Format file audio kloning suara CosyVoice mungkin tidak memenuhi persyaratan.

Solusi: Format audio harus WAV (16bit), MP3, atau M4A. Gunakan alat untuk memverifikasi format encoding aktual.

Invalid backend response received (missing status name)

Penyebab: Saat menggunakan API RESTful pengenalan file rekaman Paraformer, parameter permintaan salah eja.

Solusi: Periksa kode terhadap dokumentasi API.

NO_INPUT_AUDIO_ERROR

Penyebab: Tidak ada ucapan valid yang terdeteksi.

Solusi: Jika menggunakan pengenalan suara real-time Paraformer, pecahkan masalah sebagai berikut:

1. Periksa input audio.
2. Periksa format audio (didukung: pcm, wav, mp3, opus, speex, aac, amr).

SUCCESS_WITH_NO_VALID_FRAGMENT

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, kueri hasil pengenalan berhasil, tetapi modul VAD tidak mendeteksi ucapan valid.

Solusi: Periksa apakah rekaman berisi ucapan valid. Jika semuanya diam, tidak ada hasil pengenalan adalah hal yang normal.

ASR_RESPONSE_HAVE_NO_WORDS

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, kueri hasil pengenalan berhasil, tetapi hasil akhirnya kosong.

Solusi: Periksa apakah rekaman berisi ucapan valid, atau jika ucapan valid hanya terdiri dari pengisi dan parameter disfluency_removal_enabled menyaringnya.

FILE_DOWNLOAD_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, file yang akan dikenali gagal diunduh.

Solusi: Periksa apakah path file rekaman benar dan dapat diakses melalui jaringan publik.

FILE_CHECK_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, format file salah.

Solusi: Periksa apakah file rekaman adalah format WAV atau MP3 satu trek/dua trek.

FILE_TOO_LARGE

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, file yang akan dikenali terlalu besar.

Solusi: Periksa apakah file rekaman melebihi 2 GB; jika ya, pisahkan.

FILE_NORMALIZE_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, normalisasi file gagal.

Solusi: Periksa apakah file rekaman rusak atau dapat diputar.

FILE_PARSE_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, parsing file gagal.

Solusi: Periksa apakah file rekaman rusak atau dapat diputar.

MKV_PARSE_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, parsing MKV gagal.

Solusi: Periksa apakah file rekaman rusak atau dapat diputar.

FILE_TRANS_TASK_EXPIRED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, tugas pengenalan kedaluwarsa.

Solusi: TaskId tidak ada atau telah kedaluwarsa. Kirim ulang tugas.

REQUEST_INVALID_FILE_URL_VALUE

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, parameter file_link tidak valid.

Solusi: Konfirmasi format parameter file_url benar.

CONTENT_LENGTH_CHECK_FAILED

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, pemeriksaan content-length gagal.

Solusi: Periksa bahwa content-length dalam respons HTTP sesuai dengan ukuran file aktual saat mengunduh rekaman.

FILE_404_NOT_FOUND

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, file yang akan diunduh tidak ada.

Solusi: Periksa apakah URL file benar.

FILE_403_FORBIDDEN

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, tidak ada izin untuk mengunduh rekaman.

Solusi: Periksa izin akses file.

FILE_SERVER_ERROR

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, server file tidak tersedia.

Solusi: Coba lagi nanti atau periksa status server file.

AUDIO_DURATION_TOO_LONG

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, durasi file melebihi 12 jam.

Solusi: Pisahkan audio menjadi segmen dan kirimkan beberapa tugas pengenalan. Gunakan alat seperti FFmpeg untuk memisahkan.

DECODE_ERROR

Penyebab: Jika menggunakan pengenalan file rekaman Paraformer, deteksi info file audio gagal.

Solusi: Konfirmasi tautan unduhan mengarah ke format audio yang didukung.

CLIENT_ERROR-[qwen-tts:]Engine return error code: 411

Penyebab: Saat menggunakan sintesis suara real-time Qwen-TTS dengan model qwen-tts-vc-realtime-2025-08-20, Anda menggunakan timbre default. Model ini hanya mendukung timbre hasil kloning.

Solusi: Gunakan timbre yang dihasilkan melalui kloning suara, bukan timbre default.

NO_VALID_AUDIO_ERROR

Penyebab: Saat menggunakan pengenalan suara (Paraformer), audio yang akan dikenali tidak valid.

Solusi: Periksa format audio, laju sampel, dll., untuk memastikan persyaratan terpenuhi.

InvalidParameter: task can not be null

Penyebab: Saat menggunakan API WebSocket sintesis suara CosyVoice, payload run-task atau finish-task kehilangan bidang input, atau payload continue-task kehilangan input.text.

Solusi:

1. Periksa perintah run-task: pastikan payload berisi "input": {} (objek kosong); jangan menghilangkan input.
2. Periksa perintah continue-task: pastikan payload.input berisi bidang teks yang tidak kosong.
3. Periksa perintah finish-task: pastikan payload berisi "input": {}.

close code 1007 Model not found

Penyebab: Saat memanggil model realtime (misalnya, Qwen3-Omni-Flash-Realtime) melalui protokol WebSocket, nama model dalam permintaan salah, atau layanan model tidak diaktifkan. Server menutup koneksi dengan kode tutup 1007 dan alasan Model not found.

Solusi:

• Bandingkan dengan nama model dalam Daftar Model untuk memverifikasi input Anda (nilai parameter model). Nama model realtime membawa akhiran seperti -realtime, yang tidak boleh dihilangkan atau diubah.
• Buka Model Marketplace untuk mengonfirmasi bahwa layanan model diaktifkan. Jika tidak, aktifkan dan coba lagi.

200-BailianGateway.Workspace.NotAuthorised

Penyebab: Kesalahan ini mungkin terjadi karena: (1) karakter khusus atau format tidak standar dalam URL akses menyebabkan validasi otorisasi ruang kerja gagal; (2) sub-akun RAM mengoperasikan ruang kerja tanpa izin.

Solusi: (1) Kunjungi ulang halaman utama konsol Model Studio dan navigasi ke halaman target; (2) akun utama atau akun RAM dengan izin administratif harus memberikan akses sub-akun ke ruang kerja yang sesuai.

200-BailianGateway.Team.NotAuthorised

Penyebab: Sub-akun RAM saat ini tidak memiliki izin untuk tim (organisasi) yang diaksesnya. Saat sub-akun RAM mengakses sumber daya tim (organisasi) yang tidak diotorisasinya, pemeriksaan otorisasi tingkat tim gateway gagal dan mengembalikan kesalahan ini.

Solusi: Akun utama atau akun RAM dengan izin administratif harus menambahkan sub-akun RAM ke tim (organisasi) yang sesuai dan memberikan izin yang sesuai dalam pengelolaan izin.

Coding Plan

Connection error

Penyebab: Kesalahan pengetikan Base URL atau masalah jaringan.

Solusi: Periksa ejaan Base URL dan koneksi jaringan.

hour allocated quota exceeded

Penyebab: Kuota permintaan 5 jam habis.

Solusi: Kuota diatur ulang secara otomatis setelah 5 jam.

week allocated quota exceeded

Penyebab: Kuota permintaan mingguan habis.

Solusi: Kuota diatur ulang pada pukul 00:00:00 (UTC+8) setiap Senin.

month allocated quota exceeded

Penyebab: Kuota permintaan bulanan habis.

Solusi: Kuota diatur ulang pada pukul 00:00:00 (UTC+8) pada hari langganan setiap bulan.

concurrency allocated quota exceeded

Penyebab: Permintaan konkuren saat ini melebihi batas yang dialokasikan platform secara dinamis.

Solusi: Coba lagi sebentar. Platform secara dinamis menyesuaikan batas konkurensi berdasarkan beban keseluruhan; waktu puncak mungkin memicu pembatasan ini.

usage allocated quota exceeded. please try again later.

Penyebab: Melampaui batas jumlah panggilan, Paket Coding juga mengevaluasi konsumsi sumber daya jangka pendek. Konsumsi jangka pendek yang tinggi memicu pembatasan laju sementara.

Solusi: Biasanya pulih dalam waktu satu jam. Pisahkan tugas besar menjadi tugas-tugas kecil dan kirimkan secara bertahap.