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 não streaming.

Solução: Defina o parâmetro enable_thinking como false ou use o método de saída em streaming 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 esse 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 saída em streaming, mas o streaming não foi ativado durante a chamada.

Solução: Utilize o método de saída em streaming para chamar o modelo.

This model does not support enable_search.

Causa: O modelo atual não oferece suporte ao recurso de pesquisa na web, mas o parâmetro enable_search foi definido como true.

Solução: Chame um modelo que ofereça suporte à pesquisa 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 consta nos idiomas suportados.

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]

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

Solução:

• Se a chamada for feita 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 obter 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 solicitação.

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

Causa: Durante a chamada de ferramenta, 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.

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 (,) ou colchetes não fechados. Você 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 de geração de texto para verificar seu posicionamento.

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

Causa: Ao usar saída estruturada, 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: “Please output in JSON format.”

Json mode response is not supported when enable_thinking is true

Causa: Você ativou o modo de pensamento do modelo enquanto usava saída estruturada.

Solução: Ao usar saída estruturada, defina enable_thinking como false para desativar o modo de pensamento. Alternativamente, consulte o FAQ Como usar saída estruturada com modelos em modo de pensamento?

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 saída estruturada, 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 a chamada for feita por meio de uma ferramenta de terceiros (como Cherry Studio), ative a opção de pensamento na caixa de entrada.

• Se a chamada for feita 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-o 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 de geração de texto 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 de Embedding e controle o número de textos de entrada.

[] is too short

Causa: O array messages 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 ofereça suporte a 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 este 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 de content multimodais, como imagens (image_url), este 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 "the model provider returned empty content".

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 modalidade, mude para um modelo multimodal (como a série Qwen-VL ou Qwen3-VL); se for indispensável 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 sem 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 da 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 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 esse parâmetro como DATA_CENTER_FILE; ao criar a partir de categorias, defina-o 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.

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.

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 Passar arquivos locais (codificados em Base64 ou caminhos de arquivo) 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.

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 usar modelos multimodais como qwen3.7-plus ou qwen3-vl-plus via DashScope: use MultiModalConversation.call() ou o endpoint multimodal-generation. Consulte Compreensão de Imagem e Vídeo.

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

  2. Ao usar modelos de texto simples como qwen3-max, qwen-plus ou deepseek-v4-pro via DashScope, use Generation.call() ou o endpoint text-generation. Consulte Visão Geral.

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

• Causa 2: A versão do DashScope SDK 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/vídeo.

  Solução: Atualize a versão do SDK

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 Formatos de imagem suportados pelos modelos Qwen VL para mais detalhes.

Solução:

Campo obrigatório: image_url

Causa: Parâmetro de entrada image_url ausente.

Solução: Consulte Geração de Vídeo Emoji e passe o parâmetro image_url.

Campo obrigatório: driven_id

Causa: Parâmetro de entrada driven_id ausente.

Solução: Consulte Geração de Vídeo Emoji e passe o parâmetro driven_id.

ext_bbox inválido

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

Solução: Consulte Geração de Vídeo Emoji e passe o valor correto para ext_bbox.

Driven não existe: driven_id

Causa: O driven_id fornecido não existe.

Solução: Consulte Geração de Vídeo Emoji e passe o valor correto para driven_id.

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

Causa: Ao chamar a síntese de fala CosyVoice via Referência da API WebSocket, 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 descrito em Limites e Restrições.

