Alibaba Cloud Model Studio:Códigos de erro

Este tópico descreve as mensagens de erro comuns que você pode encontrar ao usar o Alibaba Cloud Model Studio e apresenta as respectivas soluções.

400-InvalidParameter

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

Causa: Você chamou um modelo em modo de pensamento usando um método de saída sem streaming.

Solução: Defina o parâmetro enable_thinking como false ou use o método streaming output para chamar o modelo em modo de pensamento.

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

Causa: O parâmetro thinking_budget está fora do intervalo permitido.

Solução: Consulte o comprimento máximo da cadeia de pensamento listado para o modelo na Lista de Modelos e defina este parâmetro com um valor maior que 0 e não superior a esse limite.

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

Causa: O modelo suporta apenas streaming output, mas o streaming não foi ativado durante a chamada.

Solução: Use o método streaming output para chamar o modelo.

This model does not support enable_search.

Causa: O modelo atual não suporta o recurso web search, mas o parâmetro enable_search foi definido como true.

Solução: Chame um modelo que suporte busca na web.

Current language settings are not supported!

Causa: Ao usar o modelo Qwen-MT, o formato de source_lang ou target_lang está incorreto ou não está incluído em supported languages.

Solução: Forneça o nome correto em inglês ou o código do idioma.

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

Causa: Quando o modo de pensamento está ativado, o modelo suporta apenas saída em streaming incremental, mas o parâmetro incremental_output não foi definido como true.

Solução: Defina o parâmetro incremental_output como true antes de fazer a chamada. A API retornará então o conteúdo incremental.

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

Causa: O modelo suporta apenas saída em streaming incremental, mas o parâmetro incremental_output não foi definido como true.

Solução: Defina o parâmetro incremental_output como true antes de fazer a chamada. A API retornará então o conteúdo incremental.

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

Causa: O comprimento da entrada excede o limite máximo do modelo.

Solução:

• Se estiver chamando via código, garanta que a contagem total de tokens no array messages permaneça dentro do limite máximo de tokens de entrada do modelo.
• Ao usar um cliente de chat (como Chatbox) ou o console do Alibaba Cloud Model Studio para conversas contínuas, cada solicitação inclui o histórico da conversa, o que pode facilmente exceder o limite do modelo. Se isso ocorrer, inicie uma nova conversa.

Range of max_tokens should be [1, xxx]

Causa: O parâmetro max_tokens não está dentro do intervalo [1, máximo de tokens de saída para o modelo].

Solução: Consulte o valor de "Máximo de Tokens de Saída" na documentação da Lista de Modelos para saber o limite superior de max_tokens.

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

Causa: O parâmetro temperature está fora do intervalo [0.0, 2.0).

Solução: Defina o parâmetro temperature com um número maior ou igual a 0 e menor que 2.

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

Causa: O parâmetro top_p está fora do intervalo (0.0, 1.0].

Solução: Defina o parâmetro top_p com um número maior que 0 e menor ou igual a 1.

Parameter top_k be greater than or equal to 0

Causa: O parâmetro top_k foi definido com um número menor que 0.

Solução: Defina o parâmetro top_k com um número maior ou igual a 0.

Repetition_penalty should be greater than 0.0

Causa: O parâmetro repetition_penalty foi definido com um número menor ou igual a 0.

Solução: Defina o parâmetro repetition_penalty com um número maior que 0.

Presence_penalty should be in [-2.0, 2.0]

Causa: O parâmetro presence_penalty está fora do intervalo [-2.0,2.0].

Solução: Defina o parâmetro presence_penalty dentro do intervalo [-2.0,2.0].

Range of n should be [1, 4]

Causa: O parâmetro n não está dentro do intervalo [1, 4].

Solução: Defina o parâmetro n dentro do intervalo [1, 4].

Range of seed should be [0, 9223372036854775807]

Causa: Ao usar o protocolo DashScope, o parâmetro seed não está dentro do intervalo [0, 9223372036854775807].

Solução: Defina o parâmetro seed dentro do intervalo [0, 9223372036854775807].

Request method 'GET' is not supported.

Causa: A API atual não suporta o método de requisição GET.

Solução: Consulte a referência da API e use um método de requisição suportado (como POST) para reenviar a requisição.

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

Causa: Durante a chamada de ferramentas, você não adicionou uma Mensagem do Assistente ao array messages.

Solução: Adicione a primeira resposta de Mensagem do Assistente do modelo ao array messages antes de adicionar a Mensagem da Ferramenta.

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

Causa: Uma mensagem do assistente que contém tool_calls deve ser seguida por mensagens com a função tool que respondam a cada tool_call_id. Esse erro geralmente indica que a sequência de mensagens enviada à API do Model Studio durante a chamada de ferramentas está malformada; por exemplo, uma mensagem do usuário segue diretamente uma mensagem do assistente que contém tool_calls.

Solução: Após a mensagem do assistente que contém tool_calls e antes de enviar a próxima mensagem do usuário, insira as mensagens correspondentes com a função tool. Cada uma dessas mensagens deve conter o tool_call_id correspondente e o resultado da execução dessa ferramenta. Todo tool_call_id na mensagem do assistente deve ser respondido por exatamente uma mensagem tool.

Required body invalid, please check the request body format.

Causa: O formato do corpo da requisição não atende aos requisitos da API.

Solução: Verifique o corpo da requisição para garantir que seja um JSON válido. Problemas comuns incluem vírgulas finais (,), colchetes não fechados e aspas não fechadas.

Exemplo incorreto (o campo text está sem a aspa de fechamento, portanto o corpo não é um JSON válido):

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

Exemplo correto:

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

Antes de reenviar a requisição, valide a sintaxe do corpo da requisição com um validador de JSON, como jsonlint.com. Você também pode usar o modelo grande para ajudar a corrigir o formato do corpo da requisição.

input content must be a string.

Causa: Modelos de texto simples não suportam a definição do campo content nas mensagens como um tipo não string.

Solução: Não defina content como um tipo array, como [{"type": "text","text": "Who are you?"}].

The content field is a required field.

Causa: Ao fazer uma requisição, você não especificou o parâmetro content, por exemplo: {"role": "user"}.

Solução: Especifique o parâmetro content, por exemplo: {"role": "user","content": "Who are you?"}.

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

Causa: Ao chamar um modelo de linguagem grande, você não especificou nem o parâmetro messages nem o parâmetro prompt (que está obsoleto). Se você especificou messages mas ainda recebeu um erro, o formato pode estar incorreto — por exemplo, ao usar DashScope-HTTP, messages deve ser colocado dentro de um objeto input, não no mesmo nível do parâmetro model.

Solução: Especifique o parâmetro messages. Se você já fez isso mas ainda recebe um erro, consulte a referência da API text generation para verificar seu posicionamento.

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

Causa: Ao usar structured output, o prompt não inclui a palavra-chave json.

Solução: Adicione a palavra-chave json (sem distinção entre maiúsculas e minúsculas) ao seu prompt, por exemplo: “Por favor, forneça a saída em formato JSON.”

Json mode response is not supported when enable_thinking is true

Causa: Você ativou o modo de pensamento do modelo enquanto usava structured output.

Solução: Ao usar saída estruturada, defina enable_thinking como false para desativar o modo de pensamento. Alternativamente, consulte o FAQ How to use structured output with thinking-mode models?.

Tool names are not allowed to be [search]

Causa: O nome da ferramenta não pode ser definido como search.

Solução: Defina o nome da ferramenta com um valor diferente de 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.

Causa: O parâmetro response_format especificado não está em conformidade com os requisitos.

Solução: Para usar structured output, defina o parâmetro response_format como {"type": "json_object"}.

The value of the enable_thinking parameter is restricted to True.

Causa: Para certos modelos (como qwen3-235b-a22b-thinking-2507), não é possível definir o parâmetro enable_thinking como false.

Solução:

• Se estiver chamando por meio de uma ferramenta de terceiros (como Cherry Studio), ative a opção de pensamento na caixa de entrada.
• Se estiver chamando via código, defina enable_thinking como true.

'audio' output only support with stream=true

Causa: Ao usar o modelo Qwen-Omni, você não utilizou saída em streaming, mas o modelo suporta apenas streaming.

Solução: Defina o parâmetro stream como true para ativar a saída em streaming.

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

Causa: O parâmetro tool_choice está incorreto durante o Function Calling.

Solução: Defina como "auto" (permite que o LLM escolha ferramentas autonomamente) ou "none" (força a não utilização de ferramentas).

Model not exist.

Causa: O parâmetro model é inválido ou está formatado incorretamente.

Solução:

• Verifique o formato do nome do modelo: Confirme se o parâmetro model usa capitalização correta e não contém espaços extras.
• Use o nome correto do modelo: Compare o model inserido com os nomes na Lista de Modelos para garantir que esteja correto. Não misture nomes de modelos da comunidade open source com IDs de modelos do Model Studio, como usar qwen3-235b-a22b-instruct-2507 em vez de Qwen/Qwen3-235B-A22B-Instruct-2507.

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

Causa: Ao chamar um modelo em modo de pensamento, o parâmetro result_format não foi definido como "message".

Solução: Defina o parâmetro result_format como "message".

The audio is empty

Causa: O áudio de entrada é muito curto, resultando em pontos de amostragem insuficientes.

Solução: Aumente a duração do áudio.

File parsing in progress, please try again later.

Causa: Ao usar o modelo Qwen-Long, o arquivo ainda não terminou de ser analisado.

Solução: Aguarde a conclusão da análise do arquivo antes de tentar novamente.

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.

Causa: O parâmetro stop não está em conformidade com o formato exigido: str, list[str], list[int], ou list[list[int]].

Solução: Consulte a referência da API text generation e defina o parâmetro stop corretamente.

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

Causa: Ao chamar um modelo de Embedding, o número de textos excede o limite do modelo.

Solução: Consulte as informações sobre batch size na documentação Embedding e controle o número de textos de entrada.

[] is too short

Causa: O array de mensagens de entrada está vazio.

Solução: Adicione uma mensagem antes de enviar a requisição.

The tool call is not supported.

Causa: O modelo que você está usando não suporta o parâmetro tools.

Solução: Mude para um modelo Qwen ou DeepSeek que suporte 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...)

Causa: O campo content de uma mensagem no array messages contém um item de tipo não suportado. Quando content é um array, cada elemento deve ser uma string ou um objeto válido (como {"type": "text", "text": "..."} ou {"type": "image_url", ...}). Passar um número, booleano, array aninhado ou um objeto cujo type não seja suportado aciona esse erro. O código de status HTTP correspondente é 400 e o código de erro é InternalError.Algo.InvalidParameter.

Cenário comum: Quando você usa um modelo apenas de texto (como a série de texto Qwen-Max, incluindo qwen3-max) e as messages (especialmente o histórico de conversas multi-turno) contêm itens multimodais de content, como imagens (image_url), esse erro também é acionado, pois modelos apenas de texto não aceitam entradas de imagem ou de outras modalidades. Em algumas ferramentas integradas ou agentes, esse erro pode aparecer como uma mensagem do tipo "o provedor do modelo retornou conteúdo vazio".

Solução:

• Modelos apenas de texto: Defina content como uma string em vez de um array ou qualquer outro tipo. Se o seu caso de uso exigir entrada de imagem ou outra entrada multimodal, mude para um modelo multimodal (como a série Qwen-VL ou Qwen3-VL); se precisar continuar usando um modelo apenas de texto, remova itens multimodais, como imagens (image_url), das messages e do histórico de conversas antes de fazer a chamada.
• Modelos multimodais: Cada elemento no array content deve ser um objeto válido cujo type seja um dos tipos de modalidade suportados pelo modelo, como text, image_url, video_url ou video. Não inclua números, booleanos, arrays aninhados ou elementos que não tenham type ou cujo valor de type seja inválido.

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

Causa: Os parâmetros da chamada de API são inválidos.

Solução: Verifique os parâmetros da requisição para garantir que todos os parâmetros obrigatórios foram fornecidos e estão formatados corretamente.

Quando a mensagem de erro especifica o parâmetro data_sources, geralmente significa que, ao chamar a API CreateIndex, o parâmetro obrigatório SourceType foi omitido, fazendo com que a API SubmitIndexJob subsequente falhasse. Ao criar uma base de conhecimento a partir de documentos, defina este parâmetro como DATA_CENTER_FILE; ao criar a partir de categorias, defina como DATA_CENTER_CATEGORY. Consulte a documentação CreateIndex para mais detalhes.

input must contain file_urls

Causa: Ao usar reconhecimento de fala (Paraformer) para reconhecimento de arquivos gravados, você não atribuiu um valor ao parâmetro de requisição file_urls.

Solução: Inclua o parâmetro file_urls na sua requisição e atribua um valor a ele.

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

Causa: Ao usar modelos de compreensão visual, omni-modal ou compreensão de áudio, a URL ou caminho local fornecido é inválido ou não atende aos requisitos.

Solução:

• Passando uma URL: Deve começar com http://, https:// ou data:. Se começar com data:, inclua "base64" antes dos dados codificados em Base64.

