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.

Solução rápida de problemas

Se uma chamada falhar, localize os problemas comuns na tabela a seguir e confira o código e a mensagem de erro da resposta para consultar a causa e a solução específicas.

1. Identifique a causa do erro

Problema comum	Detalhes do erro	Investigação e resolução
401: Falha na autenticação	InvalidApiKey/invalid_api_key	Verifique se a API Key é válida e se a API Key, a região e a Base URL correspondem. Corrija e faça a chamada novamente.
403: Acesso negado	AccessDenied/access_denied	Com base na mensagem de erro, confira as permissões de acesso, a ativação do serviço e se a API aceita o modo de chamada síncrono ou assíncrono utilizado. Se a mensagem indicar inadimplência, consulte Arrearage.
404: Modelo, recurso ou caminho da API inexistente	ModelNotFound, NotFound	Verifique o nome do modelo, o nome da implantação ou o ID do recurso. Confirme se o modelo está disponível na região e se o caminho e o método de chamada atendem aos requisitos da API.
429: Limite de taxa ou de cota atingido	Throttling.RateQuota, Throttling.AllocationQuota/insufficient_quota	Identifique o limite específico pela mensagem de erro. Em caso de limitação de taxa, reduza a frequência das solicitações, a concorrência ou o uso de tokens por unidade de tempo. Se a cota gratuita se esgotar ou o número de recursos atingir o limite, siga a entrada correspondente antes de fazer novas chamadas.
400: Solicitação incorreta	InvalidParameter	Com base na mensagem de erro, confira os parâmetros, o formato da solicitação e os requisitos da API. Corrija e faça a chamada novamente.
5xx: Falha no processamento do serviço	InternalError, ServiceUnavailable	Siga a solução da entrada correspondente. Se for necessário corrigir a entrada ou a configuração, faça a correção antes de chamar novamente. Se a orientação for tentar mais tarde, aguarde antes de repetir.
Sem resposta HTTP: Falha de conexão ou tempo limite excedido	Erros de conexão do cliente	Verifique a conectividade de rede, o proxy e os tempos limite com base na exceção do cliente. Veja abaixo como tratar tempos limite após enviar tarefas ou criar recursos.

2. Retome as chamadas

• Problemas de parâmetros, autenticação, permissões ou cota: Após a correção correspondente, envie primeiro uma única solicitação e confirme que o resultado está normal.
• Limitação de taxa ou erros temporários que permitem novas tentativas: Em caso de limitação de taxa, reduza a frequência das solicitações ou a concorrência. Aumente gradualmente o intervalo entre tentativas e defina um número máximo de tentativas e um tempo total máximo. Pare quando qualquer um desses limites for atingido.
• Solicitações com estado de execução desconhecido: Se uma operação como criar um recurso ou enviar uma tarefa atingir o tempo limite ou perder a conexão, e a API permitir consultas, verifique primeiro o resultado da execução (por exemplo, com um ID de tarefa já retornado) antes de decidir reenviar. Se não for possível confirmar o estado, entre em contato com o suporte técnico para evitar a criação de recursos ou a execução de tarefas em duplicidade.
• Retomada das chamadas de negócio: Após confirmar que os resultados estão normais, aumente gradualmente o volume de chamadas e monitore se o mesmo erro volta a ocorrer. Para tarefas assíncronas, confirme o estado final e o resultado de saída.

3. Entre em contato com o suporte técnico

Se o problema persistir após as etapas acima, ou se não for possível confirmar o estado de execução da solicitação, interrompa as tentativas automáticas e entre em contato com o suporte técnico. Forneça as seguintes informações:

• Informações do erro: Código de status HTTP, código de erro, mensagem de erro e Request ID da resposta, se houver. Se usar Python Requests, consulte Bad Request for url para saber como ler os dados da resposta.
• Horário da ocorrência e ambiente da chamada: Horário e fuso horário, região, nome do modelo ou da implantação, endpoint e caminho da solicitação, versão do SDK ou do cliente e se a chamada usa streaming ou execução assíncrona.
• Exceção do cliente: Se não houver resposta HTTP, forneça o tipo de exceção, a etapa da chamada em que ela ocorreu e os logs relacionados.
• Medidas já tomadas: Configurações alteradas, tentativas realizadas e resultados após o tratamento.