[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; 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.

    • Os valores suportados para instruction variam conforme o timbre. Consulte a Lista de Timbres CosyVoice 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 correspondente ao timbre.

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 Qwen-TTS, mas os modelos utilizados diferem.

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 do acesso.

Solução: Acesse Despesas e Custos para verificar se há pagamentos pendentes:

• Sem pagamentos pendentes: Confirme se a API Key pertence à conta atual.

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

400-DataInspectionFailed/data_inspection_failed

Dados de entrada ou saída podem conter conteúdo inapropriado. / Dados de entrada podem conter conteúdo inapropriado. / 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.

Dados de entrada xxx podem conter conteúdo inapropriado.

Causa: 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.

400-APIConnectionError

Erro de conexão.

Causa: Problema de rede local, geralmente causado por um proxy ativado.

Solução: Desative ou reinicie o proxy.

400-InvalidFile.DownloadFailed

O arquivo de áudio não pôde ser baixado.

Causa: Ao usar o reconhecimento de fala (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 entre 1 e 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 entre 1 e 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 com apenas uma 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 clara.

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 Geração de Vídeo VideoRetalk 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. 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 com apenas uma 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 com apenas uma 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, a pessoa não pode estar de costas, nem sentada, e deve haver 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 solicitado 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 com apenas uma pessoa.

400-InvalidPerson

A imagem de entrada não contém corpo humano ou contém múltiplos corpos. 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 com apenas uma pessoa.

400-InvalidParameter.DataInspection

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

Causa: Tempo esgotado 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 espaço de armazenamento temporário 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 em sua requisição.

Causa: A URL é inválida.

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

URL obrigatória 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 é mais longo 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: Compacte 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 solicitada é 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: Tempo esgotado no download.

Solução: Verifique a conectividade da 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 de 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 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 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. 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 no Linux/macOS) para verificar o formato real de codificação do á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 envie arquivos em lotes.

400-BadRequest.ResourceNotExist

O recurso necessário não existe.

Causa:

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

400-Throttling.AllocationQuota

Sua cota atual é xxx

Causa: O número de timbres de clonagem de voz CosyVoice atingiu o limite.

Solução: Exclua alguns timbres.

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

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 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 clonagem de voz CosyVoice é 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 para clonagem de voz CosyVoice 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 Requisitos de Imagem de Entrada.

400-FaqRuleBlocked

Dados de entrada ou saída bloqueados por 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 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 de referência.

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 seu 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

Dados de entrada ou saída podem conter conteúdo inapropriado segundo regra personalizada.

Causa: O conteúdo da requisiçã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 muito 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 (16 bits), 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 fornecida inválida. / 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 serve apenas para 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 do Coding Plan: O Coding Plan fornece uma API Key exclusiva (começando com sk-sp-) que deve ser usada com o endpoint de API exclusivo (por exemplo, https://coding -intl.dashscope.aliyuncs.com/v1), diferentemente das API Keys gerais. Confirme que você atualizou tanto a API Key quanto a Base URL. Consulte Integração de Ferramentas de IA 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 ainda 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://dashscope-us.aliyuncs.com/compatible-mode/v1	https://dashscope-us.aliyuncs.com/api/v1

  Importante

  O 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 requisições de inferência. Recomendamos a migração 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 definições do seu endpoint de API. Garanta que você está apontando para o ambiente correto.

Causa:

• O WorkspaceId é inválido ou a conta atual não é membro do workspace.

• Ou o endpoint da requisiçã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: O Token Plan usou equivocadamente a Base URL do Coding Plan ou de outro plano.

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 requisiçã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 API de credencial de upload de arquivo para gerar uma nova credencial.

Acesso negado.

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

403-AccessDenied.Unpurchased

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

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

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

1. Crie uma conta: Se você não tem 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 a verificação de identidade: 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.

   • Para usar services de modelo na região China (Beijing), prossiga com a verificação de identidade para Purchase cloud resources in the Chinese mainland or use acceleration regions that include it. Para mais informações, consulte Visão Geral da Verificação de Identidade.

     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 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 chave de API de sub-workspace para chamar modelos padrão (por exemplo, qwen-plus), o sub-workspace deve ter permissões de chamada. Consulte Autorização de Chamada de Modelo.

• Chamada de modelos personalizados: Após a implantação bem-sucedida, modelos personalizados só podem ser chamados com a chave de API de seu próprio 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 APP ID e a API KEY.

• Se for um erro do Claude Code, use a API Key do workspace padrão.

• Se tudo acima estiver correto, 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 Chamada de Modelo de Sub-workspace.

• 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 o Mecanismo de Descontinuação de Modelos 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 esgotam a cota gratuita e fazem requisições.

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

Causa 2: Você ativou o bloqueio por esgotamento de cota gratuita e fez requisições após o fim da cota gratuita.

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

Solução:

• Para pagar pelas chamadas, aguarde até que o console mostre que a cota gratuita foi esgotada e desative o botão de bloqueio por esgotamento de cota gratuita.

• Se estiver usando o Coding Plan, isso geralmente é um erro de configuração. O Coding Plan requer uma Base URL dedicada e uma API Key específicas. Consulte o Guia de Início Rápido do Coding Plan 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á grafado incorretamente.

Solução: Consulte Compatível com OpenAI - Batch (entrada de arquivo) 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 de modelo na Lista de Modelos para verificar sua entrada (valor do parâmetro model).

• Acesse o Model Marketplace para ativar os services de modelo.

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 requisiçã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 requisições acionada.

Causa: As chamadas de API acionaram a limitação de taxa.

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

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

Causa: O excesso de requisições acionou a limitação 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 múltiplos 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 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 requisições para evitar o envio excessivo em um curto período.

• Para aumentar seu limite de taxa, consulte Limitação de Taxa para solicitar um aumento de cota.

429-Throttling.RateQuota/LimitRequests/limit_requests

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

Causa: A frequência de chamadas (RPS/RPM) acionou a limitação de taxa.

Solução: Consulte Limitação de Taxa para controlar a frequência de chamadas.

429-Throttling.BurstRate/limit_burst_rate

A taxa de requisições aumentou muito rapidamente. Para garantir a estabilidade do sistema, ajuste a lógica do seu cliente para escalar as requisiçõ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 requisição suaves (por exemplo, agendamento uniforme, backoff exponencial ou buffer de fila de requisições) para distribuir as requisiçõ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 a limitação de taxa.

Solução: Consulte a documentação de Limitação de Taxa para verificar os limites do modelo e ajustar 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 Aumento de Limite de Taxa.

Consulte o FAQ para evitar o acionamento de limites de taxa.

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

Causa: O excesso de requisições Batch acionou a limitação de taxa.

Solução: Sua requisiçã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 não em tempo real (Qwen-Omni).

Limite máximo de vozes clonadas excedido.

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: Falha na decodificação do arquivo de áudio da clonagem de voz CosyVoice.

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 da clonagem de voz CosyVoice excede o limite permitido.

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 da clonagem de voz CosyVoice 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 da clonagem de voz CosyVoice está totalmente 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 modelo (Qwen-Omni), utilize saída em streaming.

• Se estiver usando a clonagem de voz CosyVoice, as possíveis causas incluem:

  • O arquivo de áudio está fora do padrão — por exemplo, com baixa qualidade, ruído ou flutuações de volume. Consulte as Diretrizes de Gravação e tente novamente.

  • A URL do arquivo de gravação está inacessível. Siga as instruções em Clonagem de Voz CosyVoice/API Design e tente novamente.

  • O arquivo de gravação é muito longo. Utilize gravações de aproximadamente 10 a 15 segundos, contendo 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 utilizar a clonagem de voz CosyVoice:

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

  Solução: Consulte as Diretrizes de Gravação e tente novamente.

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

  Solução: Siga as instruções em Clonagem de Voz CosyVoice/API Design e tente novamente.

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

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

falha na requisição asr

Causa: Durante o uso da clonagem de voz CosyVoice, o arquivo de áudio estava fora do padrão — sem fala válida ou com áudio pouco claro e muito ruído.

Solução: Consulte as Diretrizes de Gravação e tente novamente.

Stream gRPC cancelado remotamente.

Causa: O timbre utilizado 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 a documentação de Síntese de Fala em Tempo Real (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: Caso o problema persista, tente outro link de imagem.

Ocorreu um erro no model serving, mensagem de erro: [Requisição rejeitada pelo motor de inferência!]

Causa: Erro no servidor backend do service de modelo.

Solução: Tente novamente mais tarde.

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

Causa: Erro de runtime do algoritmo.

Solução: Tente novamente mais tarde.

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

Causa: Erro durante a 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: Durante o uso do modelo Fun-Music, ocorreu uma exceção interna desconhecida no 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 no processo do algoritmo. / erro de inferência. / Ocorreu um erro interno durante o cálculo, 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 solicitar 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 de 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:

• Utilize saída em streaming. Consulte Saída em Streaming.

• 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: Durante o uso do modelo Fun-Music, a execução interna atingiu o tempo limite.

Solução: Tente realizar a chamada 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 de 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: Nenhuma api key fornecida. Você pode definir via dashscope.api_key = sua_api_key no código, ou configurar através da variável de ambiente DASHSCOPE_API_KEY= sua_api_key.

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

Solução: Consulte Configurando API Key como Variável de Ambiente para mais detalhes.

openai.OpenAIError: A opção de cliente api_key deve ser definida passando api_key ao cliente ou configurando a variável de ambiente OPENAI_API_KEY

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 variável de ambiente (consulte Configurando API Key como Variável de Ambiente) 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 no 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() gera 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 a síntese de fala em tempo real (CosyVoice), esse problema decorre de uma versão desatualizada do DashScope SDK.

Solução: Instale a versão mais recente do DashScope SDK.

NetworkError

NoApiKeyException: Não foi possível encontrar a 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 o FAQ para outros cenários.

ConnectException: Falha ao conectar a 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 usar uma rede ou servidor diferente.

InputRequiredException: Parâmetro inválido: text é nulo

Causa: Ao usar a síntese de fala em tempo real (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: Instale a versão mais recente do DashScope SDK.

mismatched_model

O modelo 'xxx' desta requisição não corresponde ao restante do batch. Cada batch deve conter requisições para um único modelo.

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

Solução: Verifique seu arquivo de entrada conforme descrito em Compatível com OpenAI - Batch (entrada de arquivo).

duplicate_custom_id

O custom_id 'xxx' desta requisição é duplicado em relação a outra requisição. O parâmetro custom_id deve ser único para cada requisição em um batch.

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

Solução: Verifique seu arquivo de entrada conforme descrito em Compatível com OpenAI - Batch (entrada de arquivo) para garantir que todos os IDs de requisição sejam únicos.

Capacidade de upload de arquivo excede o limite. / Quantidade de arquivos para upload excede o limite.

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

Solução: Exclua arquivos desnecessários através da interface Compatível com OpenAI - 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 excessivamente grandes.

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

TimeoutError: conexão websocket não pôde ser estabelecida em 5s. Verifique sua conexão de rede, configurações de firewall ou status do servidor.

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 do á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 da clonagem de voz CosyVoice pode não atender aos requisitos.

Solução: O formato de áudio deve ser WAV (16bit), MP3 ou M4A. Utilize 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, há erros de digitação nos parâmetros da requisição.

Solução: Verifique o código comparando-o com a 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, faça a seguinte verificação:

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 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, é normal não haver resultado de reconhecimento.

ASR_RESPONSE_HAVE_NO_WORDS

Causa: Se estiver usando 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 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 via rede pública.

FILE_CHECK_FAILED

Causa: Se estiver usando 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 (faixa única/dupla) ou MP3.

FILE_TOO_LARGE

Causa: Se estiver usando 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 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 pode ser reproduzido.

FILE_PARSE_FAILED

Causa: Se estiver usando 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 pode ser reproduzido.

MKV_PARSE_FAILED

Causa: Se estiver usando 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 pode ser reproduzido.

FILE_TRANS_TASK_EXPIRED

Causa: Se estiver usando 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 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 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 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 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 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 reconhecimento de arquivos gravados do Paraformer, a duração do arquivo excede 12 horas.

Solução: Divida o áudio em segmentos e envie múltiplas tarefas de reconhecimento. Utilize ferramentas como FFmpeg para dividir.

DECODE_ERROR

Causa: Se estiver usando reconhecimento de arquivos gravados do Paraformer, a detecção das 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ê utilizou um timbre padrão. Este modelo suporta apenas timbres clonados.

Solução: Utilize 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 não pode ser nulo

Causa: Ao usar a API WebSocket de síntese de fala CosyVoice, o payload de run-task ou finish-task não possui campo input, ou o payload de 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": {}.

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 desejada; (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 tenta acessar recursos de uma equipe (organização) para a qual 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 adequadas 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 em curto prazo aciona limitação temporária de taxa.

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