• Passando um caminho local: Deve começar com file://.

• Passando uma URL temporária:
  • Para chamadas HTTP, garanta que o cabeçalho da requisição inclua X-DashScope-OssResourceResolve: enable.
  • Para chamadas via SDK: Apenas o DashScope SDK é suportado — não use o OpenAI SDK.

Input should be a valid dictionary or instance of GPT3Message

Causa: O formato do campo messages é inválido — por exemplo, colchetes incompatíveis ou pares chave-valor ausentes.

Solução: Verifique se a estrutura JSON do campo messages está correta.

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

Causa: Ao usar um modelo de Embedding, a entrada não é nem uma string nem uma lista de strings.

Solução: Altere o formato da entrada para uma string ou uma lista de strings.

No backend server available

Causa: O service de backend do Model Studio está temporariamente indisponível. Isso pode ser causado por uma atualização de service, dimensionamento, agendamento de recursos ou uma falha transitória.

Solução:

1. Faça logon no console da Alibaba Cloud e acesse a página Expenses and Costs para confirmar que sua conta não está em atraso. Se estiver, recarregue sua conta e aguarde alguns minutos para que o pagamento tenha efeito.
2. Use curl ou ping para testar a conectividade com dashscope.aliyuncs.com.
3. Faça logon no console do Model Studio e verifique o status do service.
4. Após confirmar que sua conta e rede estão normais, aguarde alguns minutos e chame a API novamente.

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

Causa: Ao usar o modelo Qwen VL para inserir vídeo como uma lista de imagens, o número de imagens não atende aos requisitos.

Solução: Para modelos das séries Qwen3-VL e Qwen2.5-VL, forneça de 4 a 512 imagens; para outros modelos, forneça de 4 a 80 imagens. Consulte Image and Video Understanding para mais detalhes.

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

Causa: O arquivo de imagem ou vídeo local passado para um modelo multimodal (Qwen-VL, QVQ, Qwen-Omni) excede o limite de tamanho.

Solução:

• Arquivos locais: Após a codificação Base64, um único arquivo não deve exceder 10 MB.

• URLs de arquivos: Arquivos de imagem não devem exceder 10 MB; para arquivos de vídeo:

  • Qwen3-VL, qwen-vl-max: até 2 GB;
  • Série qwen-vl-plus: até 1 GB;
  • Outros modelos: até 150 MB.

Consulte How to compress images or videos to meet size requirements?

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

Causa: Ao usar Qwen-Omni ou Qwen-TTS, o parâmetro voice está incorreto.

Solução: Defina como um dos seguintes: 'Cherry', 'Serena', 'Ethan' ou 'Chelsie'.

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

Causa: As dimensões (largura e altura) da imagem passada para o modelo Qwen VL não atendem aos requisitos do modelo.

Solução: As dimensões da imagem devem satisfazer: tanto a largura quanto a altura devem ter pelo menos 10 pixels, e a proporção não deve exceder 200:1 ou 1:200.

Failed to decode the image during the data inspection.

Causa: Falha na decodificação da imagem.

Solução: Confirme se a imagem não está corrompida e se seu formato é suportado.

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.

Causa: O formato do arquivo não é suportado ou o arquivo não pode ser aberto.

Solução: Confirme se o arquivo não está corrompido, se a extensão do nome do arquivo corresponde ao formato real e se o formato é suportado.

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

Causa:

• Ao chamar o modelo, você não passou uma Mensagem do Usuário;
• Ou, ao chamar uma aplicação de workflow do Alibaba Cloud Model Studio via API, os parâmetros passados para o nó inicial devem ser enviados via parâmetro biz_params (não user_prompt_params).

Solução: Garanta que você passe uma Mensagem do Usuário para o modelo ou passe corretamente os parâmetros personalizados.

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.

Causa: O servidor não consegue baixar o arquivo de mídia da URL pública, possivelmente devido a:

• Problema de conectividade: Uso de um endereço de rede interna do Alibaba Cloud Object Storage Service.
• Latência de rede: Acesso entre regiões causando timeouts.
• Instabilidade do service: Service de armazenamento de origem lento ou inacessível.
• Bloqueio por política de segurança: O User-Agent que o servidor envia ao baixar uma URL pública contém o identificador DashScopeUserBot. A política de segurança de um servidor de terceiros pode bloquear requisições que carregam esse identificador, causando falha no download.

Solução:

• Alterar o service de armazenamento

  Use um service de armazenamento na mesma região do service de modelo. Recomendamos o uso do Alibaba Cloud Object Storage Service para gerar URLs públicas (não use endereços internos).

• Ajustar o método de transferência

  Se passar uma URL pública falhar, consulte Pass local files (Base64 encoded or file paths) e mude para o método recomendado:

  Tipo de arquivo	Especificações do arquivo	DashScope SDK (Python, Java)	Compatível com OpenAI / DashScope HTTP
  Imagem	Maior que 7 MB, mas menor que 10 MB	Passar caminho local	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Passar caminho local	Codificado em Base64
  Vídeo	Maior que 100 MB	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service
  	Maior que 7 MB, mas menor que 100 MB	Passar caminho local	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Passar caminho local	Codificado em Base64
  Áudio	Maior que 10 MB	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service
  	Maior que 7 MB, mas menor que 10 MB	Passar caminho local	Apenas URL pública; recomendamos o uso do Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Passar caminho local	Codificado em Base64

  A codificação Base64 aumenta o tamanho dos dados; o arquivo original deve ser menor que 7 MB.

  Usar Base64 ou caminhos locais evita timeouts de download no lado do servidor e melhora a estabilidade.

• PermitirDashScopeUserBot

  Se a imagem estiver hospedada em um servidor sob seu controle, permita requisições cujo User-Agent contenha DashScopeUserBot na sua política de segurança. Alternativamente, passe arquivos locais (codificados em Base64 ou caminhos de arquivo) para que o servidor não precise baixar a URL pública.

Falha ao localizar o recurso de mídia solicitado durante o processo de inspeção de dados.

Causa: A URL do recurso fornecida é inválida ou inacessível.

Solução:

• Confirme se a URL está formatada corretamente e acessível.
• Verifique se o arquivo do recurso não foi excluído ou movido.
• Certifique-se de que a URL não expirou (para URLs assinadas do OSS, verifique o período de validade).

url error, please check url！

• Causa 1: O nome do modelo não corresponde ao endpoint da API: Por exemplo, usar um endpoint multimodal para um modelo de texto simples, ou um endpoint de texto simples para um modelo multimodal.

  Solução:

  1. Ao utilizar modelos multimodais como qwen3.7-plus, qwen3-vl-plus, qwen3.8-max ou qwen3.8-flash via DashScope: use MultiModalConversation.call() ou o endpoint multimodal-generation. Consulte Image and Video Understanding. Ao mudar de um modelo de texto simples (como qwen3.7-max) para um modelo multimodal (como qwen3.8-max), altere a invocação de Generation.call() para MultiModalConversation.call(); caso contrário, a chamada retornará url error.

     Se estiver usando o framework spring-ai-alibaba, confirme se você definiu o parâmetro multimodal withMultiModel .

  2. Para modelos de texto simples como qwen3-max, qwen-plus ou deepseek-v4-pro via DashScope, utilize Generation.call() ou o endpoint text-generation. Consulte Overview.

  3. Ao usar a API de clonagem de voz do CosyVoice via DashScope: esta API inclui os parâmetros model e target_model. Defina model como voice-enrollment e target_model como o modelo específico do CosyVoice. Consulte CosyVoice Voice Cloning/Design API.

• Causa 2: A versão do SDK do DashScope está desatualizada: Versões mais antigas do SDK não conseguem reconhecer o endereço correto do servidor ao chamar modelos de geração de imagem ou vídeo.

  Solução: Upgrade the SDK version

Sem autorização para acessar o recurso de mídia durante o processo de inspeção de dados.

Causa: A URL assinada do arquivo no OSS passada durante a invocação do modelo expirou.

Solução: Acesse o arquivo dentro do período de validade da URL.

O item de conteúdo deve ser uma mensagem de uma determinada modalidade.

Causa: Ao usar o SDK do DashScope para chamar um modelo multimodal, cada elemento no array content deve ter uma chave que seja uma das seguintes: image, video, audio ou text.

Solução: Utilize o parâmetro content correto.

Arquivo de vídeo inválido.

Causa: O arquivo de vídeo fornecido é inválido.

Solução: Verifique se o arquivo de vídeo está corrompido ou se o formato está correto.

A entrada da modalidade de vídeo não atende aos requisitos porque: O arquivo de vídeo é muito longo.

Causa: A duração do vídeo excede o limite para os modelos Qwen VL ou Qwen-Omni.

Solução:

• O Qwen2.5-VL aceita vídeos com duração entre 2 segundos e 10 minutos.
• Outros modelos Qwen VL ou Qwen-Omni suportam vídeos de 2 a 40 segundos.

Campo obrigatório: xxx

Causa: Um parâmetro de entrada obrigatório está ausente.

Solução: Adicione o parâmetro ausente conforme indicado pela mensagem de erro xxx.

A solicitação está sem parâmetros obrigatórios ou em um formato incorreto; verifique os parâmetros enviados.

Causa: Parâmetros obrigatórios estão ausentes ou formatados incorretamente.

Solução: Verifique se todos os parâmetros da solicitação estão completos e formatados corretamente.

Arquivos de treinamento ausentes.

Causa: Erro de parâmetro — parâmetros ausentes ou formatação incorreta.

O estilo é inválido.

Causa: O valor do estilo está fora da enumeração permitida.

Solução: Verifique se o valor do parâmetro style está correto.

O style_level é inválido.

Causa: O valor de style_level está fora da enumeração permitida.

Solução: Consulte EMO Video Generation para obter detalhes.

parameters.video_ratio deve ser 9:16 ou 3:4.

Causa: O parâmetro video_ratio só pode ser 9:16 ou 3:4.

Solução: Defina o parâmetro video_ratio como "9:16" ou "3:4".

o parâmetro xxx é inválido!

Causa: O parâmetro de entrada excede o intervalo permitido.

Solução: Consulte Video Style Redrawing para obter detalhes.

erro de JSON de entrada.

Causa: O JSON de entrada é inválido.

Solução: Verifique se o formato JSON da solicitação está correto.

erro de leitura de imagem.

Causa: Falha ao ler a imagem.

Solução: Verifique se o arquivo de imagem está corrompido ou se o formato está correto.

os parâmetros devem estar em conformidade com a especificação: xxx.

Causa: O valor do parâmetro de entrada excede o intervalo permitido.

Solução: Verifique e corrija o valor do parâmetro conforme indicado pela mensagem de erro xxx.

Os tamanhos de person_image e coarse_image não são iguais.

Causa: A resolução de coarse_image não corresponde à de person_image.

Solução: Garanta que as resoluções de coarse_image e person_image sejam idênticas.

A solicitação está sem parâmetros obrigatórios ou os parâmetros estão fora do intervalo especificado; verifique os parâmetros enviados.

Causa: Parâmetros obrigatórios da API estão ausentes ou fora do intervalo.

Solução: Verifique e corrija os parâmetros da solicitação.

erro de formato de imagem

Causa: O formato da imagem está incorreto.

Solução: Deve ser uma URL de imagem ou uma string Base64.

Nenhuma mensagem encontrada na entrada

Causa: Os parâmetros da solicitação devem incluir um campo messages.

Solução: Consulte Qwen - Image Editing para obter detalhes.

Formato de imagem inválido ou arquivo corrompido

Causa: O formato da imagem de entrada está incorreto ou o arquivo está corrompido.

Solução: Verifique se o arquivo pode ser aberto e baixado normalmente, garantindo que esteja completo e em um formato suportado.

falha ao baixar imagem

Causa: Não foi possível baixar a imagem.

Solução: Verifique se o arquivo pode ser baixado normalmente.

messages length only support 1

Causa: O comprimento do array messages suporta apenas 1.

Solução: Apenas uma mensagem de conversa pode ser passada. Consulte Qwen - Image Editing para obter detalhes.

content length only support 2

Causa: O comprimento do array content suporta apenas 2.

Solução: Somente um texto e uma imagem podem ser passados. Consulte Qwen - Image Editing para obter detalhes.

falta de imagem ou texto

Causa: Os parâmetros da solicitação estão sem o campo de imagem ou texto.

Solução: Consulte Qwen - Image Editing para obter detalhes.

num_images_per_prompt deve ser 1.

Causa: O parâmetro da solicitação é inválido; o parâmetro n (número de imagens a gerar) só pode ser definido como 1.

Solução: Defina o valor do parâmetro n como 1.

Formato dos arquivos de entrada não suportado.

Causa: O formato de áudio ou imagem não atende aos requisitos.

Solução: Formatos de áudio suportados: mp3, wav, aac; formatos de imagem suportados: jpg, jpeg, png, bmp, webp. Consulte LivePortrait Video Generation para obter detalhes.

Falha ao baixar arquivos de entrada.

Causa: Falha no download do arquivo de entrada.

