Alibaba Cloud Model Studio:Kode kesalahan

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 thinking menggunakan metode output non-streaming.

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

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 web search, tetapi parameter enable_search diatur ke true.

Solusi: Panggil model yang mendukung web search.

Current language settings are not supported!

Penyebab: Saat menggunakan model Qwen-MT, format source_lang atau target_lang salah atau tidak termasuk dalam 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 thinking 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]

Penyebab: Panjang input melebihi batas maksimum model.

Solusi:

• Jika memanggil melalui kode, pastikan jumlah total token dalam array messages tetap dalam batas maksimum token input 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 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 "Maximum Output Tokens" 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 dari 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 dari 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 Assistant Message ke array messages.

Solusi: Tambahkan respons Assistant Message pertama dari model ke array messages sebelum menambahkan Tool Message.

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 (,) atau tanda kurung yang tidak tertutup. Anda 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 usang). 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: “Please output in JSON format.”

Json mode response is not supported when enable_thinking is true

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

Solusi: Saat menggunakan structured output, atur enable_thinking ke false untuk menonaktifkan mode thinking. 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 sesuai dengan 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 thinking 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 mencampuradukkan 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 thinking, parameter result_format tidak diatur ke "message".

Solusi: Atur parameter result_format ke "message".

The audio is empty

Penyebab: Audio input terlalu pendek, sehingga menghasilkan titik sampling yang 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.

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 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 apakah struktur JSON 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.

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 karena:

• 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.

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
  Image	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	Base64-encoded
  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	Encoding 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.

url error, please check url！

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

  Solusi:

  1. Saat menggunakan model multimodal seperti qwen3.7-plus atau qwen3-vl-plus melalui DashScope: gunakan MultiModalConversation.call() atau endpoint multimodal-generation. Lihat Image and Video Understanding.

     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 endpoint 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 sudah usang: Versi SDK lama tidak dapat mengenali alamat server yang benar saat memanggil model generasi gambar/video.

  Solusi: Tingkatkan versi SDK

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:

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 referensi API WebSocket CosyVoice speech synthesis, 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 satu kali.

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 dengan 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 Tionghoa 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 bahasa Tionghoa yang didukung.

    • instruction yang didukung bervariasi tergantung timbre. Lihat CosyVoice Timbre List untuk detailnya.

Solusi:

• Periksa apakah panjang karakter instruction tidak melebihi 100.

• Konfirmasi bahwa model Anda mendukung parameter instruction.

• Saat menggunakan cosyvoice-v3-flash, pastikan instruction dalam bahasa Tionghoa 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 mencakup 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 dalam pemeriksaan kepatuhan, mungkin berisi materi yang melanggar hak cipta.

Solusi: Modifikasi lirik untuk memastikan tidak mengandung materi yang melanggar hak cipta 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 mencakup 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 thinking.

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 apakah 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 Expenses and Costs untuk memeriksa pembayaran tertunda:

• Tidak ada pembayaran tertunda: Konfirmasi bahwa Kunci API milik akun saat ini.

• Pembayaran tertunda: Isi ulang segera. Setelah mengisi ulang, pembaruan saldo sistem mungkin tertunda; tunggu sebentar sebelum mencoba lagi.

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 dicurigai 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.

400-APIConnectionError

Connection error.

Penyebab: Masalah jaringan lokal, biasanya karena proxy diaktifkan.

Solusi: Nonaktifkan atau restart 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 apakah 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 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 bukan full-body.

Solusi: Tubuh penuh 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 badan, area di atas pinggul harus sepenuhnya terlihat; atau sesuaikan rasio aspek gambar menjadi 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 salah.

400-InvalidFile.Template.Content

Invalid template content.

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

Solusi: Periksa izin dan konten template.

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-perbatasan 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 menjadi di bawah xx detik.

File size is larger than 15MB.

Penyebab: File audio input melebihi batas 15 MB.

Solusi: Kompres file audio menjadi 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 mencakup parameter input.

Solusi: Tambahkan parameter input ke permintaan.

400-BadRequest.EmptyParameters

Required parameter "parameters" missing from request.

Penyebab: Permintaan tidak mencakup 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: Pengunduhan file input gagal, kemungkinan karena 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 CosyVoice voice cloning telah mencapai batas.

Solusi: Hapus beberapa timbre.

Maximum voice storage limit exceeded, please delete existing voices.

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) dicurigai melanggar hak kekayaan intelektual.

Solusi: Lakukan pemeriksaan kepatuhan konten dan pastikan input tidak mengandung 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 tugas fine-tuning karena statusnya sudah "succeeded," "failed," atau "canceled."

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

400-CustomRoleBlocked

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