Antes de enviar, remova API Keys, tokens de acesso, informações de autenticação Authorization e parâmetros de assinatura nas URLs. Oculte os dados de negócio nos logs, nas solicitações e nas respostas.

Use o Alibaba Cloud AI Assistant

Informe o código e a mensagem de erro ao Alibaba Cloud AI Assistant para obter sugestões de solução de problemas e a documentação oficial relevante.

Exemplo de pergunta:

Uma chamada a um modelo do Alibaba Cloud Model Studio retornou o erro a seguir. Como posso investigar o problema?
HTTP status: 429
Code: Throttling.RateQuota
Message: Requests rate limit exceeded, please try again later.

Como obter o Request ID?

O Request ID tem formato UUID (por exemplo, 649b2bbc-c541-9e16-9845-db7fe4fe5b2d) e está no cabeçalho ou no corpo da resposta da API. Registre esse valor quando uma chamada falhar para investigar o problema ou fornecê-lo ao abrir um ticket de suporte.

Se você não registrou o Request ID, acesse a página Model Monitoring e abra a aba Logs do modelo de destino para consultar os registros de chamadas, incluindo Request ID, código de status, código de erro e conteúdo da solicitação e da resposta.

Pré-requisitos:

• A conta principal ou um usuário RAM autorizado deve ativar os logs de inferência primeiro.
• O recurso oferece suporte apenas a determinados modelos nas regiões China (Beijing), Singapore e US (Virginia).
• Os dados têm um atraso da ordem de minutos. Não é possível consultar chamadas anteriores à ativação.

Para obter detalhes, consulte Monitoramento de modelos.

200

BailianGateway.Workspace.NotAuthorised

O console exibe uma mensagem de erro indicando que o uso de alguns recursos está restrito.

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.

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.

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.

暂时不支持当前设置的语种！

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-3.0-pro","input":{"messages":[{"role":"user","content":[{"image":"https://example.com/img.png"},{"text":"Change the image background to blue}]}]}}

Exemplo correto:

{"model":"qwen-image-3.0-pro","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 será descontinuado). 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. Para saber quais modelos oferecem suporte a saída estruturada apenas no modo sem raciocínio, consulte Modelos suportados.

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.7-plus), 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: Você solicitou saída de áudio, mas não ativou a saída em 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.7-plus em vez de Qwen/Qwen3.7-Plus.

The product is not activated, please confirm that you have activated products and try again after activation.

Causa: O serviço do modelo chamado não foi ativado. Ao usar a API compatível com OpenAI, se o modelo de destino não estiver ativado no Model Marketplace, o gateway retornará esse erro com o código invalid_parameter_error.

Solução:

• Ative o serviço do modelo: Acesse o Model Marketplace no console do Alibaba Cloud Model Studio e confirme que o modelo chamado (como kimi-k3) está ativado antes de fazer a chamada.
• Ative o Model Studio: Se o serviço Alibaba Cloud Model Studio ainda não estiver ativado, ative-o antes de fazer chamadas.

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.

Repetitive tool calls detected in the conversation history. The same tool call with identical name and arguments has been repeated across multiple consecutive rounds. Please modify your request or adjust the tool call arguments to avoid infinite loops.

Causa: Foram detectadas chamadas de ferramenta repetidas no histórico da conversa: chamadas com exatamente o mesmo nome e argumentos aparecem em várias rodadas consecutivas. O modelo pode estar preso em um loop. O código de status HTTP desse erro é 400, e o código de erro é InternalError.Algo.InvalidParameter.

Solução:

• Após cada rodada de chamadas de ferramenta, acrescente os resultados da execução como uma Tool Message ao array messages antes de enviar a próxima solicitação. Assim, o modelo pode avançar com base nos resultados em vez de repetir a mesma chamada.
• Verifique se a ferramenta retorna resultados normalmente. Se ela continuar retornando resultados iguais ou inválidos, adicione na aplicação um limite de chamadas de ferramenta ou uma lógica de encerramento para evitar loops infinitos.
• Se necessário, ajuste o prompt para definir claramente as condições de conclusão da tarefa e evitar que o modelo repita a mesma chamada de ferramenta.

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.7-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 da rede local com dashscope.aliyuncs.com e descartar bloqueios de rede ou firewall.
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, qwen3-vl-max: até 2 GB;
  • Série qwen3-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.