Solução: Verifique se a URL do arquivo está acessível e se a rede está estável.

erro de download do OSS.

Causa: Falha no download da imagem de entrada.

Solução: Verifique se o link do OSS para a imagem está correto e acessível.

O conteúdo da imagem não está em conformidade com a verificação de rede segura.

Causa: O conteúdo da imagem viola as políticas de conformidade.

Solução: Substitua a imagem por uma que esteja em conformidade com as políticas de Moderação de Conteúdo.

erro de leitura de vídeo.

Causa: Falha ao ler o vídeo.

Solução: Verifique se o arquivo de vídeo está corrompido ou se o formato não é suportado.

o tamanho da imagem de entrada é muito pequeno ou muito grande.

Causa: As dimensões da imagem de entrada são muito pequenas ou muito grandes.

Solução: Ajuste as dimensões da imagem para atender aos requisitos da API.

O parâmetro da solicitação é inválido; verifique o parâmetro da solicitação.

Causa: Este é um erro genérico que ocorre em vários cenários: o parâmetro clothes_type está em desconformidade (OutfitAnyone - Segmentação de Imagem) ou o parâmetro de proporção está em desconformidade.

Solução: Consulte OutfitAnyone - Image Segmentation para obter detalhes. Para o parâmetro de proporção: As opções válidas são "1:1" ou "3:4".

O tipo ou valor de {parameter} está fora da definição.

Causa: O tipo ou valor do parâmetro não atende aos requisitos.

Solução: Consulte LivePortrait Video Generation para obter detalhes.

tempo limite da solicitação após 23 segundos.

Causa: Nenhum dado foi enviado para o service por mais de 23 segundos. Este erro ocorre ao usar speech recognition (Paraformer) e real-time speech synthesis (CosyVoice).

Solução: Investigue o motivo pelo qual nenhum dado foi enviado ao servidor por um período prolongado. Se nenhuma mensagem for enviada ao servidor por mais de 23 segundos, encerre a tarefa imediatamente.

Garanta que o texto de entrada seja válido.

Causa: Se você estiver usando real-time speech synthesis (CosyVoice), este erro geralmente ocorre porque nenhum texto foi enviado para síntese. As possíveis causas incluem: parâmetro ausente (nenhum valor atribuído ao parâmetro text) ou exceções de código (falha na atribuição a text).

Solução: Depure seu código para garantir que o parâmetro text seja atribuído e enviado corretamente.

Parâmetro obrigatório 'xxx' ausente! Siga o protocolo!

Exemplos de erro:

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

Causa:

1. O formato JSON do evento WebSocket está incorreto (causa geral).

   Ao chamar modelos usando o protocolo WebSocket, o formato JSON enviado é inválido. Problemas comuns incluem:

   • Aninhamento JSON incorreto — os parâmetros não estão colocados no nível hierárquico correto.
   • Nome do parâmetro escrito incorretamente — por exemplo, task_group escrito como taskgroup.
   • O valor do parâmetro está vazio ou não foi atribuído corretamente.

2. O método call() não foi reinvocado após stop() (cenário específico).

   Isso se aplica apenas ao: DashScope Java SDK para Fun-ASR ou reconhecimento de fala em tempo real Paraformer.

   Após chamar o método stop() para encerrar o reconhecimento, você não chamou novamente o método call() antes de enviar mais dados, causando um estado de sessão inválido e acionando este erro.

   Diferença entre usuários do SDK e usuários do WebSocket: "Missing required parameter" é um erro de nível de protocolo retornado pelo servidor e aparece apenas ao usar o protocolo WebSocket diretamente. Se você usar a classe Recognition do DashScope Java SDK, o SDK intercepta essa operação no lado do cliente e lança uma exceção "Invalid state" ("Expected recognition state should be started, but current state is idle") em vez de retornar o erro "Missing required parameter".

Solução:

1. Para a causa 1, verifique o formato JSON e os parâmetros.
2. Para a causa 2, garanta que, após cada chamada a stop(), você chame novamente o método call() antes da próxima rodada de reconhecimento. Se estiver usando o DashScope Java SDK, fique atento à exceção "Invalid state" no lado do cliente; se estiver usando o protocolo WebSocket diretamente, você receberá o erro "Missing required parameter".

[tts:]Engine return error code: 418

Causa: Ao usar real-time speech synthesis (CosyVoice), o parâmetro da solicitação voice (timbre) está incorreto, ou as versões de model e voice não correspondem.

Solução:

1. Verifique a atribuição do parâmetro voice:

   • Se estiver usando timbres padrão, verifique a seção "parâmetro voice" em Python SDK.
   • Se estiver usando timbres clonados, use CosyVoice Voice Cloning/Design API para confirmar se o status do timbre é "OK" e se o timbre pertence à mesma conta que está fazendo a chamada.

2. Verifique a compatibilidade de versões: modelos v2 só podem usar timbres v2; modelos v1 só podem usar timbres v1. Não misture versões.

Request voice is invalid!

Causa: Se você estiver usando real-time speech synthesis (CosyVoice), este erro geralmente ocorre porque nenhum timbre foi definido.

Solução: Verifique se o parâmetro voice tem um valor atribuído. Se estiver usando WebSocket API reference, configure os parâmetros no formato JSON correto, conforme especificado na documentação da API.

ref_images_url e obj_or_bg devem ter o mesmo comprimento.

Causa: Ao usar o recurso de referência de múltiplas imagens em Wanxiang - Video Editing (2.1), os comprimentos dos arrays ref_images_url e obj_or_bg não coincidem.

Solução: Garanta que os comprimentos dos arrays ref_images_url e obj_or_bg sejam idênticos.

verifique o estilo dos dados de entrada.

Causa: Os parâmetros de entrada não atendem aos requisitos.

Solução: Verifique e corrija os parâmetros de entrada.

Erro durante o pré-processamento do modelo.

Causa: O campo content foi passado em um formato incorreto.

Solução:

• Se a chamada for feita via código, não defina content como um tipo array, como [{"type": "text", "text": "Who are you?"}].

O tamanho da imagem não é suportado para inspeção de dados.

Causa:

• As dimensões (largura e altura) da imagem enviada ao modelo Qwen VL não atendem aos requisitos do modelo.
• O tamanho da imagem de saída excede o limite de 10 MB.

Solução:

• As dimensões da imagem devem satisfazer:

  • Tanto a largura quanto a altura devem ter no mínimo 10 pixels.
  • A proporção não deve exceder 200:1 ou 1:200.

• Ajuste os parâmetros das imagens geradas.

Content-Type incorreto na URL multimodal

Causa: O campo Content-Type no cabeçalho de resposta da URL está incorreto.

Tipos de conteúdo suportados pelos modelos Qwen VL: image/bmp, image/icns, image/x-icon, image/jpeg, image/jp2, image/png, image/sgi, image/tiff, image/webp. Consulte Image formats supported by Qwen VL models para mais detalhes.

Solução:

Verifique o campo Content-Type

1. Abra um navegador (como Chrome ou Firefox).
2. Abra as Ferramentas de Desenvolvedor (geralmente pressionando F12 ou clicando com o botão direito e selecionando "Inspect").
3. Mude para a aba Network.
4. Insira a URL da imagem na barra de endereços e acesse-a.
5. Localize a requisição correspondente e procure em Headers > Response Headers pelo campo Content-Type.

Campo obrigatório: image_url

Causa: Parâmetro de entrada image_url ausente.

Solução: Consulte Emoji Video Generation e forneça o parâmetro image_url.

Campo obrigatório: driven_id

Causa: Parâmetro de entrada driven_id ausente.

Solução: Consulte Emoji Video Generation e forneça o parâmetro driven_id.

ext_bbox inválido

Causa: O parâmetro de entrada ext_bbox é inválido.

Solução: Consulte Emoji Video Generation e forneça o ext_bbox correto.

Driven não existe: driven_id

Causa: O driven_id fornecido não existe.

Solução: Consulte Emoji Video Generation e forneça o driven_id correto.

Limite de requisição de texto violado, esperado 1.

Causa: Ao chamar a síntese de fala CosyVoice WebSocket API reference, você definiu enable_ssml como true e enviou a instrução continue-task múltiplas vezes.

Solução: Quando enable_ssml estiver definido como true, envie a instrução continue-task apenas uma vez.

Texto SSML não é suportado no momento!

Causa: Ao usar a síntese de fala CosyVoice, o modelo ou timbre atual não suporta SSML, ou a funcionalidade SSML não está ativada corretamente.

Solução: Solucione o problema conforme Limits and Constraints.

[tts:]Engine return error code: 428

Causa: O parâmetro instruction da síntese de fala CosyVoice foi usado incorretamente. Os problemas específicos podem incluir:

• Comprimento excedido: instruction não pode exceder 100 caracteres (caracteres chineses contam como 2 caracteres; outros como 1).

• Erro de formato ou idioma: Apenas os seguintes modelos suportam instruction, com regras diferentes:

  • cosyvoice-v3.5-flash, cosyvoice-v3.5-plus: instruções de forma livre permitidas (ex.: emoção, velocidade).

  • cosyvoice-v3-flash:

    • Deve seguir um formato fixo.
    • Apenas instruction em chinês é suportado.
    • As instruction suportadas variam conforme o timbre. Consulte CosyVoice Timbre List para detalhes.

Solução:

• Verifique se o comprimento de caracteres de instruction não excede 100.
• Confirme se o seu modelo suporta o parâmetro instruction.
• Ao usar cosyvoice-v3-flash, garanta que instruction esteja em chinês e siga o formato fixo para o timbre correspondente.

Pelo menos um entre 'lyrics' ou 'prompt' deve ser fornecido.

Causa: Ao usar o modelo Fun-Music, a requisição não incluiu o parâmetro lyrics ou prompt.

Solução: Inclua pelo menos um dos parâmetros lyrics ou prompt na requisição.

O conteúdo da letra é ilegal e não pode ser usado para geração musical.

Causa: Ao usar o modelo Fun-Music, o conteúdo da letra falhou nas verificações de conformidade, possivelmente contendo material infrator.

Solução: Modifique a letra para garantir que não contenha conteúdo infrator ou não conforme e tente novamente.

400-invalid_request_error-invalid_value

-1 é menor que o mínimo de 0 - 'seed'/'seed' deve ser Integer

Causa: Ao usar o protocolo compatível com OpenAI, o parâmetro seed não está dentro do intervalo [0, 2³¹-1].

Solução: Defina o parâmetro seed dentro do intervalo [0, 2³¹-1].

400-invalid_request_error

você deve fornecer um parâmetro model.

Causa: A requisição não incluiu o parâmetro model.

Solução: Adicione o parâmetro model à requisição.

400-InvalidParameter.NotSupportEnableThinking

O modelo xxx não suporta enable_thinking.

Causa: O modelo atual não suporta o parâmetro enable_thinking.

Solução: Remova o parâmetro enable_thinking da requisição ou use um modelo que suporte o modo de pensamento.

400-invalid_value

A voz solicitada 'xxx' não é suportada.

Causa: Durante a síntese de fala em tempo real do Qwen-TTS, o timbre selecionado foi gerado usando clonagem de voz do Qwen-TTS, mas os modelos utilizados são diferentes.

Solução: Verifique se o parâmetro target_model usado durante a clonagem de voz corresponde ao parâmetro model usado durante a síntese de fala.

400-Arrearage

Acesso negado, certifique-se de que sua conta está regularizada.

Causa: A conta Alibaba Cloud associada à API Key possui pagamentos pendentes, causando a negação de acesso.

Solução: Acesse Expenses and Costs para verificar se há pagamentos pendentes:

• Sem pagamentos pendentes: Confirme se a API Key pertence à conta atual. Se sua conta não estiver inadimplente, ela pode estar anormal. Para detalhes, entre em contato com o suporte para solução de problemas.
• Pagamento pendente: Recarregue prontamente. Após a recarga, a atualização do saldo do sistema pode sofrer atrasos; aguarde um momento antes de tentar novamente.

O provedor da API retornou um erro de faturamento — sua chave de API ficou sem créditos ou tem saldo insuficiente. Verifique o painel de faturamento do seu provedor e recarregue ou mude para uma chave de API diferente.

Causa: Ao chamar o Model Studio através de um cliente de terceiros como o OpenClaw, se a conta subjacente tiver pagamentos pendentes ou saldo insuficiente, o cliente agrega o erro de faturamento do servidor nesta mensagem. O código de erro subjacente do servidor Model Studio é Arrearage (ou seja, a mensagem Acesso negado, certifique-se de que sua conta está regularizada. acima). Não se trata de um problema de faturamento do próprio cliente.

Solução: Acesse Expenses and Costs para verificar pagamentos pendentes: se houver pagamento pendente, recarregue prontamente (a atualização do saldo do sistema pode demorar após a recarga, então aguarde um momento antes de tentar novamente); se não houver pagamento pendente, confirme se a API Key utilizada pertence à conta atual.

isv.OUT_OF_SERVICE

Causa: O saldo da conta Alibaba Cloud é insuficiente, portanto o service foi suspenso.