Penyebab: Konten permintaan atau respons gagal dalam 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 panggilan antarmuka penghapusan sudah 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 ketik: 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 Coding Plan: Coding Plan menyediakan Kunci API eksklusif (dimulai dengan sk-sp-) yang harus digunakan dengan endpoint API eksklusif (misalnya, https://coding-intl.dashscope.aliyuncs.com/v1), tidak seperti Kunci API umum. Konfirmasi Anda memperbarui Kunci API dan Base URL. Lihat Integrating AI Tools 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://dashscope-us.aliyuncs.com/compatible-mode/v1	https://dashscope-us.aliyuncs.com/api/v1

  Penting

  Alibaba 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 diadaptasi 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 API Provider).

Jika tidak ada yang berlaku, Kunci API Anda mungkin telah dihapus; peroleh 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 endpoint permintaan (endpoint layanan) salah.

Solusi:

• Konfirmasi WorkspaceId benar dan akun adalah anggota ruang kerja sebelum memanggil API.

• Pengguna situs Tiongkok: gunakan endpoint wilayah Tiongkok (Beijing); pengguna situs internasional: gunakan endpoint wilayah Singapura. Saat menggunakan debugging online, konfirmasi endpoint layanan benar.

  

401-invalid access token or token expired

invalid access token or token expired.

Kemungkinan penyebab: Rencana Token salah menggunakan Base URL Rencana Coding atau rencana lain.

Solusi: Gunakan Base URL eksklusif Rencana Token:

• Endpoint kompatibel Anthropic: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

• Endpoint 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, atau kuota gratisnya habis dan tidak mendukung bayar sesuai penggunaan (misalnya, deepseek-r1-distill-llama-70b).

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 berikut 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 endpoint, model, dan harga berbeda. Buka konsol Model Studio untuk memilih wilayah yang sesuai.

3. Lengkapi verifikasi identitas: Gunakan Akun Alibaba Cloud Anda untuk menyelesaikan verifikasi identitas.

   • Pilih pengguna individu atau tingkatkan ke perusahaan sesuai situasi Anda, lalu klik Verify Now.

   • Untuk menggunakan layanan model di wilayah Tiongkok (Beijing), harap lanjutkan dengan verifikasi identitas untuk 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 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 APP ID dan KUNCI API.

• Jika ini adalah kesalahan Kode Claude, gunakan Kunci API ruang kerja default.

• Jika semua di atas benar, refresh 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 sudah usang (misalnya, versi snapshot historis seperti qwen-max-2025-01-25). Setelah usang, endpoint tidak lagi tersedia, menyebabkan kesalahan ini.

Solusi:

• Buka Model Deprecation Mechanism untuk mengonfirmasi apakah model sudah usang.

• Jika sudah usang, 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: Selesaikan pendaftaran sebelum memanggil.

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

Kuota gratis konsol diperbarui setiap menit (refresh manual).

Solusi:

• Untuk membayar panggilan, tunggu hingga konsol menunjukkan kuota gratis habis, lalu nonaktifkan tombol free quota exhaustion stop.

• Jika menggunakan Coding Plan, ini biasanya kesalahan konfigurasi. Coding Plan 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.

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 yang akan dikueri/dioperasikan tidak ada.

Solusi:

• Periksa apakah ID sumber daya yang akan dikueri/dioperasikan salah.

Request path not found.

Penyebab: Saat menggunakan model Fun-Music, endpoint 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.

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.

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 mulus (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 pemicu pembatasan 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.

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:CosyVoice voice cloning file audio 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 penyebab:

  • 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: Pengunggahan file gagal.

Solusi: Periksa konfigurasi OSS dan jaringan.

500-InternalError.Upload

Failed to upload result.

Penyebab: Pengunggahan 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.

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 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 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 User Message.

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 segera.

• Saat memanggil model gambar, coba turunkan resolusi, sederhanakan edit, atau coba lagi nanti.

500-ResponseTimeout

Response stream timeout

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

Solusi: Ulangi panggilan.

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 pustaka 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 sudah usang.

Solusi: Instal SDK DashScope terbaru.

NetworkError

NoApiKeyException: Can not find api-key.

Penyebab: Konfigurasi variabel lingkungan tidak berlaku.

Solusi: Restart 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 sudah 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: Pengunggahan 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 akhir 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 trek tunggal/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 apakah content-length 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, muatan run-task atau finish-task kekurangan bidang input, atau muatan continue-task kekurangan input.text.

Solusi:

1. Periksa perintah run-task: pastikan muatan 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 muatan berisi "input": {}.

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 beranda 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.

Coding Plan

Connection error

Penyebab: Kesalahan penulisan 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: Melebihi batas jumlah panggilan, Coding Plan 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 yang lebih kecil dan kirimkan dari waktu ke waktu.