• Permitir DashScopeUserBot

  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.

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

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.7-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 API de clonagem e design de voz CosyVoice.

• 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

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

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.

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

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.

Invalid video file.

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.

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

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 o Qwen-Omni-Turbo aceitam vídeos com duração entre 2 e 40 segundos.

Para os limites de vídeo de outros modelos Qwen-Omni, consulte Entrada de modalidade única.

Field required: 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.

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

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.

Missing training files.

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

The style is invalid.

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

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

The style_level is invalid.

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

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

parameters.video_ratio must be 9:16 or 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".

the xxx parm is invalid!

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

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

input json error.

Causa: O JSON de entrada é inválido.

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

read image error.

Causa: Falha ao ler a imagem.

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

the parameters must conform to the specification: 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.

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

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.

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

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.

image format error

Causa: O formato da imagem está incorreto.

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

No messages found in input

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

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

Invalid image format or corrupted file

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.

download image failed

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.

lack of image or text

Causa: Os parâmetros da solicitação estão sem o campo image ou text.

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

num_images_per_prompt must be 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.

Input files format not supported.

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.

Failed to download input files.

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.

oss download error.

Causa: Falha no download da imagem de entrada.

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

The image content does not comply with green network verification.

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.

read video error.

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.

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

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.

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

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

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

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

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

request timeout after 23 seconds.