Solução: Recarregue sua conta Alibaba Cloud. O service é retomado automaticamente assim que o saldo for suficiente.

400-DataInspectionFailed/data_inspection_failed

Os dados de entrada ou saída podem conter conteúdo inapropriado. / Os dados de entrada podem conter conteúdo inapropriado. / Os dados de saída podem conter conteúdo inapropriado.

Causa: A entrada ou saída contém conteúdo suspeito sensível bloqueado pela Green Net.

Solução: Modifique o conteúdo de entrada e tente novamente.

Os dados de entrada xxx podem conter conteúdo inapropriado.

Causa: Os dados de entrada (como prompts ou imagens) podem conter conteúdo sensível. Solução: Realize verificações de conformidade de conteúdo e modifique a entrada antes de tentar novamente.

O Qwen rejeitou a imagem de entrada antes da inferência do modelo; nenhum resultado real de anúncio/pornografia/OCR foi produzido.

Causa: Antes de a imagem de entrada entrar na inferência do modelo, ela foi sinalizada pela verificação prévia de segurança de conteúdo (Green Net) como suspeita de conter conteúdo sensível ou não conforme e, portanto, foi bloqueada. O modelo não executou inferência na imagem, logo nenhum resultado de reconhecimento, OCR ou análise é retornado. Esta é uma verificação de conformidade de conteúdo pré-inferência para imagens de entrada multimodais e pertence ao mesmo mecanismo de segurança de conteúdo que o bloqueio da Green Net descrito acima.

Solução: Substitua ou modifique a imagem de entrada e tente novamente. Se a imagem for confirmada como conforme, mas continuar sendo bloqueada consistentemente, abra um ticket para verificação adicional.

APIConnectionError (erro de rede no lado do cliente, nenhum status HTTP retornado)

Erro de conexão.

Causa: Problema de rede local, geralmente devido a um proxy ativado.

Solução: Desative ou reinicie o proxy.

400-InvalidFile.DownloadFailed

O arquivo de áudio não pode ser baixado.

Causa: Ao usar speech recognition (Paraformer) para reconhecimento de arquivos gravados, o download do arquivo a ser reconhecido falhou.

Solução: Verifique se a URL do arquivo de áudio é acessível via rede pública.

400-InvalidFile.AudioLengthError

A duração do áudio deve estar entre 1s e 300s.

Causa: A duração do áudio não atende aos requisitos.

Solução: Garanta que a duração do áudio esteja dentro do intervalo [1, 300] segundos.

A duração do áudio deve estar entre 1s e 180s.

Causa: A duração do áudio não atende aos requisitos.

Solução: Garanta que a duração do áudio esteja dentro do intervalo [1, 180] segundos.

400-InvalidFile.NoHuman

A imagem de entrada não contém corpo humano. Envie outra imagem com uma única pessoa.

Causa: A imagem de entrada não contém pessoa ou nenhum rosto foi detectado.

Solução: Envie uma foto de uma única pessoa.

400-InvalidFile.BodyProportion

A proporção da pessoa detectada na imagem é muito grande ou muito pequena, envie outra imagem.

Causa: A proporção da pessoa na imagem enviada não atende aos requisitos.

Solução: Envie uma imagem que atenda aos requisitos de proporção da pessoa.

400-InvalidFile.FacePose

A pose do rosto detectado é inválida, envie outra imagem com o rosto completo e a orientação esperada.

Causa: A pose facial na imagem enviada não atende aos requisitos (o rosto deve estar visível com inclinação mínima da cabeça).

Solução: Envie uma imagem que atenda aos requisitos.

A pose do rosto detectado é inválida, envie outra imagem com a orientação esperada.

Motivo: A orientação facial na imagem enviada não atende aos requisitos (o rosto não deve ter um desvio significativo).

Solução: Garanta que o rosto na imagem não esteja inclinado.

A pose do rosto detectado é inválida, envie outra imagem com a orientação esperada.

Motivo: A pose facial na imagem enviada não atende aos requisitos (o rosto não deve ter um desvio significativo).

Solução: Garanta que o rosto na imagem não esteja inclinado.

400-InvalidFile.Resolution

A resolução da imagem é inválida, certifique-se de que o maior lado da imagem seja menor que 7000 e o menor lado seja maior que 400.

Causa: O tamanho da imagem enviada não atende aos requisitos.

Solução: A resolução da imagem não deve exceder 7000×7000 e deve ser de pelo menos 400×400.

A resolução da imagem é inválida, certifique-se de que o maior lado da imagem seja menor que 4096 e o menor lado seja maior que 224.

Causa: O tamanho da imagem enviada não atende aos requisitos.

Solução: A resolução da imagem deve ter o lado mais longo abaixo de 4096 pixels e o lado mais curto acima de 224 pixels.

A resolução da imagem é inválida, certifique-se de que o maior lado da imagem seja menor que xxx e o menor lado seja maior que yyy.

Causa: O tamanho da imagem enviada não atende aos requisitos.

Solução: A resolução da imagem não deve exceder xxx×xxx e deve ser de pelo menos yyy×yyy.

A resolução da imagem é inválida, certifique-se de que a proporção seja menor que xxx e o maior lado da imagem seja menor que yyy.

Causa: O tamanho da imagem enviada não atende aos requisitos.

Solução: A proporção da imagem deve ser menor que xxx e a resolução não deve exceder yyy×yyy.

Resolução de vídeo inválida. A altura ou largura do vídeo deve ser xxx ~ yyy.

Causa: A resolução do vídeo não atende aos requisitos.

Solução: O lado do vídeo deve estar entre xxx e yyy.

400-InvalidFile.FPS

FPS de vídeo inválido. O FPS do vídeo deve ser 15 ~ 60.

Causa: A taxa de quadros do vídeo não atende aos requisitos.

Solução: A taxa de quadros do vídeo deve estar entre 15 e 60 fps.

400-InvalidFile.Value

O valor da imagem é inválido, envie outra imagem mais nítida.

Causa: A imagem enviada está muito escura.

Solução: Garanta que o rosto na imagem esteja nítido.

400-InvalidFile.FrontBody

A pose da pessoa detectada é inválida, envie outra imagem com visão frontal.

Causa: A imagem enviada mostra a pessoa de costas.

Solução: Garanta que a pessoa esteja voltada diretamente para a câmera.

400-InvalidFile.FullFace

A pose do rosto detectado é inválida, envie outra imagem com o rosto completo.

Causa: A pose facial na imagem enviada não atende aos requisitos (o rosto deve estar visível).

Solução: Garanta que o rosto na imagem esteja completo e desobstruído.

400-InvalidFile.FaceNotMatch

Não há rosto correspondente no vídeo com a imagem de referência fornecida.

Causa: Falha na correspondência facial entre a imagem de referência e o vídeo.

Solução: Consulte VideoRetalk Video Generation para detalhes.

400-InvalidFile.Content

O primeiro quadro do vídeo de entrada não contém corpo humano. Escolha outro clipe.

Causa: O primeiro quadro do vídeo deve conter uma pessoa.

Solução: Escolha um clipe de vídeo que inclua uma pessoa.

A pessoa está muito pequena no primeiro quadro do vídeo de entrada. Escolha outro clipe.

Causa: A pessoa no primeiro quadro do vídeo é muito pequena.

Solução: Escolha um vídeo onde a pessoa ocupe uma proporção maior no primeiro quadro.

A pessoa não está nítida no primeiro quadro do vídeo de entrada. Escolha outro clipe.

Causa: A pessoa no primeiro quadro do vídeo não está nítida.

Solução: Escolha um vídeo onde a pessoa esteja nítida no primeiro quadro.

A imagem de entrada não contém corpo humano ou contém múltiplos corpos humanos. Envie outra imagem com uma única pessoa.

Causa: A imagem de entrada não contém pessoa ou contém várias pessoas.

Solução: Envie uma foto de uma única pessoa.

A imagem de entrada não contém corpo humano ou contém corpo humano pouco nítido. Envie outra imagem.

Causa: A imagem de entrada contém um corpo humano incompleto ou ausente.

Solução: Envie uma imagem contendo um corpo humano completo e nítido.

A imagem de entrada contém múltiplos corpos humanos. Envie outra imagem com uma única pessoa.

Causa: A imagem de entrada contém várias pessoas.

Solução: Envie uma foto de uma única pessoa.

400-InvalidFile.FullBody

A pessoa não está de corpo inteiro no primeiro quadro do vídeo de entrada. Escolha outro clipe.

Causa: A pessoa no primeiro quadro do vídeo não está de corpo inteiro.

Solução: O corpo inteiro deve estar visível.

A pose da pessoa detectada é inválida, envie outra imagem com o corpo inteiro ou altere o parâmetro de proporção para 1:1.

Causa: A pose da pessoa na imagem enviada não atende aos requisitos.

Solução: Envie uma imagem que atenda aos requisitos: para fotos de perfil, a cabeça deve estar totalmente visível; para fotos de meio corpo, a área acima dos quadris deve estar totalmente visível; ou ajuste a proporção da imagem para 1:1.

400-InvalidFile.BodyPose

A pose da pessoa detectada é inválida, envie outra imagem com o corpo inteiro e a orientação esperada.

Causa: A pose da pessoa única não atende aos requisitos.

Solução: Envie uma imagem que atenda aos requisitos: ombros e tornozelos devem estar visíveis, não pode ser de costas, nem sentado, e com inclinação corporal mínima.

400-InvalidFile.Size

Tamanho de arquivo inválido. O arquivo de vídeo deve ser menor que 200MB e o arquivo de áudio deve ser menor que 15MB.

Causa: O tamanho do arquivo não atende aos requisitos.

Solução: Arquivos de vídeo devem ser menores que 200 MB; arquivos de áudio devem ser menores que 15 MB.

Tamanho de arquivo inválido. O arquivo de imagem deve ser menor que 5MB.

Causa: O tamanho do arquivo não atende aos requisitos.

Solução: Arquivos de imagem devem ser menores que 5 MB.

Tamanho de arquivo inválido. O arquivo de vídeo/áudio/imagem deve ser menor que xxxMB.

Causa: O tamanho do arquivo não atende aos requisitos.

Solução: Arquivos de vídeo/áudio/imagem devem ser menores que o limite especificado em MB.

400-InvalidFile.Duration

Duração de arquivo inválida. A duração do arquivo deve ser xxx s ~ yyy s.

Causa: A duração do arquivo não atende aos requisitos.

Solução: A duração do arquivo de vídeo/áudio deve estar entre xxx e yyy segundos.

400-InvalidFile.ImageSize

O tamanho da imagem está além do limite.

Causa: O tamanho da imagem excede o limite.

Solução: A proporção da imagem não deve exceder 2 e o lado mais longo não deve exceder 4096.

400-InvalidFile.AspectRatio

Proporção de arquivo inválida. A proporção do arquivo (altura/largura) deve estar entre 3:1 e 1:3.

Causa: A proporção do arquivo não atende aos requisitos.

Solução: A proporção do arquivo de vídeo deve estar entre 3:1 e 1:3.

Proporção de arquivo inválida. A proporção do arquivo (altura/largura) deve estar entre 2.0 e 0.5.

Causa: A proporção do arquivo não atende aos requisitos.

Solução: A proporção do arquivo de imagem deve estar entre 2.0 e 0.5.

400-InvalidFile.Openerror

Arquivo inválido, não é possível abrir o arquivo como vídeo/áudio/imagem.

Causa: O arquivo não pode ser aberto.

Solução: Verifique se o arquivo está corrompido ou se o formato está correto.

400-InvalidFile.Template.Content

Conteúdo de modelo inválido.

Causa: O modelo de ação não tem permissões ou o conteúdo não atende aos requisitos.

Solução: Verifique as permissões e o conteúdo do modelo.

400-InvalidFile.Format

Formato de arquivo inválido, o formato do arquivo da requisição deve ser um dos seguintes tipos: MP4, AVI, MOV, MP3, WAV, AAC, JPEG, JPG, PNG, BMP e WEBP.

Causa: O formato do arquivo não atende aos requisitos.

Solução: Use formatos suportados: vídeo — mp4, avi, mov; áudio — mp3, wav, aac; imagem — jpg, jpeg, png, bmp, webp.

400-InvalidFile.MultiHuman

A imagem de entrada contém múltiplos corpos humanos. Envie outra imagem com uma única pessoa.

Causa: A imagem de entrada contém várias pessoas.

Solução: Envie uma foto de uma única pessoa.

400-InvalidPerson

A imagem de entrada não contém corpo humano ou contém múltiplos corpos humanos. Envie outra imagem com uma única pessoa.

Causa: A imagem de entrada não contém pessoa ou contém várias pessoas.

Solução: Envie uma foto de uma única pessoa.

400-InvalidParameter.DataInspection

Não foi possível baixar o recurso de mídia durante o processo de inspeção de dados.

Causa: Timeout ao baixar arquivos de imagem ou áudio.

Solução: Se a chamada for feita fora da China, a instabilidade da rede transfronteiriça pode causar timeouts de download. Armazene arquivos no OSS doméstico antes de chamar o modelo. Alternativamente, use o temporary storage space para enviar arquivos.

400-FlowNotPublished

O fluxo ainda não foi publicado, publique o fluxo e tente novamente.

Causa: O fluxo não está publicado.

Solução: Publique o fluxo e tente novamente.

400-InvalidImage.ImageSize

O tamanho da imagem está além do limite.

Causa: O tamanho da imagem excede o limite.

Solução: A proporção da imagem não deve exceder 2 e o lado mais longo não deve exceder 4096.

400-InvalidImage.NoHumanFace

Nenhum rosto humano detectado.

Causa: Nenhum rosto detectado (apenas para interfaces de consulta assíncrona de tarefas de geração).

Solução: Envie uma imagem contendo um rosto humano nítido.

400-InvalidImageResolution

A resolução da imagem de entrada é muito grande ou pequena.

Causa: A resolução da imagem de entrada é muito alta ou muito baixa.

Solução: A resolução da imagem deve ser de pelo menos 256×256 pixels e não superior a 5760×3240 pixels.

400-InvalidImageFormat

A imagem de entrada está em formato inválido.

Causa: O formato da imagem não atende aos requisitos.

Solução: Use imagens nos formatos JPEG, PNG, JPG, BMP ou WEBP.

400-InvalidURL

URL inválida fornecida na sua requisição.

Causa: A URL é inválida.

Solução: Use uma URL válida.

A URL obrigatória está ausente ou inválida, verifique a URL da requisição.

Causa: A URL de entrada é inválida ou está ausente.

Solução: Forneça uma URL correta.

A URL da requisição é inválida, certifique-se de que a url está correta e é uma imagem.

Causa: A URL de entrada é inválida.

Solução: Garanta que a URL esteja correta e aponte para um arquivo de imagem.

O áudio de entrada é maior que xxs.

Causa: O arquivo de áudio de entrada excede a duração máxima de xx segundos.

Solução: Corte o arquivo de áudio para menos de xx segundos.

O tamanho do arquivo é maior que 15MB.

Causa: O arquivo de áudio de entrada excede o limite de 15 MB.

Solução: Comprima o arquivo de áudio para menos de 15 MB.

Tipo de arquivo não suportado. Os tipos permitidos são: .wav, .mp3.

Causa: O formato do áudio de entrada não é compatível.

Solução: Apenas os formatos wav e mp3 são suportados.

A URL da requisição é inválida, verifique se a URL da requisição está disponível e se o formato da imagem requisitada é um dos seguintes tipos: JPEG, JPG, PNG, BMP e WEBP.

Causa: A imagem está inacessível ou o formato do arquivo baixado não é suportado.

Solução: Garanta que a URL esteja acessível e que o formato da imagem seja JPEG, JPG, PNG, BMP ou WEBP.

400-InvalidImage.FileFormat

Tipo de imagem inválido. Certifique-se de que o arquivo enviado é uma imagem válida.

Causa: O formato do arquivo de imagem não é suportado.

Solução: Use imagens nos formatos JPG, JPEG, PNG, BMP ou WEBP.

400-InvalidURL.ConnectionRefused

Conexão com xxx recusada, forneça uma URL disponível.

Causa: O download foi recusado.

Solução: Forneça uma URL acessível.

400-InvalidURL.Timeout

Timeout ao baixar xxx, verifique a conexão de rede.

Causa: Timeout no download.

Solução: Verifique a conectividade de rede.

400-BadRequestException

Tipo de parte inválido.

Causa: Aplica-se apenas a cenários de conversa do modelo Qwen-Long onde o usuário enviou um tipo de arquivo ainda não suportado pelo Qwen-Long.

Solução: Envie um tipo de arquivo suportado pelo Qwen-Long.

400-BadRequest.EmptyInput

Parâmetro de entrada obrigatório ausente na requisição.

Causa: A requisição não incluiu o parâmetro input.

Solução: Adicione o parâmetro input à requisição.

400-BadRequest.EmptyParameters

Parâmetro obrigatório "parameters" ausente na requisição.

Causa: A requisição não incluiu o parâmetro parameters.

Solução: Adicione o parâmetro parameters à requisição.

400-BadRequest.EmptyModel

Parâmetro obrigatório "model" ausente na requisição.

Causa: A requisição não forneceu o parâmetro model.

Solução: Adicione o parâmetro model à requisição.

400-BadRequest.IllegalInput

O parâmetro de entrada requer formato json.

Causa: O formato do parâmetro de entrada não atende aos requisitos JSON da API.

Solução: Verifique o formato do parâmetro de entrada e garanta que seja um JSON válido.

400-BadRequest.InputDownloadFailed

Falha ao baixar o arquivo de entrada: xxx.

Causa: Falha no download do arquivo de entrada, possivelmente devido a timeout, falha no download ou tamanho do arquivo excedendo os limites.

Solução: Solucione o problema com base na mensagem de erro detalhada xxx.

Falha ao baixar o arquivo de entrada.

Causa: Ao usar a clonagem de voz do Qwen-TTS, o servidor falhou ao baixar o arquivo de áudio para clonagem.

Solução: Verifique se o arquivo de áudio pode ser baixado normalmente. Se puder, verifique se o tamanho do arquivo não excede o limite (10 MB).

400-BadRequest.UnsupportedFileFormat

Formato de arquivo não suportado.

Causa: Ao usar CosyVoice voice cloning, o formato de áudio enviado não atende aos requisitos do modelo.

Solução: O formato de áudio deve ser WAV (16bit), MP3 ou M4A. Note que apenas a extensão do arquivo não é confiável — por exemplo, um arquivo com extensão .mp3 pode ser na verdade Opus. Use ferramentas (como ffprobe, mediainfo) ou comandos (como o comando file do Linux/macOS) para verificar o formato real de codificação de áudio.

O formato do arquivo de entrada não é suportado.

Causa: O formato do arquivo de entrada não é suportado.

Solução: Use um formato de arquivo suportado.

400-BadRequest.TooLarge

Payload Muito Grande.

Causa: O tamanho do arquivo excede o limite.

Solução:

• Quando "purpose" for "file-extract", documentos não devem exceder 150 MB e imagens não devem exceder 20 MB.
• Quando "purpose" for "batch", arquivos não devem exceder 500 MB. Divida e processe em lotes via upload files.

400-BadRequest.ResourceNotExist

O recurso necessário não existe.

Causa:

• Ao chamar interfaces de atualização, consulta ou exclusão para CosyVoice voice cloning, o timbre correspondente não existe.

400-Throttling.AllocationQuota

Sua cota atual é xxx

Causa: O número de timbres CosyVoice voice cloning atingiu o limite.

Solução: Delete alguns timbres.

Limite máximo de armazenamento de vozes excedido, exclua vozes existentes.

Causa: Ao usar a clonagem de voz do Qwen-TTS, você excedeu o limite de timbres da conta principal.

Solução: Delete alguns timbres.

400-InvalidGarment

Imagem de roupa ausente. Insira pelo menos uma imagem de parte superior ou inferior.

Causa: A imagem da roupa está ausente.

Solução: Forneça pelo menos uma imagem de parte superior (top_garment_url) ou de parte inferior (bottom_garment_url).

400-InvalidSchema

O schema do banco de dados é inválido para text2sql.

Causa: As informações do schema do banco de dados não foram fornecidas.

Solução: Insira as informações do schema do banco de dados.

400-InvalidSchemaFormat

O formato do schema do banco de dados é inválido para text2sql.

Causa: O formato das informações da tabela de entrada é inválido.

Solução: Verifique e corrija o formato das informações da tabela.

400-Audio.AudioShortError

Áudio válido muito curto!

Causa: A duração do áudio para CosyVoice voice cloning é muito curta.

Solução: Mantenha a duração do áudio entre 10 e 15 segundos. Garanta fala contínua com pelo menos um segmento superior a 5 segundos.

400-Audio.AudioSilentError

Erro de áudio silencioso.

Causa: O arquivo de áudio CosyVoice voice cloning está silencioso ou os segmentos com som são muito curtos.

Solução: Mantenha a duração do áudio entre 10 e 15 segundos e inclua pelo menos um segmento de fala contínua superior a 5 segundos.

400-InvalidInputLength

A resolução da imagem é inválida. Certifique-se de que o maior lado da imagem seja menor que 4096 e o menor lado seja maior que 150. O tamanho do arquivo deve estar entre 5 KB e 5 MB.

Causa: As dimensões da imagem ou o tamanho do arquivo não atendem aos requisitos.

Solução: Consulte Input Image Requirements.

400-FaqRuleBlocked

Os dados de entrada ou saída foram bloqueados por uma regra de FAQ.

Causa: O módulo de intervenção de regras de FAQ foi acionado.

400-ClientDisconnect

O cliente desconectou antes da conclusão da tarefa!

Causa: O cliente desconectou antes da conclusão da tarefa. Esse erro ocorre ao usar services de síntese ou reconhecimento de fala.

Solução: Verifique seu código para evitar desconexões do servidor antes que a tarefa seja concluída.

400-ServiceUnavailableError

O role deve ser user ou assistant e o comprimento do Content deve ser maior que 0.

Causa: O comprimento do conteúdo de entrada é 0 ou o role está incorreto.

Solução: Garanta que o comprimento do conteúdo de entrada seja maior que 0 e que o formato dos parâmetros (como role) esteja em conformidade com a documentação da API.

400-IPInfringementSuspect

Os dados de entrada são suspeitos de envolvimento em violação de propriedade intelectual.

Causa: Os dados de entrada (como prompts ou imagens) são suspeitos de violar direitos de propriedade intelectual.

Solução: Realize verificações de conformidade de conteúdo e garanta que a entrada não contenha material infrator.

400-UnsupportedOperation

A operação não é suportada no objeto referenciado.

Causa: O objeto associado não suporta esta operação.

Solução: Verifique se o objeto da operação e o tipo de operação correspondem.

O job de fine-tuning não pode ser excluído porque está com status succeeded, failed ou canceled.

Causa: Não é possível excluir o job de fine-tuning porque seu status já é "succeeded", "failed" ou "canceled".

Solução: Apenas jobs em estados específicos podem ser excluídos; não exclua jobs em estados terminais.

400-CustomRoleBlocked

Os dados de entrada ou saída podem conter conteúdo inapropriado conforme regra personalizada.

Causa: O conteúdo da solicitação ou resposta falhou nas verificações de política personalizada.

Solução: Verifique o conteúdo ou ajuste as políticas personalizadas.

400-Audio.PreprocessError

Erro no pré-processamento de áudio.

Causa: Ao usar a clonagem de voz do Qwen-TTS, o pré-processamento do áudio a ser clonado falhou. Isso pode ocorrer porque o conteúdo do parâmetro text difere significativamente da transcrição do áudio, a fala válida é muito curta ou não há som.

Solução: Ajuste o conteúdo do parâmetro text. Se não resolver, grave o áudio novamente seguindo as diretrizes de gravação.

Nenhum segmento atende ao requisito de duração mínima

Causa: Ao usar a clonagem de voz do Qwen-TTS, a fala válida no áudio a ser clonado é muito curta.

Solução: Grave o áudio novamente seguindo as diretrizes de gravação.

400-BadRequest.VoiceNotFound

Voz '%s' não encontrada.

Causa: Ao usar a clonagem de voz do Qwen-TTS, o timbre especificado na chamada da interface de exclusão já foi excluído ou não existe.

Solução: Verifique se o parâmetro voice está correto.

400-Audio.DecoderError

Falha na decodificação do arquivo de áudio.

Causa: Ao usar a clonagem de voz do Qwen-TTS, a decodificação do áudio a ser clonado falhou. / Falha na decodificação do arquivo de áudio para clonagem de voz CosyVoice.

Solução: Verifique se o arquivo de áudio está corrompido e garanta que ele atenda aos requisitos de formato (WAV (16bit), MP3 ou M4A para CosyVoice).

400-Audio.AudioRateError

Taxa de amostragem do arquivo não suportada.

Causa: Ao usar a clonagem de voz do Qwen-TTS ou CosyVoice, a taxa de amostragem do áudio a ser clonado não atende aos requisitos.

Solução: A taxa de amostragem deve ser de pelo menos 24.000 Hz.

400-Audio.DurationLimitError

A duração do áudio excede o limite máximo permitido.

Causa: Ao usar a clonagem de voz do Qwen-TTS, o áudio a ser clonado é muito longo.

Solução: O áudio não deve exceder 60 segundos.

401-InvalidApiKey/invalid_api_key

API key inválida fornecida. / API key incorreta fornecida.

Causa: A API Key está incorreta.

Solução: Causas comuns e correções:

• Leitura incorreta de variável de ambiente

  • Incorreto: api_key=os.getenv("sk-xxx") — o sistema tenta ler uma variável de ambiente chamada sk-xxx, em vez de usar sk-xxx como chave.

  • Correto:

    • Se a variável de ambiente estiver configurada: Use api_key=os.getenv("DASHSCOPE_API_KEY");

      Garanta que a variável de ambiente DASHSCOPE_API_KEY esteja definida antes da execução.

    • Se a variável de ambiente não estiver configurada: Use api_key = "sk-xxx".

      Este método destina-se apenas a depuração; não use em produção.