Causa: Nenhum dado foi enviado para o service por mais de 23 segundos. Este erro ocorre ao usar Reconhecimento de fala (Paraformer) e real-time speech synthesis (Qwen-Audio-TTS/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.

Please ensure input text is valid.

Causa: Se você estiver usando real-time speech synthesis (Qwen-Audio-TTS/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.

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

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 (Qwen-Audio-TTS/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 API de clonagem e design de voz CosyVoice 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 (Qwen-Audio-TTS/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 and obj_or_bg must be the same length.

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.

check input data style.

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

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

An error during model pre-process.

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?"}].

The image size is not supported for the data inspection.

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.

Wrong Content-Type of multimodal url

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.

Field required: image_url

Causa: Parâmetro de entrada image_url ausente.

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

Field required: driven_id

Causa: Parâmetro de entrada driven_id ausente.

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

Invalid ext_bbox

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

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

Driven not exist: driven_id

Causa: O driven_id fornecido não existe.

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

Text request limit violated, expected 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.

SSML text is not supported at the moment!

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

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

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.

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

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.

invalid_request_error-invalid_value

-1 is lesser than the minimum of 0 - 'seed'/'seed' must be 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].

invalid_request_error

you must provide a model parameter.

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

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

InvalidParameter.NotSupportEnableThinking

The model xxx does not support 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.

invalid_value

The requested voice 'xxx' is not supported.

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.

Arrearage

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

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.

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

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 Access denied, please make sure your account is in good standing. 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 serviço foi suspenso. A causa subjacente é a mesma de Arrearage (Access denied, please make sure your account is in good standing.) nesta seção: inadimplência da conta.

Solução: Acesse Expenses and Costs para recarregar sua conta Alibaba Cloud. O serviço é retomado automaticamente quando o saldo for suficiente.

Contain.Forbidden.Label.Error

contain forbidden create order label

Causa: A conta Alibaba Cloud tem um rótulo que proíbe a criação de pedidos. A solicitação foi bloqueada e o pedido não pode ser criado.

Solução: Consulte o resultado do Diagnóstico de códigos de erro. Entre em contato com o atendimento ao cliente para confirmar o motivo da inclusão do rótulo e solicitar sua remoção. Faça o pedido novamente após a remoção.

DataInspectionFailed/data_inspection_failed

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

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.

Input xxx data may contain inappropriate content.

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.

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

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.

InvalidFile.DownloadFailed

The audio file cannot be downloaded.

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

InvalidFile.AudioLengthError

Audio length must be between 1s and 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.

Audio length must be between 1s and 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.

InvalidFile.NoHuman

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

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

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

InvalidFile.BodyProportion

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

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.

InvalidFile.FacePose

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

Causa: A pose facial na imagem enviada não atende aos requisitos (o rosto deve estar visível e a orientação da cabeça não deve apresentar desvios acentuados).

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

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

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.

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

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.

InvalidFile.Resolution

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

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.

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

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.

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

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.

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

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.

Invalid video resolution. The height or width of video must be 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.

InvalidFile.FPS

Invalid video FPS. The video FPS must be 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.

InvalidFile.Value

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

Causa: A imagem enviada está muito escura.

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

InvalidFile.FrontBody

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

Causa: A imagem enviada mostra a pessoa de costas.

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

InvalidFile.FullFace

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

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.

InvalidFile.FaceNotMatch

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

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

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

InvalidFile.Content

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

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

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

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

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.

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

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.

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

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.

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

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.

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

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

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

InvalidFile.FullBody

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

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

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

The pose of the detected person is invalid, please upload other image with whole body, or change the ratio parameter to 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.

InvalidFile.BodyPose

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

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 a orientação do corpo não deve apresentar desvios acentuados.

InvalidFile.Size

Invalid file size. The video file size must be less than 200MB, and the audio file size must be less than 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.

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

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

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

Invalid file size. The video/audio/image file size must be less than 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.

InvalidFile.Duration

Invalid file duration. The file duration must be 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.

InvalidFile.ImageSize

The size of image is beyond limit.

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.

InvalidFile.AspectRatio

Invalid file ratio. The file aspect ratio (height/width) must be between 3:1 and 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.

Invalid file ratio. The file aspect ratio (height/width) must be between 2.0 and 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.

InvalidFile.Openerror

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

Causa: O arquivo não pode ser aberto.

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

InvalidFile.Template.Content

Invalid template content.

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.

InvalidFile.Format

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

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.

InvalidFile.MultiHuman

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

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

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

InvalidPerson

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

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.

InvalidParameter.DataInspection

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

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 na China antes de chamar o modelo. Alternativamente, use o temporary storage space para enviar arquivos.

FlowNotPublished

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

Causa: O fluxo não está publicado.

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

InvalidImage.ImageSize

The size of image is beyond limit.

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.

InvalidImage.NoHumanFace

No human face detected.

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.

InvalidImageResolution

The input image resolution is too large or small.

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.

InvalidImageFormat

The input image is in invalid format.

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

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

InvalidURL

Invalid URL provided in your request.

Causa: A URL é inválida.

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

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

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

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

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

Causa: A URL de entrada é inválida.

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

The input audio is longer than 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 no máximo xx segundos.

File size is larger than 15MB.

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

Solução: Comprima o arquivo de áudio para no máximo 15 MB.

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

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

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

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

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.

InvalidImage.FileFormat

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

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

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

InvalidURL.ConnectionRefused

Connection to xxx refused, please provide available URL.

Causa: O download foi recusado.

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

InvalidURL.Timeout

Download xxx timeout, please check network connection.

Causa: Timeout no download.

Solução: Verifique a conectividade de rede.

BadRequestException

Invalid part type.

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.

BadRequest.EmptyInput

Required input parameter missing from request.

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

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

BadRequest.EmptyParameters

Required parameter "parameters" missing from request.

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

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

BadRequest.EmptyModel

Required parameter "model" missing from request.

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

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

BadRequest.IllegalInput

The input parameter requires json format.

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.

BadRequest.InputDownloadFailed

Failed to download the input file: 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.

Failed to download the input file.

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

BadRequest.UnsupportedFileFormat

File format unsupported.

Causa: Ao usar 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 do Linux/macOS) para verificar o formato real de codificação de áudio.

Input file format is not supported.

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

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

BadRequest.TooLarge

Payload Too Large.

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.

BadRequest.ResourceNotExist

The Required resource not exist.

Causa:

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

Throttling.AllocationQuota

您当前的配额为xxx

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

Solução: Exclua alguns timbres.

Maximum voice storage limit exceeded, please delete existing voices.

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

Solução: Exclua alguns timbres.

InvalidGarment

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

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

InvalidSchema

Database schema is invalid for 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.

InvalidSchemaFormat

Database schema format is invalid for 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.

Audio. AudioShortError

valid audio too short!

Causa: A duração efetiva do áudio para Clonagem de voz CosyVoice é muito curta.

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

Audio. AudioSilentError

silent audio error.

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

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

InvalidInputLength

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

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

Solução: Ajuste a imagem conforme os requisitos da mensagem de erro: o lado mais longo deve ter menos de 4096 pixels, o lado mais curto deve ter mais de 150 pixels e o tamanho do arquivo deve estar entre 5 KB e 5 MB.

FaqRuleBlocked

Input or output data is blocked by faq rule.

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

ClientDisconnect

Client disconnected before task finished!

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.

ServiceUnavailableError

Role must be user or assistant and Content length must be greater than 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.

IPInfringementSuspect

Input data is suspected of being involved in IP infringement.

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.

UnsupportedOperation

The operation is unsupported on the referee object.

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.

The fine-tune job can not be deleted because it is succeeded,failed or 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.

CustomRoleBlocked

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

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.

Audio.PreprocessError

Audio preprocess error.

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.

No segments meet minimum duration requirement

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.

BadRequest.VoiceNotFound

Voice '%s' not found.

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.

Audio.DecoderError

Decoder audio file failed.

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 o áudio atenda aos requisitos de formato de arquivo de áudio (por exemplo, para Qwen-TTS) ou use WAV (16bit), MP3 ou M4A (para CosyVoice).

Audio.AudioRateError

File sample rate unsupported.

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.

Audio.DurationLimitError

Audio duration exceeds maximum allowed limit.

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

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

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 Integração com ferramentas de IA 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.

NOT AUTHORIZED

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

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.

invalid access token or token expired

invalid access token or token expired.

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.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
• Endpoint compatível com OpenAI: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1

403

AccessDenied/access_denied

Current user api does not support asynchronous calls.

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

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

current user api does not support synchronous calls.

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

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

Invalid according to Policy: Policy expired.

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.

Access denied.

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.

Access denied by API-Key restrictions.

Causa: A API Key atual tem um Model access scope configurado por meio de permissões personalizadas. O modelo solicitado não está na lista permitida para essa Key. O gateway recusa diretamente a solicitação e retorna HTTP 403 access_denied.

Solução:

• Acesse a página API Key no console do Alibaba Cloud Model Studio e edite as permissões dessa API Key. Altere Permissions para All ou selecione o modelo de destino na lista Model access scope das permissões Custom.
• Você também pode criar uma nova API Key com a permissão All e tentar novamente.
• A restrição se aplica à API compatível com OpenAI e à API nativa do DashScope. Alterar a Base URL não permite contorná-la. Confirme que a API Key usada na chamada tem permissão para o modelo de destino.

AccessDenied.Unpurchased

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

Causa:

• O serviço Alibaba Cloud Model Studio não foi ativado.
• Se você usa uma conta de revendedor, os recursos dessa conta diferem dos de uma conta Alibaba Cloud Model Studio. Alguns modelos ainda não podem ser adquiridos pela interface do revendedor e precisam ser ativados com uma conta Alibaba Cloud comum.

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

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

2. Selecione uma região: O Alibaba Cloud Model Studio oferece suporte a várias regiões. Os endpoints, modelos disponíveis e preços podem variar. Acesse o console do Model Studio para escolher a região adequada.

3. Complete as informações: Use a conta principal Alibaba Cloud para acessar a página de preenchimento de informações e fornecer os dados necessários. Para obter instruções, consulte Registrar uma conta Alibaba Cloud.

   • Para usar os serviços de modelo na região China (Beijing) (China continental), use a conta principal Alibaba Cloud para concluir a verificação de identidade. Selecione individual users ou upgrade to enterprise, conforme seu caso, e clique em Verify Now. Em seguida, solicite Purchase cloud resources in the Chinese mainland or use acceleration regions that include it. Para obter detalhes, consulte Visão geral da verificação de conta.

4. Ative o Alibaba Cloud Model Studio: Use a conta principal Alibaba Cloud para acessar o Alibaba Cloud Model Studio. Após ler e aceitar o contrato, o serviço será ativado automaticamente. Se o contrato de serviço não aparecer, o serviço já está ativado.

Model.AccessDenied

Model access denied.

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 Autorização para chamadas de modelos.
• 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.

App.AccessDenied

App access denied.

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.

Workspace.AccessDenied

Workspace access denied.

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.

Endpoint.AccessDenied

Workspace endpoint access denied.

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.

AllocationQuota.FreeTierOnly

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

Causa 1: Um novo usuário fez uma solicitação após esgotar a cota gratuita.

Solução: Complete as informações da conta antes de fazer novas chamadas.

Causa 2: Você ativou a interrupção ao esgotar a cota gratuita e fez uma solicitação após o esgotamento da cota.

A cota gratuita exibida no console é atualizada na escala de minutos. Atualize a página manualmente para consultar os dados atualizados.

Solução:

• Para continuar com chamadas pagas, você pode desativar a interrupção ao esgotar a cota gratuita a qualquer momento, sem esperar que a cota termine. Depois de desativá-la, as chamadas podem continuar com pagamento conforme o uso.
• Se o problema ocorrer com o Coding Plan, geralmente é causado por uma configuração incorreta. O Coding Plan exige uma Base URL e uma API Key exclusivas. Para obter detalhes, consulte Início rápido do Coding Plan.
• Se o erro persistir após desativar a opção, ou se o console mostrar cota disponível, mas as chamadas ainda forem recusadas, verifique se a API Key mudou ou deixou de ser válida. Redefina a API Key ou crie uma nova Key e teste novamente.
• Se não houver um registro correspondente à solicitação no console, ela pode não ter chegado ao servidor. Verifique a configuração do plugin do cliente e a conexão de rede local.

404

ModelNotFound/ model_not_found

The provided model xxx is not supported by the 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.

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

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

Solução:

• Compare o nome do modelo inserido (valor do parâmetro model) com os nomes na Lista de modelos.

• Acesse o Model Marketplace para ativar o serviço do modelo.

• Se você usar um endpoint de API do site internacional (como {WorkspaceId}.us-east-1.maas.aliyuncs.com), os modelos disponíveis variam por região. Antes de fazer a chamada, confirme que o modelo de destino está disponível nessa região.

• Se ocorrer ModelNotFound ao chamar um modelo por um endpoint de implantação dedicada, verifique também os dois pontos a seguir:

  1. Use o nome da implantação: No endpoint de implantação dedicada, o parâmetro model deve conter o nome da implantação (model code), e não o nome do modelo. Esse nome está disponível na página Dedicated Deployment do console do Model Studio e tem um formato como qwen3.5-flash-2026-02-23-9439a8e1eafa. Usar o nome do modelo em um endpoint de implantação dedicada, ou o nome da implantação em um endpoint de API padrão, retorna model_not_found.
  2. Distinga os métodos de chamada: Chamadas gerais usam o endpoint de API padrão e o nome do modelo. Chamadas de implantação dedicada usam a URL do endpoint dedicado e o nome da implantação. Não misture essas combinações. As API Keys para chamadas gerais e de implantação dedicada também podem ser diferentes; misturá-las causa o erro de autenticação invalid_api_key.

model_not_supported

Unsupported model xxx for OpenAI compatibility mode.

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

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

WorkSpaceNotFound

WorkSpace can not be found.

Causa: O workspace não existe.

Solução: Confirme que o valor de {WorkspaceId} na Base URL está correto. {WorkspaceId} é o ID do seu workspace do Model Studio, disponível na página Workspace Management. Se o erro persistir, confirme que sua conta é membro desse workspace.

NotFound

Not found!

Causa:

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

Solução:

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

Request path not found.

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

Requests throttling triggered.

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

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

Too many requests in route. Please try again later.

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

Solução: Tente novamente mais tarde.

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

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.

Throttling.RateQuota/LimitRequests/limit_requests/ResourceExhausted/Too many requests

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

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 Current user api does not support asynchronous calls. em 403-AccessDenied/access_denied neste tópico.

Throttling.BurstRate/limit_burst_rate

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

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.

Throttling.AllocationQuota/insufficient_quota

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

Causa: O consumo de tokens por segundo ou minuto (TPS/TPM) acionou a limitação de taxa.

Solução: Consulte os limites dos modelos em Limitação de taxa e ajuste sua estratégia de chamada. Se a cota padrão não atender às necessidades do negócio, entre em contato com seu gerente de conta para solicitar um aumento.

Consulte as Perguntas frequentes para evitar a limitação de taxa.

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

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.

Free allocated quota exceeded.

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

Maximum voice-clone voice limit exceeded.

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

Solução: Exclua alguns timbres.

Throttling.Concurrency

Too many concurrent requests.

Causa: O número atual de solicitações simultâneas excede o limite alocado dinamicamente pela plataforma.

Solução: Aguarde um momento e tente novamente. A plataforma ajusta dinamicamente o limite de concorrência de acordo com a carga geral dos recursos. Essa restrição pode ser acionada nos horários de pico.

Throttling.ServiceOverloaded

InternalError.Algo: An error occurred in model serving, error message is: [Too many requests.]

Causa: Os recursos de rede estão sobrecarregados no momento e não podem processar sua solicitação temporariamente.

Solução: Tente novamente mais tarde.

Throttling.ResourceExhausted

InternalError.Algo: An error occurred in model serving, error message is: [Too many requests.]

Causa: Os recursos de rede estão saturados no momento e não podem processar sua solicitação temporariamente.

Solução: Tente novamente mais tarde.

CommodityNotPurchased

Commodity has not purchased yet.

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

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

PrepaidBillOverdue

The prepaid bill is overdue.

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

PostpaidBillOverdue

The postpaid bill is overdue.

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

BudgetLimitExceeded

The budget configured in Budget Management has been exhausted. You will be unable to make further API calls until the budget limit is increased or reset.

Causa: O valor definido em Gerenciamento de orçamento foi esgotado, e a opção Stop Service When Budget Reached está ativada.

Solução: Aumente o orçamento ou desative Stop Service When Budget Reached na página Budget Management para retomar as chamadas.

430

Audio.DecoderError

Decoder audio file failed.

Causa: A decodificação do arquivo de áudio Clonagem de voz CosyVoice 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.

Audio.FileSizeExceed

File too large

Causa: O tamanho do arquivo de áudio Clonagem de voz CosyVoice excede o limite.

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

Audio.AudioRateError

File sample rate unsupported

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

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

Audio.AudioSilentError

Silent file unsupported.

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

Solução: Procure manter 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

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

Causa: Erro interno.

Solução:

• Se estiver usando um modelo Qwen-Omni e a API utilizada exigir saída em streaming, defina stream=true.

• Se estiver usando o Clonagem de voz CosyVoice, 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 Orientações de gravação e tente novamente.
  • A URL do arquivo de gravação está inacessível. Siga as instruções em API de clonagem e design de voz CosyVoice 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.

Internal server error!

Causa: Erro interno do algoritmo.

Solução: Tente novamente mais tarde.

audio preprocess server error

Ao usar o Clonagem de voz CosyVoice:

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

  Solução: Consulte Orientações de gravação e tente novamente.

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

  Solução: Siga as instruções em API de clonagem e design de voz CosyVoice 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.

request asr failed

Causa: Ao usar o Clonagem de voz CosyVoice, 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 Orientações de gravação e tente novamente.

Remote cancelled grpc stream.

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 (Qwen-Audio-TTS/CosyVoice) para ver os timbres disponíveis.

InternalError.FileUpload

oss upload error.

Causa: Falha no upload do arquivo.

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

InternalError.Upload

Failed to upload result.

Causa: Falha no upload do resultado.

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

InternalError.Algo

inference internal error.

Causa: Exceção no service.

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

Expecting ',' delimiter: line x column xxx (char 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.

Missing Content-Length of multimodal url.

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.

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

Causa: Erro no servidor backend do service de modelo.

Solução: Tente novamente mais tarde.

An error occurred in model serving, error message is: [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.

An internal error has occured during algorithm execution.

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

Solução: Tente novamente mais tarde.

Inference error: Inference error.

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 must be in [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.

Receive batching backend response failed!

Causa: Erro interno do service.

Solução: Tente novamente mais tarde.

[music]Receive batching backend response failed!

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.

Other kinds of server error.

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.

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

Causa: Erro interno do algoritmo.

Solução: Tente novamente mais tarde.

list index out of range

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", ...}.

InternalError.Timeout

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

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.

SystemError

An system error has occured, please try again later.

Causa: Erro de sistema.

Solução: Tente novamente mais tarde.

ModelServiceFailed

Failed to request model service.

Causa: Falha na chamada do service de modelo.

Solução: Tente novamente mais tarde.

RequestTimeOut

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

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.

ResponseTimeout

Response stream timeout

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

Solução: Tente chamar novamente.

InvokePluginFailed

Failed to invoke plugin.

Causa: Falha na invocação do plugin.

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

AppProcessFailed

Failed to proceed application request.

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

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

RewriteFailed

Failed to rewrite content for prompt.

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

Solução: Tente novamente mais tarde.

RetrivalFailed

Failed to retrieve data from documents.

Causa: Falha na recuperação de documentos.

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

ServiceUnavailable

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

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

Solução: Tente novamente mais tarde.

503

ServiceUnavailable

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

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

Solução: Tente novamente mais tarde.

ModelUnavailable

Model is unavailable, please try again later.

Causa: Modelo temporariamente indisponível.

Solução: Tente novamente mais tarde.

Erros de SDK, conexão e outros

As seções a seguir listam mensagens de erro por exceções de SDK, problemas de conexão e outros cenários de chamada. Compare a mensagem de erro completa e siga a entrada correspondente para investigar o problema. Códigos de fechamento do WebSocket e códigos de status HTTP são identificadores diferentes.

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

Connection error.

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

Solução: Desative ou reinicie o proxy.

The operation was canceled. / Connection reset

Causa: Um tempo limite muito curto no cliente ou oscilações de rede podem cancelar a solicitação (por exemplo, The operation was canceled) ou redefinir a conexão (por exemplo, Connection reset).

Solução:

• Aumente o tempo limite do cliente conforme necessário, por exemplo, para mais de 50 segundos.
• Use o comando curl para testar a conectividade e descartar problemas na rede local.

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 Configurar a API Key como variável de ambiente 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 Configurar a 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 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 for url:xxx

Causa: No Python Requests, response.raise_for_status() gera uma exceção HTTPError para uma resposta HTTP de erro. A exceção preserva response, incluindo o corpo da resposta do servidor.

Solução: Após capturar HTTPError, leia status_code e text do response original ou do response da exceção. Use response.json() para ler detalhes estruturados do erro somente após confirmar que o corpo pode ser analisado como JSON. Trate separadamente falhas de transporte que não produzam uma resposta HTTP, como falhas de conexão ou tempos limite. Não suponha que exista um corpo de resposta do servidor.

Cannot resolve symbol 'ttsv2'

Causa: Se estiver usando real-time speech synthesis (Qwen-Audio-TTS/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 Perguntas frequentes 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 (Qwen-Audio-TTS/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.

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

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

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

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.

unsupported audio format: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 (como o comando file do Linux/macOS) para verificar o formato real de codificação.

internal unknown error

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 (como ffprobe ou mediainfo) ou comandos para verificar o formato real de codificação.

Invalid backend response received (missing status name)

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

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 todo o áudio não contiver fala válida (por exemplo, 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 e disponível para download 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 o campo text, e que seu valor não seja uma string vazia.
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.

Coding Plan

Connection error

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.

hour allocated quota exceeded

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

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

week allocated quota exceeded

Causa: Cota de requisições semanais esgotada.

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

month allocated quota exceeded

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.

concurrency allocated quota exceeded

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.

usage allocated quota exceeded. please try again later.

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: Em geral, é possível retomar o uso após aguardar uma hora. Divida tarefas grandes em menores e envie-as ao longo do tempo.