• Erro de digitação: As API Keys do Alibaba Cloud Model Studio começam com sk-. Confirme que você não usou equivocadamente a chave de outro provedor e que a cópia não incluiu espaços extras ou quebras de linha.

• API Key exclusiva de plano (Coding Plan / Token Plan Team Edition): Tanto o Coding Plan quanto o Token Plan Team Edition fornecem uma API Key exclusiva começando com sk-sp- que deve ser usada com sua própria Base URL exclusiva, e não deve ser misturada com a API Key/Base URL geral (misturá-las retorna este erro de autenticação). Para o Coding Plan, o endpoint exclusivo é https://coding -intl.dashscope.aliyuncs.com/v1; para o Token Plan Team Edition, a Base URL exclusiva é exibida na área de API Key em My Subscriptions no console. Confirme que você atualizou tanto a API Key quanto a Base URL. Consulte Integrating AI Tools e Token Plan Team Edition quick start para detalhes de configuração.

• Incompatibilidade de região: A API Key e a Base URL pertencem a regiões diferentes — por exemplo, usar uma API Key da China (Beijing) com uma Base URL de Singapore. Confirme se sua API Key é da página da região Singapore ou da página da região Beijing, ou da página da região US. Base URLs por região:

  Região	Compatível com OpenAI	DashScope
  Singapore	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1
  China (Beijing)	https://dashscope.aliyuncs.com/compatible-mode/v1	https://dashscope.aliyuncs.com/api/v1
  US (Virginia)	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1

  ImportanteO Alibaba Cloud Model Studio lançou domínios específicos por workspace para as regiões China (Beijing) e Singapore. Os novos domínios dedicados oferecem desempenho superior e maior estabilidade para solicitações de inferência. Recomendamos migrar para os novos domínios:

  • China (Beijing): de https://dashscope.aliyuncs.com para https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapore: de https://dashscope-intl.aliyuncs.com para https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

  {WorkspaceId} é o ID do seu workspace, que pode ser encontrado na página Workspace Details no console do Alibaba Cloud Model Studio. O domínio existente permanece totalmente funcional.

• Problema de compatibilidade de ferramenta: Ferramentas de terceiros não estão devidamente adaptadas (por exemplo, instabilidade no plugin mais recente do Dify causa erros; tente instalar uma versão anterior do plugin Qwen; para versões antigas do Cline, selecione OpenAI-Compatible em vez de Alibaba Qwen como API Provider).

Se nenhuma das opções acima se aplicar, sua API Key pode ter sido excluída; obtenha uma nova e tente novamente.

401-NOT AUTHORIZED

Acesso negado: Você não tem autorização para acessar este workspace ou o workspace não existe. Por favor: Verifique a configuração do workspace. Confira as configurações do endpoint da API. Garanta que você está direcionando a solicitação para o ambiente correto.

Causa:

• O WorkspaceId é inválido ou a conta atual não é membro do workspace.
• Ou o endpoint da solicitação (service endpoint) está incorreto.

Solução:

• Confirme se o WorkspaceId está correto e se a conta é membro do workspace antes de chamar a API.
• Usuários do site China: use o endpoint da região China (Beijing); usuários do site internacional: use o endpoint da região Singapore. Ao usar a depuração online, confirme se o service endpoint está correto.

401-invalid access token or token expired

Token de acesso inválido ou expirado.

Possível causa: Uso equivocado da Base URL do Coding Plan ou de outro plano no Token Plan.

Solução: Use a Base URL exclusiva do Token Plan:

• Endpoint compatível com Anthropic: https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic
• Endpoint compatível com OpenAI: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1

403-AccessDenied/access_denied

A API do usuário atual não suporta chamadas assíncronas.

Causa: A API não suporta chamadas assíncronas.

Solução: Remova o cabeçalho X-DashScope-Async ou defina seu valor como disable.

A API do usuário atual não suporta chamadas síncronas.

Causa: A API não suporta chamadas síncronas.

Solução: Defina X-DashScope-Async: enable no cabeçalho da solicitação.

Inválido conforme a Política: Política expirada.

Causa: A credencial de upload de arquivo expirou ao obter uma URL pública temporária.

Solução: Chame novamente a file upload credential API para gerar uma nova credencial.

Acesso negado.

Causa: Sem permissão para acessar este modelo. O modelo pode exigir aprovação, sua cota gratuita pode estar esgotada e ele não suporta pagamento conforme o uso (por exemplo, deepseek-r1-distill-llama-70b), ou o modelo foi descontinuado.

Solução: Se o modelo foi descontinuado, confirme seu status em Model Deprecation Policy e mude para um dos modelos alternativos recomendados nesse tópico.

Chamada de modelo exclusivo do Token Plan com uma API Key geral

Causa: Modelos exclusivos do Token Plan (como qwen3.8-max-preview) só podem ser chamados por assinantes do Token Plan usando a API Key exclusiva do plano (começando com sk-sp-) juntamente com a Base URL exclusiva do Token Plan. Chamar esses modelos com uma API Key geral (começando com sk-) retorna um erro 403 access_denied.

Solução: No console do Alibaba Cloud Model Studio, acesse My Subscriptions e obtenha a API Key exclusiva do Token Plan e a Base URL exclusiva na área de API Key. Certifique-se de atualizar ambas. Para detalhes de configuração, consulte Token Plan Team Edition quick start. Se a API Key e a Base URL não corresponderem (por exemplo, uma API Key exclusiva com a Base URL geral), um erro de autenticação 401 será retornado; consulte 401-InvalidApiKey/invalid_api_key neste documento.

403-AccessDenied.Unpurchased

Acesso ao modelo negado. Certifique-se de que você está elegível para usar o modelo.

Causa: O service Alibaba Cloud Model Studio não está ativado.

Solução: Siga as etapas abaixo para ativar o service Alibaba Cloud Model Studio.

1. Crie uma conta: Se você não tiver uma conta Alibaba Cloud, registre-se primeiro.

2. Selecione uma região: O Alibaba Cloud Model Studio suporta múltiplas regiões com endpoints, modelos e preços diferentes. Acesse o console do Model Studio para escolher uma região adequada.

3. Conclua o cadastro: Use sua conta Alibaba Cloud para acessar Concluir cadastro e forneça as informações necessárias. Para detalhes, consulte Register an Alibaba Cloud account.

   • Para usar services de modelo na região China (Beijing) (China continental), use sua conta Alibaba Cloud para concluir a verificação de identidade, escolha individual users ou upgrade to enterprise conforme sua situação e clique em Verify Now, depois solicite Purchase cloud resources in the Chinese mainland or use acceleration regions that include it. Para mais informações, consulte Identity Verification Overview.

     Adquira services de cloud específicos implantados na China continental ou ative regiões de aceleração que incluam a China continental (sujeito à disponibilidade do product), após a verificação de identidade e solicitação de compra.

4. Ative o Alibaba Cloud Model Studio: Use sua conta Alibaba Cloud para acessar o Alibaba Cloud Model Studio, leia e concorde com os termos, e o service será ativado automaticamente. Se o contrato de service não aparecer, você já está ativado.

403-Model.AccessDenied

Acesso ao modelo negado.

Causa: Sem permissão para chamar o modelo padrão especificado .

Solução:

• Chamada de modelos padrão: Ao usar uma API key de sub-workspace para chamar modelos padrão (por exemplo, qwen-plus), o sub-workspace deve ter permissões de chamada. Consulte Model Calling Authorization.
• Chamada de modelos personalizados: Após a implantação bem-sucedida, modelos personalizados só podem ser chamados com a API key de seu respectivo workspace e não exigem autorização de chamada de modelo.

403-App.AccessDenied

Acesso ao aplicativo negado.

Causa: Sem permissão para acessar o aplicativo ou modelo.

Solução:

• Confirme se as permissões de acesso foram concedidas para o workspace e o usuário RAM.
• Verifique se o aplicativo está publicado.
• Revise o ID do aplicativo e a API key.
• Se for um erro do Claude Code, use a API Key do workspace padrão.
• Se todos os itens acima estiverem corretos, atualize os dados, republiche e tente novamente, ou recrie o agente.

403-Workspace.AccessDenied

Acesso ao workspace negado.

Causa: Sem permissão para acessar aplicativos ou modelos no workspace.

Solução:

• Se estiver chamando um modelo de sub-workspace, consulte Sub-workspace Model Calling.
• Alternativamente, use a API key da conta principal, que possui permissões para todos os workspaces.

403-Endpoint.AccessDenied

Acesso ao endpoint do workspace negado.

Causa: Você pode estar chamando um modelo descontinuado (por exemplo, versões de snapshot históricas como qwen-max-2025-01-25). Após a descontinuação, o endpoint deixa de estar disponível, causando este erro.

Solução:

• Acesse Model Deprecation Mechanism para confirmar se o modelo foi descontinuado.
• Se estiver descontinuado, mude para o modelo substituto recomendado.

403-AllocationQuota.FreeTierOnly

A cota gratuita do modelo foi esgotada. Se desejar continuar acessando o modelo de forma paga, desative o modo "use free tier only" no console de gerenciamento.

Causa 1: Novos usuários esgotaram a cota gratuita e fizeram solicitações.

Solução: Conclua o cadastro antes de fazer chamadas.

Causa 2: Você ativou a free quota exhaustion stop e fez solicitações após o esgotamento da cota gratuita.

A cota gratuita no console é atualizada a cada minuto (atualize manualmente).

Solução:

• Para continuar chamando de forma paga, você pode desativar a chave free quota exhaustion stop a qualquer momento sem esperar até que a cota gratuita seja usada. As chamadas com pagamento conforme o uso serão retomadas assim que ela for desativada.
• Se a chave já estiver desativada, mas as chamadas ainda falharem, verifique se a API key mudou ou tornou-se inválida. Tente redefinir a API key ou criar uma nova para testar a chamada.
• Se não houver registro de chamada para a solicitação no console, a solicitação pode não ter chegado ao servidor. Verifique a configuração do plugin do cliente ou a conexão de rede.
• Se estiver usando o Coding Plan, geralmente trata-se de um erro de configuração. O Coding Plan requer uma Base URL dedicada e uma API Key dedicadas. Consulte Coding Plan QuickStart para detalhes.

404-ModelNotFound/model_not_found

O modelo xxx fornecido não é suportado pela Batch API.

Causa: O modelo não suporta chamadas Batch ou o nome do modelo está escrito incorretamente.

Solução: Consulte OpenAI compatible - Batch (file input) para confirmar os modelos suportados e os nomes corretos.

Modelo não encontrado. / O modelo xxx não existe. / O modelo xxx não existe ou você não tem acesso a ele.

Causa: O modelo não existe ou você não ativou o Alibaba Cloud Model Studio.

Solução:

• Compare com os nomes dos modelos em Model List para verificar sua entrada (valor do parâmetro model).
• Acesse o Model Marketplace para ativar os services de modelo.
• Se você estiver chamando modelos através de um endpoint de API internacional (por exemplo, {WorkspaceId}.us-east-1.maas.aliyuncs.com), observe que os modelos disponíveis variam por região. Antes de chamar da região US, verifique se o modelo alvo está disponível nessa região. Alguns modelos exigem um sufixo -us no nome do modelo (por exemplo, qwen-max-us).

Endpoint de implantação dedicada: Se você receber ModelNotFound ao chamar um modelo através de um endpoint de implantação dedicada, verifique também o seguinte:

• Use o nome da implantação: Para um endpoint de implantação dedicada, o parâmetro model deve ser definido como o nome da implantação (código do modelo, visível na página Model Deployment no console do Model Studio, em um formato semelhante a qwen3.5-flash-2026-02-23-xxx), não o nome do modelo. Chamar um endpoint de implantação dedicada com um nome de modelo, ou chamar o endpoint de API padrão com um nome de implantação, retorna model_not_found.
• Distinga os métodos de chamada: Chamadas padrão usam o endpoint de API padrão e o nome do modelo, enquanto chamadas de implantação dedicada usam a URL do endpoint de implantação dedicada e o nome da implantação. As API keys para os dois podem diferir, portanto não as misture. Misturá-las causa um erro de autenticação invalid_api_key.

404-model_not_supported

Modelo xxx não suportado para o modo de compatibilidade OpenAI.

Causa: O modelo não suporta acesso compatível com OpenAI.

Solução: Use o método nativo do DashScope para fazer a chamada.

404-WorkSpaceNotFound

WorkSpace não encontrado.

Causa: O workspace não existe.

404-NotFound

Não encontrado!

Causa:

• O resource a ser consultado/operado não existe.

Solução:

• Verifique se o ID do resource a ser consultado/operado está incorreto.

Caminho da solicitação não encontrado.

Causa: Ao usar o modelo Fun-Music, o service endpoint não existe.

Solução: Verifique se o caminho da API está correto e se não há caracteres anormais.

429-Throttling

Limitação de solicitações acionada.

Causa: As chamadas de API acionaram o limite de taxa.

Solução: Reduza a frequência de chamadas ou tente novamente mais tarde.

Muitas solicitações na rota. Tente novamente mais tarde.

Causa: O excesso de solicitações acionou o limite de taxa.

Solução: Tente novamente mais tarde.

Todos os modelos estão temporariamente limitados. Tente novamente em alguns minutos.

Causa: Ao usar services como o Coding Plan que chamam vários modelos através de um cliente (por exemplo, Claude Code), esta mensagem é retornada pelo cliente quando todos os modelos disponíveis acionaram a limitação de taxa 429. Os códigos de erro subjacentes do lado do servidor do Model Studio são Throttling.RateQuota ou Throttling.AllocationQuota.

Solução:

• Aguarde alguns minutos e tente novamente. O limite de taxa será removido automaticamente.
• Reduza a concorrência de solicitações para evitar enviar muitas requisições em um curto período.
• Para aumentar seu limite de taxa, consulte Rate Limiting para solicitar um aumento de cota.

429-Throttling.RateQuota/LimitRequests/limit_requests

Você excedeu seu limite de solicitações./Limite de taxa de solicitações excedido, tente novamente mais tarde./Você excedeu sua lista atual de solicitações.

Causa: A frequência de chamadas (RPS/RPM) acionou o limite de taxa.

Solução: Consulte Rate Limiting para controlar a frequência de chamadas.

Nota: Se uma única chamada retornar 429, verifique se o cabeçalho da solicitação define X-DashScope-Async: enable. Alguns modelos (como qwen-image-3.0-pro) não suportam chamadas assíncronas; quando este cabeçalho é definido, até mesmo uma única solicitação retorna 429. Remova o cabeçalho X-DashScope-Async ou defina seu valor como disable e tente novamente com uma chamada síncrona. Para mais informações, consulte A API do usuário atual não suporta chamadas assíncronas. em 403-AccessDenied/access_denied neste tópico.

429-Throttling.BurstRate/limit_burst_rate

A taxa de solicitações aumentou muito rapidamente. Para garantir a estabilidade do sistema, ajuste a lógica do seu cliente para escalar as solicitações de forma mais suave ao longo do tempo.

Causa: A frequência de chamadas teve um pico repentino antes de atingir os limites de taxa, acionando a proteção de estabilidade do sistema.

Solução: Otimize a lógica do cliente para usar estratégias de solicitação suaves (por exemplo, agendamento uniforme, backoff exponencial ou buffer de fila de solicitações) para distribuir as solicitações uniformemente ao longo do tempo e evitar picos.

429-Throttling.AllocationQuota/insufficient_quota

Cota alocada excedida, aumente seu limite de cota./ Você excedeu sua cota atual, verifique seu plano e detalhes de faturamento.

Causa: O consumo de tokens por segundo ou minuto (TPS/TPM) acionou o limite de taxa.

Solução: Consulte a documentação Rate Limiting para limites de modelos e ajuste a estratégia de chamada. Se as cotas padrão forem insuficientes, solicite um aumento temporário de TPM no console do Model Studio em Rate Limit Increase.

Consulte FAQ para evitar acionar limites de taxa.

Muitas solicitações. Solicitações em lote estão sendo limitadas devido aos limites de capacidade do sistema. Tente novamente mais tarde.

Causa: O excesso de solicitações Batch acionou o limite de taxa.

Solução: Sua solicitação não pode ser processada agora; tente novamente mais tarde.

Cota gratuita alocada excedida.

Causa: A cota gratuita expirou ou foi esgotada, e o modelo não suporta pagamento conforme o uso.

Solução: Substitua por outro modelo — por exemplo, se a cota do modelo Qwen Audio estiver esgotada, use o modelo non-real-time (Qwen-Omni).

Limite máximo de vozes clonadas excedido.

Causa: Ao usar a clonagem de voz do Qwen-TTS, você excedeu o limite de timbres da conta principal.

Solução: Delete alguns timbres.

429-CommodityNotPurchased

O commodity ainda não foi adquirido.

Causa: A assinatura do workspace não foi adquirida.

Solução: Adquira o service de workspace primeiro.

429-PrepaidBillOverdue

A fatura pré-paga está vencida.

Causa: A fatura pré-paga do workspace expirou.

429-PostpaidBillOverdue

A fatura pós-paga está vencida.

Causa: O service de inferência de modelo expirou.

430-Audio.DecoderError

Falha na decodificação do arquivo de áudio.

Causa: A decodificação do arquivo de áudio CosyVoice voice cloning falhou.

Solução: Utilize ferramentas (como ffprobe, mediainfo) ou comandos (como o comando file no Linux/macOS) para verificar o formato real de codificação do áudio.

430-Audio.FileSizeExceed

Arquivo muito grande

Causa: O tamanho do arquivo de áudio CosyVoice voice cloning excede o limite.

Solução: O arquivo de áudio para clonagem de voz deve ter menos de 10 MB.

430-Audio.AudioRateError

Taxa de amostragem do arquivo não suportada

Causa: A taxa de amostragem do arquivo de áudio CosyVoice voice cloning não é suportada.

Solução: Defina a taxa de amostragem para 16 kHz ou superior.

430-Audio.AudioSilentError

Arquivo silencioso não suportado.

Causa: O arquivo de áudio CosyVoice voice cloning está silencioso ou os segmentos com fala são muito curtos.

Solução: Mantenha a duração do áudio entre 10 e 15 segundos e inclua pelo menos um segmento contínuo de fala com mais de 5 segundos.

500-InternalError/internal_error

Ocorreu um erro interno. Tente novamente mais tarde ou entre em contato com o suporte.

Causa: Erro interno.

Solução:

• Se estiver usando o (Qwen-Omni) model, utilize a saída em streaming.

• Se estiver usando o CosyVoice voice cloning, as possíveis causas incluem:

  • O arquivo de áudio está fora do padrão — por exemplo, baixa qualidade, ruído ou flutuações de volume. Consulte Recording Guidelines e tente novamente.
  • A URL do arquivo de gravação está inacessível. Siga as instruções em CosyVoice Voice Cloning/Design API e tente novamente.
  • O arquivo de gravação é muito longo. Use gravações de aproximadamente 10 a 15 segundos, com pelo menos um segmento contínuo de fala superior a 5 segundos.

Erro interno do servidor!

Causa: Erro interno do algoritmo.

Solução: Tente novamente mais tarde.

erro no servidor de pré-processamento de áudio

Ao usar o CosyVoice voice cloning:

• Causa: O arquivo de áudio está fora do padrão — por exemplo, baixa qualidade, ruído ou flutuações de volume.

  Solução: Consulte Recording Guidelines e tente novamente.

• Causa: A URL do arquivo de gravação está inacessível.

  Solução: Siga as instruções em CosyVoice Voice Cloning/Design API e tente novamente.

• Causa: O arquivo de gravação é muito longo.

  Solução: Use gravações de aproximadamente 10 a 15 segundos, com pelo menos um segmento contínuo de fala superior a 5 segundos.

falha na requisição asr

Causa: Ao usar o CosyVoice voice cloning, o arquivo de áudio está fora do padrão — sem fala válida ou com áudio pouco claro e muito ruído.

Solução: Consulte Recording Guidelines e tente novamente.

Stream gRPC cancelado remotamente.

Causa: O timbre usado na síntese de fala não existe.

Solução: Verifique o parâmetro voice e garanta que um nome de timbre válido foi especificado. Consulte Real-time Speech Synthesis (CosyVoice) para ver os timbres disponíveis.

500-InternalError.FileUpload

erro de upload no OSS.

Causa: Falha no upload do arquivo.

Solução: Verifique a configuração do OSS e a rede.

500-InternalError.Upload

Falha ao fazer upload do resultado.

Causa: Falha no upload do resultado.

Solução: Verifique a configuração de armazenamento ou tente novamente mais tarde.

500-InternalError.Algo

erro interno de inferência.

Causa: Exceção no service.

Solução: Tente novamente primeiro para descartar problemas transitórios.

Esperando delimitador ',' : linha x coluna xxx (caractere xxx)

Causa: Os dados JSON gerados pelo modelo são inválidos, impedindo chamadas de ferramentas.

Solução: Mude para o modelo mais recente ou otimize os prompts e tente novamente.

Content-Length ausente na URL multimodal.

Causa: O cabeçalho de resposta da URL não contém o campo Content-Length.

Solução: Se o problema persistir, tente outro link de imagem.

Verificar o campo Content-Length

1. Abra um navegador (como Chrome ou Firefox).
2. Abra as Ferramentas de Desenvolvedor (geralmente pressionando F12 ou clicando com o botão direito e selecionando "Inspect").
3. Acesse a aba Network.
4. Insira a URL da imagem na barra de endereços e acesse-a.
5. Localize a requisição correspondente e procure em Headers > Response Headers pelo campo Content-Length.

Ocorreu um erro no model serving, mensagem de erro: [Request rejected by inference engine!]

Causa: Erro no servidor backend do service de modelo.

Solução: Tente novamente mais tarde.

Ocorreu um erro no model serving, mensagem de erro: [Cluster 'xxx' not found!]

Causa: A requisição API foi roteada para um cluster de service indisponível. Isso geralmente ocorre porque os services de modelo do Alibaba Cloud Model Studio ainda não foram implantados na região especificada na requisição.

Solução: Verifique se a região na Base URL da sua requisição ou na configuração do SDK está correta. Os services de modelo do Model Studio estão atualmente disponíveis em regiões como China (Beijing), Singapore e US (Virginia). Certifique-se de chamar uma região onde o service esteja implantado. Se você usar um endpoint no nível de workspace (no formato https://{WorkspaceId}.{region}.maas.aliyuncs.com/compatible-mode/v1), confirme se {region} é o identificador de uma região onde o service está habilitado.

Ocorreu um erro interno durante a execução do algoritmo.

Causa: Erro de tempo de execução do algoritmo.

Solução: Tente novamente mais tarde.

Erro de inferência: Erro de inferência.

Causa: Erro de inferência.

Solução: Verifique se o arquivo de imagem está corrompido ou se a qualidade da imagem da pessoa é suficiente (deve conter um rosto completo e nítido).

Role deve estar em [user, assistant]

Causa: Ao usar o modelo Qwen-MT, o array messages contém mensagens com role diferente de user.

Solução: Garanta que o array messages contenha apenas um elemento, que deve ser uma mensagem de usuário (User Message).

Embedding_pipeline_Error: xxx

Causa: Erro no pré-processamento de imagem ou vídeo.

Solução: Confirme se as imagens/vídeos enviados e o código da requisição atendem aos requisitos e tente novamente.

Falha ao receber resposta do backend de batching!

Causa: Erro interno do service.

Solução: Tente novamente mais tarde.

[music]Falha ao receber resposta do backend de batching!

Causa: Ao usar o modelo Fun-Music, os limites de concorrência do service foram excedidos.

Solução: Reduza as requisições simultâneas e tente novamente.

Outros tipos de erro de servidor.

Causa: Ao usar o modelo Fun-Music, ocorreu uma exceção interna desconhecida do sistema.

Solução: Forneça o ID da requisição à equipe técnica para solução de problemas.

Ocorreu um erro interno durante a execução, tente novamente mais tarde ou entre em contato com o suporte. / erro de processamento do algoritmo. / erro de inferência. / Ocorreu um erro interno durante a computação, tente este modelo mais tarde.

Causa: Erro interno do algoritmo.

Solução: Tente novamente mais tarde.

índice da lista fora do intervalo

Causa: O último elemento no array messages deve ser uma User Message.

Solução: Ajuste a ordem do array messages para garantir que o último elemento seja {"role": "user", ...}.

500-InternalError.Timeout

Ocorreu um erro interno de timeout durante a execução, tente novamente mais tarde ou entre em contato com o suporte.

Causa: A tarefa assíncrona não retornou resultados dentro de 3 horas, causando timeout.

Solução: Verifique a execução da tarefa ou entre em contato com o suporte.

500-SystemError

Ocorreu um erro de sistema, tente novamente mais tarde.

Causa: Erro de sistema.

Solução: Tente novamente mais tarde.

500-ModelServiceFailed

Falha ao requisitar o service de modelo.

Causa: Falha na chamada do service de modelo.

Solução: Tente novamente mais tarde.

500-RequestTimeOut

Tempo da requisição esgotado, tente novamente mais tarde. / Timeout de resposta! /Erro de I/O na requisição POST para "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions": timeout

Causa:

• Timeout na requisição ao chamar modelos grandes; o erro de timeout ocorre após 300 segundos.
• Ao usar reconhecimento de fala (Paraformer), nenhum áudio foi enviado ao servidor por um longo período ou houve silêncio prolongado.
• Ao chamar modelos de geração ou edição de imagem, o tempo de processamento excede os limites devido ao tamanho grande da imagem ou alta complexidade.

Solução:

• Use saída em streaming. Consulte Streaming Output.
• Defina o parâmetro heartbeat como true ou encerre as tarefas de reconhecimento prontamente.
• Ao chamar modelos de imagem, tente reduzir a resolução, simplificar as edições ou tentar novamente mais tarde.

500-ResponseTimeout

Timeout no stream de resposta

Causa: Ao usar o modelo Fun-Music, a execução interna atingiu o tempo limite.

Solução: Tente chamar novamente.

500-InvokePluginFailed

Falha ao invocar plugin.

Causa: Falha na invocação do plugin.

Solução: Verifique a configuração e a disponibilidade do plugin.

500-AppProcessFailed

Falha ao processar requisição da aplicação.

Causa: Falha no processamento do fluxo da aplicação.

Solução: Verifique a configuração da aplicação e os nós do fluxo.

500-RewriteFailed

Falha ao reescrever conteúdo para prompt.

Causa: Falha na chamada do modelo grande para reescrita do prompt.

Solução: Tente novamente mais tarde.

500-RetrivalFailed

Falha ao recuperar dados dos documentos.

Causa: Falha na recuperação de documentos.

Solução: Verifique o índice de documentos e a configuração de recuperação.

500/503-ModelServingError

Muitas requisições. Suas requisições estão sendo limitadas devido aos limites de capacidade do sistema. Tente novamente mais tarde.

Causa: Os recursos de rede estão saturados; sua requisição não pode ser processada temporariamente.

Solução: Tente novamente mais tarde.

503-ModelUnavailable

Modelo indisponível, tente novamente mais tarde.

Causa: Modelo temporariamente indisponível.

Solução: Tente novamente mais tarde.

Erros de SDK

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.

Causa: API Key não fornecida ao usar o DashScope SDK.

Solução: Consulte Configuring API Key as Environment Variable para detalhes.

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

Causa: API Key não passada ao usar o OpenAI SDK.

Solução:

• Passar API Key via variável de ambiente (recomendado)

  Defina DASHSCOPE_API_KEY como uma variável de ambiente (consulte Configuring API Key as Environment Variable) e inicialize o client lendo-a com os.getenv:

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

• Codificar API Key diretamente (apenas para testes)

  Passe a API Key diretamente para o parâmetro api_key:

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

  Nota: Isso representa um risco de segurança; não use em produção.

Bad Request para url:xxx

Causa: Ao usar a biblioteca requests do Python, adicionar response.raise_for_status() causa erros sem retornar o conteúdo específico do erro do servidor.

Solução: Use print(response.json()) para visualizar a resposta do servidor.

Cannot resolve symbol 'ttsv2'

Causa: Se estiver usando real-time speech synthesis (CosyVoice), esse problema ocorre devido a uma versão desatualizada do DashScope SDK.

Solução: Install the latest DashScope SDK.

NetworkError

NoApiKeyException: Can not find api-key.

Causa: A configuração da variável de ambiente não teve efeito.

Solução: Reinicie seu cliente ou IDE e tente novamente. Consulte FAQ para mais cenários.

ConnectException: Failed to connect to dashscope.aliyuncs.com

Causa: O ambiente de rede local está anormal.

Solução: Verifique a rede local — por exemplo, acesso HTTPS bloqueado por problemas de certificado ou configurações incorretas de firewall. Tente uma rede ou servidor diferente.

InputRequiredException: Parameter invalid: text is null

Causa: Ao usar real-time speech synthesis (CosyVoice), nenhum texto foi enviado para síntese.

Solução: Atribua um valor ao parâmetro text ao chamar a API de síntese de fala.

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

Causa: A versão atual do DashScope SDK está desatualizada.

Solução: Install the latest DashScope SDK.

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.

Causa: Em uma única tarefa Batch, todas as requisições devem usar o mesmo modelo.

Solução: Verifique seu arquivo de entrada conforme 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.

Causa: Em uma única tarefa Batch, cada ID de requisição deve ser único.

Solução: Verifique seu arquivo de entrada conforme OpenAI compatible - Batch (file input) para garantir que todos os IDs de requisição sejam únicos.

Capacidade de upload de arquivo excede o limite. / Número de uploads de arquivo excede o limite.

Causa: Falha no upload do arquivo porque o espaço de armazenamento do Alibaba Cloud Model Studio na sua conta está cheio ou quase cheio.

Solução: Exclua arquivos desnecessários pela interface OpenAI compatible - File para liberar espaço. O armazenamento atual suporta até 10.000 arquivos, totalizando no máximo 100 GB.

Erros de WebSocket

A mensagem de texto decodificada era muito grande para o buffer de saída e o endpoint não suporta mensagens parciais

Causa: Ao usar reconhecimento de fala em streaming (Paraformer), o service retornou resultados de reconhecimento muito grandes.

Solução: Envie áudio em segmentos — cerca de 100 ms por segmento, com tamanho de dados entre 1 KB e 16 KB.

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

Causa: Se estiver usando síntese de fala (CosyVoice), a conexão WebSocket não pôde ser estabelecida dentro de 5 segundos.

Solução: Verifique a rede local, as configurações de firewall ou tente uma rede ou servidor diferente.

formato de áudio não suportado:xxx

Causa: Ao usar a clonagem de voz CosyVoice, o formato de áudio enviado não atende aos requisitos do modelo.

Solução: O formato de áudio deve ser WAV (16bit), MP3 ou M4A. Não confie apenas nas extensões de arquivo; use ferramentas (como ffprobe, mediainfo) ou comandos para verificar o formato real de codificação.

erro interno desconhecido

Causa: O formato do arquivo de áudio para clonagem de voz CosyVoice pode não atender aos requisitos.

Solução: O formato de áudio deve ser WAV (16bit), MP3 ou M4A. Use ferramentas para verificar o formato real de codificação.

Resposta de backend inválida recebida (nome de status ausente)

Causa: Ao usar a API RESTful de reconhecimento de arquivos gravados do Paraformer, os parâmetros da requisição estão incorretos.

Solução: Verifique o código em relação à documentação da API.

NO_INPUT_AUDIO_ERROR

Causa: Nenhuma fala válida detectada.

Solução: Se estiver usando reconhecimento de fala em tempo real do Paraformer, solucione o problema da seguinte forma:

1. Verifique se há entrada de áudio.
2. Verifique o formato do áudio (suportados: pcm, wav, mp3, opus, speex, aac, amr).

SUCCESS_WITH_NO_VALID_FRAGMENT

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a consulta do resultado de reconhecimento foi bem-sucedida, mas o módulo VAD não detectou fala válida.

Solução: Verifique se a gravação contém fala válida. Se houver apenas silêncio, a ausência de resultado de reconhecimento é normal.

ASR_RESPONSE_HAVE_NO_WORDS

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a consulta do resultado de reconhecimento foi bem-sucedida, mas o resultado final está vazio.

Solução: Verifique se a gravação contém fala válida ou se a fala válida consiste apenas de preenchimentos e o parâmetro disfluency_removal_enabled os filtrou.

FILE_DOWNLOAD_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o download do arquivo a ser reconhecido falhou.

Solução: Verifique se o caminho do arquivo de gravação está correto e acessível pela rede pública.

FILE_CHECK_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o formato do arquivo está incorreto.

Solução: Verifique se o arquivo de gravação está no formato WAV mono/stereo ou MP3.

FILE_TOO_LARGE

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o arquivo a ser reconhecido é muito grande.

Solução: Verifique se o arquivo de gravação excede 2 GB; nesse caso, divida-o.

FILE_NORMALIZE_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a normalização do arquivo falhou.

Solução: Verifique se o arquivo de gravação está corrompido ou se é reproduzível.

FILE_PARSE_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a análise do arquivo falhou.

Solução: Verifique se o arquivo de gravação está corrompido ou se é reproduzível.

MKV_PARSE_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a análise do MKV falhou.

Solução: Verifique se o arquivo de gravação está corrompido ou se é reproduzível.

FILE_TRANS_TASK_EXPIRED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a tarefa de reconhecimento expirou.

Solução: O TaskId não existe ou expirou. Reenvie a tarefa.

REQUEST_INVALID_FILE_URL_VALUE

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o parâmetro file_link é inválido.

Solução: Confirme se o formato do parâmetro file_url está correto.

CONTENT_LENGTH_CHECK_FAILED

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a verificação de content-length falhou.

Solução: Verifique se o content-length da resposta HTTP corresponde ao tamanho real do arquivo ao baixar a gravação.

FILE_404_NOT_FOUND

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o arquivo para download não existe.

Solução: Verifique se a URL do arquivo está correta.

FILE_403_FORBIDDEN

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, não há permissão para baixar a gravação.

Solução: Verifique as permissões de acesso ao arquivo.

FILE_SERVER_ERROR

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, o servidor de arquivos está indisponível.

Solução: Tente novamente mais tarde ou verifique o status do servidor de arquivos.

AUDIO_DURATION_TOO_LONG

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a duração do arquivo excede 12 horas.

Solução: Divida o áudio em segmentos e envie várias tarefas de reconhecimento. Use ferramentas como FFmpeg para dividir.

DECODE_ERROR

Causa: Se estiver usando o reconhecimento de arquivos gravados do Paraformer, a detecção de informações do arquivo de áudio falhou.

Solução: Confirme se o link de download aponta para um formato de áudio suportado.

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

Causa: Ao usar a síntese de fala em tempo real Qwen-TTS com o modelo qwen-tts-vc-realtime-2025-08-20, você usou um timbre padrão. Este modelo suporta apenas timbres clonados.

Solução: Use um timbre gerado via clonagem de voz, não um timbre padrão.

NO_VALID_AUDIO_ERROR

Causa: Ao usar reconhecimento de fala (Paraformer), o áudio a ser reconhecido é inválido.

Solução: Verifique o formato do áudio, taxa de amostragem, etc., para garantir que os requisitos sejam atendidos.

InvalidParameter: task can not be null

Causa: Ao usar a API WebSocket de síntese de fala CosyVoice, o payload run-task ou finish-task não possui um campo input, ou o payload continue-task não possui input.text.

Solução:

1. Verifique o comando run-task: garanta que o payload contenha "input": {} (objeto vazio); não omita o input.
2. Verifique o comando continue-task: garanta que payload.input contenha um campo de texto não vazio.
3. Verifique o comando finish-task: garanta que o payload contenha "input": {}.

close code 1007 Model not found

Causa: Ao chamar um modelo em tempo real (por exemplo, Qwen3-Omni-Flash-Realtime) pelo protocolo WebSocket, o nome do modelo na requisição está incorreto ou o service de modelo não está ativado. O servidor fecha a conexão com o close code 1007 e motivo Model not found.

Solução:

• Compare com os nomes dos modelos em Model List para verificar sua entrada (valor do parâmetro model). Um nome de modelo em tempo real carrega um sufixo como -realtime, que não deve ser omitido ou alterado.
• Acesse o Model Marketplace para confirmar se o service de modelo está ativado. Se não estiver, ative-o e tente novamente.

200-BailianGateway.Workspace.NotAuthorised

Causa: Este erro pode ocorrer devido a: (1) caracteres especiais ou formatos não padrão na URL de acesso causando falha na validação de autorização do workspace; (2) subconta RAM operando um workspace sem permissões.

Solução: (1) Acesse novamente a home page do console Model Studio e navegue até a página de destino; (2) a conta principal ou uma conta RAM com permissão administrativa deve conceder à subconta acesso ao workspace correspondente.

200-BailianGateway.Team.NotAuthorised

Causa: A subconta RAM atual não tem permissão para a equipe (organização) que está acessando. Quando uma subconta RAM acessa recursos de equipe (organização) para os quais não está autorizada, a verificação de autorização no nível de equipe do gateway falha e retorna este erro.

Solução: A conta principal ou uma conta RAM com permissão administrativa deve adicionar a subconta RAM à equipe (organização) correspondente e conceder-lhe as permissões apropriadas no gerenciamento de permissões.

Coding Plan

Erro de conexão

Causa: Erro de digitação na Base URL ou problema de rede.

Solução: Verifique a ortografia da Base URL e a conexão de rede.

cota horária alocada excedida

Causa: Cota de requisições de 5 horas esgotada.

Solução: A cota é redefinida automaticamente após 5 horas.

cota semanal alocada excedida

Causa: Cota de requisições semanais esgotada.

Solução: A cota é redefinida às 00:00:00 (UTC+8) toda segunda-feira.

cota mensal alocada excedida

Causa: Cota de requisições mensais esgotada.

Solução: A cota é redefinida às 00:00:00 (UTC+8) no dia da assinatura de cada mês.

cota de concorrência alocada excedida

Causa: As requisições simultâneas atuais excedem o limite alocado dinamicamente pela plataforma.

Solução: Tente novamente em breve. A plataforma ajusta dinamicamente os limites de concorrência com base na carga geral; horários de pico podem acionar essa restrição.

cota de uso alocada excedida. tente novamente mais tarde.

Causa: Além dos limites de contagem de chamadas, o Coding Plan também avalia o consumo de recursos de curto prazo. Alto consumo de curto prazo aciona limitação temporária de taxa.

Solução: Geralmente recupera dentro de uma hora. Divida tarefas grandes em menores e envie-as ao longo do tempo.