Mensagens de erro

Referência do código de erro da API

Mensagens de erro de QwenCloud e suas soluções.

400-InvalidParameter

parâmetro.enable_thinking deve ser definido como falso para chamadas que não sejam de streaming/ parâmetro.enable_thinking suporta apenas chamadas de fluxo

Causa: O modelo não suporta enable_thinking com chamadas sem streaming.

Solução: Definir enable_thinking para false, use transmissão ou mude para um modelo que suporte o pensamento sem streaming (como qwen3.7-max e qwen3.5-plus).

O parâmetro thinking_budget deve ser um número inteiro positivo e não maior que xxx

Causa: thinking_budget está fora do alcance.

Solução: Defina como um número inteiro positivo dentro do comprimento máximo de raciocínio do modelo. Consulte o Mercado Modelo.

Este modelo suporta apenas o modo stream, habilite o parâmetro stream para acessar o modelo.

Causa: O modelo requer saída de streaming.

Solução: Habilite saída de streaming.

Este modelo não suporta enable_search.

Causa: O modelo não é compatível com pesquisa na Web.

Solução: use um modelo compatível com pesquisa na Web ou defina enable_search para false.

As configurações de idioma atuais não são suportadas!

Causa: Inválido source_lang ou target_lang formato ou idioma não suportado.

Solução: Use o nome em inglês ou código de idioma correto.

O parâmetro incremental_output deve ser "true" quando enable_thinking for verdadeiro

Causa: O modo de pensamento requer saída de streaming incremental.

Solução: Definir incremental_output para true.

O parâmetro incremental_output deste modelo não pode ser definido como False.

Causa: o modelo requer saída de streaming incremental.

Solução: Definir incremental_output para true.

O intervalo de comprimento de entrada deve ser [1, xxx] (InternalError.Algo.InvalidParameter)

Causa: A entrada excede o limite de token do modelo.

Solução:

• Chamadas de API: Mantenha o array de mensagens dentro do limite de token do modelo.

• Conversas de chat: inicie uma nova conversa quando o histórico exceder o limite.

O intervalo de max_tokens deve ser [1, xxx]

Causa: max_tokens está fora do alcance.

Solução: Defina um valor entre 1 e os tokens de saída máximos do modelo. Consulte o Mercado Modelo.

A temperatura deve estar em [0,0, 2,0)/'temperatura' deve ser flutuante

Causa: temperature está fora do alcance.

Solução: Defina um valor em [0,0, 2,0).

O intervalo de top_p deve ser (0.0, 1.0]/'top_p' deve ser Float

Causa: top_p está fora do alcance.

Solução: Defina um valor em (0,0, 1,0].

Parâmetro top_k ser maior ou igual a 0

Causa: top_k é menor que 0.

Solução: Defina um valor ≥ 0.

Repetição_penalidade deve ser maior que 0,0

Causa: repetition_penalty é ≤ 0.

Solução: Defina um valor > 0.

Presence_penalty deve estar em [-2.0, 2.0]

Causa: presence_penalty está fora do alcance.

Solução: Defina um valor em [-2.0, 2.0].

O intervalo de n deve ser [1, 4]

Causa: n está fora do alcance.

Solução: Defina um valor em [1, 4].

O intervalo da semente deve ser [0, 9223372036854775807]

Causa: seed está fora do alcance (protocolo DashScope).

Solução: Defina um valor em [0, 9223372036854775807].

O método de solicitação 'GET' não é suportado.

Causa: API não suporta GET.

Solução: Usar POST. Consulte a referência da API.

Mensagens com função "ferramenta" devem ser uma resposta a uma mensagem anterior com "ferramenta_calls"

Causa: Falta uma mensagem do assistente na sequência de chamada da ferramenta.

Solução: inclua a mensagem do assistente da primeira resposta do modelo antes da mensagem da ferramenta.

Uma mensagem do assistente com "tool_calls" deve ser seguida por mensagens da ferramenta respondendo a cada "tool_call_id"

Causa: uma mensagem do assistente que contém tool_calls deve ser seguido por mensagens com o tool função que responde a cada tool_call_id. Este erro geralmente indica que a sequência de mensagens enviada à API durante a chamada da ferramenta 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_callse antes de enviar a próxima mensagem do usuário, insira as mensagens correspondentes com o tool papel. Cada uma dessas mensagens deve conter o correspondente tool_call_id e o resultado da execução dessa ferramenta. Cada tool_call_id na mensagem do assistente deve ser respondida por exatamente um tool mensagem.

Corpo obrigatório inválido, verifique o formato do corpo da solicitação.

Causa: Formato do corpo da solicitação inválido.

Solução: certifique-se de que o corpo da solicitação seja JSON válido. Problemas comuns incluem vírgulas finais (,), colchetes não fechados e aspas não fechadas.

Exemplo incorreto (o text campo está sem aspas de fechamento, então o corpo não é JSON válido):

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

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

o conteúdo de entrada deve ser uma string.

Causa: Os modelos somente texto não suportam conteúdo do tipo array.

Solução: Use conteúdo de string, não arrays como [{"type": "text","text": "..."}].

O campo de conteúdo é obrigatório.

Causa: Desaparecido content parâmetro (como {"role": "user"}).

Solução: Adicionar content, como {"role": "user","content": "Who are you"}.

a API do usuário atual não suporta chamadas http.

Causa: O modelo não suporta saída sem streaming.

Solução: Use saída de streaming.

"Prompt" ou "mensagens" devem existir e não podem ser ambos nenhum

Causa: Desaparecido messages ou prompt parâmetro ou formato errado.

Solução: Especifique messages. Para DashScope-HTTP, coloque messages dentro do input objeto. Veja Qwen Referência da API.

'messages' deve conter a palavra 'json' de alguma forma, para usar 'response_format' do tipo 'json_object'.

Causa: Saída estruturada requer "json" no prompt.

Solução: adicione "json" (sem distinção entre maiúsculas e minúsculas) ao prompt, como "Saída em formato json".

A resposta do modo Json não é suportada quando enable_thinking é verdadeiro

Causa: Saída estruturada não funciona com o modo de pensamento.

Solução: Definir enable_thinking para false. Consulte Como os modelos no modo de pensamento produzem resultados estruturados?

Os nomes das ferramentas não podem ser [search]

Causa: O nome da ferramenta não pode ser "pesquisa".

Solução: Use um nome de ferramenta diferente.

Formato desconhecido de response_format, response_format deve ser um dict, inclui 'type' e uma chave opcional 'json_schema'. O tipo de resposta_format do usuário é xxx.

Causa: Inválido response_format.

Solução: Defina como {"type": "json_object"} para saída estruturada.

O valor do parâmetro enable_thinking é restrito a True.

Causa: O modelo requer modo de pensamento (como qwen3.7-plus).

Solução:

• No código: Definir enable_thinking para true.

• Em ferramentas de terceiros (como Cherry Studio): Habilite o pensamento na caixa de entrada.

saída de 'áudio' suportada apenas com stream=true

Causa: Qwen-Omni requer saída de streaming.

Solução: Definir stream para true.

tool_choice é uma das strings que deveria ser ["none", "auto"]

Causa: Inválido tool_choice valor.

Solução: Use "auto" (o modelo escolhe) ou "none" (sem ferramenta).

Modelo não existe.

Causa: Inválido ou inexistente model parâmetro.

Solução:

• Formato do nome do modelo: Verifique a caixa e remova espaços extras.

• Nome correto do modelo: Use QwenCloud IDs de modelo (como qwen3.7-plus), e não nomes de comunidades (como Qwen/Qwen3.7-Plus). Consulte o Mercado Modelo.

O produto não está ativado, confirme se você ativou os produtos e tente novamente após a ativação.

Causa: O serviço de modelo não foi ativado. Ao chamar através do endpoint compatível com OpenAI, o gateway retorna este erro (código de erro invalid_parameter_error) se o modelo de destino não tiver sido ativado no catálogo de modelos.

Solução:

• Ative o modelo: Vá para o Model Marketplace, confirme se o modelo que você está chamando (como kimi-k3) está ativado e tente novamente.
• Ativar QwenCloud: Se você não ativou QwenCloud, ative-o antes de fazer chamadas de API.

O parâmetro result_format deve ser "message" quando enable_thinking for verdadeiro

Causa: O modo de pensamento requer result_format = "message".

Solução: Definir result_format para "message".

O áudio está vazio

Causa: O áudio é muito curto.

Solução: Use um arquivo de áudio mais longo.

Análise de arquivo em andamento. Tente novamente mais tarde.

Causa: O arquivo ainda está sendo analisado para processamento de documentos.

Solução: aguarde a conclusão da análise e tente novamente.

O parâmetro "stop" deve ser do tipo "str", "list[str]", "list[int]" ou "list[list[int]]", e todos os elementos da lista devem ser do mesmo tipo.

Causa: Inválido stop formato do parâmetro.

Solução: Usar str, list[str], list[int], ou list[list[int]]. Veja Qwen Referência da API.

Erro de valor, o tamanho do lote é inválido, não deve ser maior que xxx.

Causa: Muitos textos para o modelo de incorporação.

Solução: Mantenha a contagem de entradas dentro do tamanho do lote do modelo. Consulte Incorporação.

[] é muito curto

Causa: Matriz de mensagens vazia.

Solução: adicione pelo menos uma mensagem.

A chamada de ferramenta não é suportada.

Causa: O modelo não suporta chamada de ferramenta.

Solução: Mude para um Qwen ou DeepSeek modelo que suporta chamada de função.

A entrada de mensagens fornecida é inválida. A informação do erro é [Tipo de item inesperado no conteúdo] / A entrada deve ser uma string válida / A entrada deve ser um dicionário ou instância válida de ... (input.messages.x.content...)

Causa: O content campo de uma mensagem no messages array contém um item de um tipo não suportado. Quando content é uma matriz, cada elemento deve ser uma string ou um objeto válido (como {"type": "text", "text": "..."} ou {"type": "image_url", ...}). Passando um número, booleano, array aninhado ou um objeto cujo type não é 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 somente texto (como o Qwen-Max série de textos, incluindo qwen3.7-max) e o messages (especialmente o histórico de conversas múltiplas) contêm multimodais content itens como imagens (image_url), esse erro também é acionado porque os modelos somente texto não aceitam entradas de imagem ou de outra modalidade. Em algumas ferramentas ou agentes integrados, esse erro pode aparecer como uma mensagem como "o provedor do modelo retornou conteúdo vazio".

Solução:

• Modelos somente texto: Definir content para uma string em vez de uma matriz ou qualquer outro tipo. Se o seu caso de uso exigir imagem ou outra entrada multimodal, mude para um modelo multimodal (como o Qwen-VL ou Qwen3-VL série). Se você precisar continuar usando um modelo somente texto, remova itens multimodais, como imagens (image_url) de messages e o histórico de conversas antes de ligar.

• Modelos multimodais: Cada elemento no content array deve ser um objeto válido cujo type é um dos tipos de modalidade suportados pelo modelo, como text, image_url, video_url, ou video. Não inclua números, booleanos, matrizes aninhadas ou elementos ausentes type ou cujo type o valor é inválido.

Chamadas repetitivas de ferramentas detectadas no histórico de conversas. A mesma chamada de ferramenta com nome e argumentos idênticos foi repetida em várias rodadas consecutivas. Modifique sua solicitação ou ajuste os argumentos de chamada da ferramenta para evitar loops infinitos.

Causa: uma chamada de ferramenta repetitiva foi detectada no histórico de conversas. Uma chamada de ferramenta com exatamente o mesmo nome e argumentos foi repetida em várias rodadas consecutivas, o que indica que o modelo pode estar em loop. O código de status HTTP correspondente é 400 e o código de erro é InternalError.Algo.InvalidParameter.

Solução:

• Após cada chamada de ferramenta, anexe o resultado da execução da ferramenta como uma mensagem de ferramenta ao messages array antes de enviar a próxima solicitação. Isso ajuda o modelo a prosseguir em vez de repetir a mesma chamada.

• Verifique se a ferramenta está retornando os resultados corretamente. Se a ferramenta retornar consistentemente resultados iguais ou inválidos, adicione um limite de chamada de ferramenta ou uma lógica de encerramento no lado do aplicativo para evitar loops infinitos.

• Se necessário, otimize o prompt para esclarecer as condições de conclusão da tarefa para evitar que o modelo faça repetidamente a mesma chamada de ferramenta.

Parâmetro obrigatório (xxx) ausente ou inválido, verifique os parâmetros da solicitação.

Causa: Parâmetros de API inválidos.

Solução: Forneça todos os parâmetros necessários no formato correto.

a entrada deve conter arquivo_urls

Causa: Desaparecido file_urls parâmetro (Paraformer).

Solução: Forneça file_urls no pedido.

O URL fornecido não parece ser válido. Certifique-se de que esteja formatado corretamente.

Causa: URL ou caminho de arquivo inválido para entrada multimodal.

Solução:

• URLs: devem começar com http://, https://, ou data:. Para data: URLs, incluem "base64" antes dos dados codificados.

• Caminhos locais: deve começar com file://.

• URLs temporários: adicionar X-DashScope-OssResourceResolve: enable para solicitar cabeçalhos (HTTP) ou usar DashScope SDK (não OpenAI SDK).

A entrada deve ser um dicionário ou instância válida de GPT3Message

Causa: Inválido messages formato (colchetes incompatíveis, chaves ausentes).

Solução: verifique se a estrutura JSON está correta.

Erro de valor, o conteúdo não é str nem lista de str. : input.contents

Causa: A entrada incorporada deve ser uma string ou uma matriz de strings.

Solução: Use o formato de entrada correto.

A entrada da modalidade de vídeo não atende aos requisitos porque: o intervalo de imagens da sequência deve ser (4, 512)./(4,80).

Causa: Número inválido de imagens para entrada de vídeo.

Solução: Qwen3-VL/Qwen2.5-VL: 4-512 imagens. Outros modelos: 4-80 imagens. Consulte Compreensão de imagem e vídeo.

Limite máximo de bytes excedido por item de uri de dados: 10485760'. / O tamanho do arquivo multimodal é muito grande

Causa: O arquivo excede o limite de tamanho para modelos multimodais.

Solução:

• Arquivos locais (Base64): Máximo de 10 MB após codificação.

• Imagens (URL): Máx. 10 MB.

• Vídeos (URL): Máx. 2 GB (Qwen3-VL, qwen3-vl-plus) ou 150 MB (outros modelos).

Consulte Como faço para compactar uma imagem ou vídeo no tamanho necessário?

A entrada deve ser 'Cherry', 'Serena', 'Ethan' ou 'Chelsie': parâmetros. Audio. Voz

Causa: Inválido voice parâmetro.

Solução: Use 'Cherry', 'Serena', 'Ethan' ou 'Chelsie'.

O comprimento e a largura da imagem não atendem às restrições do modelo.

Causa: Dimensões da imagem fora do intervalo.

Solução: A largura e a altura devem ser ≥ 10 pixels. A proporção deve estar entre 1:200 e 200:1.

Falha ao decodificar a imagem durante a inspeção de dados.

Causa: Falha na decodificação da imagem.

Solução: verifique se a imagem não está corrompida e atende aos requisitos de formato.

O formato do arquivo é ilegal e não pode ser aberto. / O formato de áudio é ilegal e não pode ser aberto. / O formato de mídia não é suportado ou está incorreto para a inspeção de dados.

Causa: Formato de arquivo incompatível ou ilegível.

Solução: verifique se o arquivo não está corrompido, se a extensão corresponde ao formato real e se o formato é compatível.

As mensagens de entrada não contêm elementos com função de usuário.

Causa: Nenhuma mensagem do usuário foi passada para o modelo ou ao chamar um QwenCloud aplicativo de fluxo de trabalho por meio de uma API, os parâmetros no nó inicial foram passados user_prompt_params em vez de biz_params.

Solução: passe uma mensagem do usuário para o modelo ou passe parâmetros personalizados por meio biz_params.

Falha ao baixar conteúdo multimodal. / O download do recurso de mídia expirou durante o processo de inspeção de dados./ Não foi possível fazer download do recurso de mídia durante o processo de inspeção de dados.

Causa: Falha ao baixar a imagem, vídeo ou áudio ou o download expirou.

• Problemas de conectividade: você está usando um endereço de rede interno do Object Storage Service.

• Latência de rede: o acesso entre regiões causa tempos limite.

• Instabilidade do serviço: O serviço de armazenamento de origem está lento ou inacessível.

• Bloqueio de política de segurança: O User-Agent que o servidor envia quando baixa uma URL pública contém o DashScopeUserBot identificador. A política de segurança de um servidor de terceiros pode bloquear solicitações que contenham esse identificador, o que causa falha no download.

Solução:

• Alterar o serviço de armazenamento

Use um serviço de armazenamento na mesma região que o serviço modelo. Use o Object Storage Service para gerar URLs públicas. Não use endereços de rede privada.

• Ajuste o método de transferência

Se você não puder usar uma URL pública, mude para um método da tabela abaixo. Consulte Passar arquivos locais (codificação Base64 ou caminho do arquivo).

• A codificação Base64 aumenta o tamanho dos dados. Portanto, o arquivo original deve ter menos de 7 MB.

• Usar a codificação Base64 ou um caminho de arquivo local pode evitar tempos limite de download no servidor e melhorar a estabilidade.

• Permitir DashScopeUserBot

Se o arquivo estiver hospedado em um servidor que você controla, permita solicitações cujo User-Agent contenha DashScopeUserBot em sua política de segurança. Alternativamente, passe arquivos locais (codificação Base64 ou um caminho de arquivo) para que o servidor não precise baixar a URL pública.

erro de URL, verifique o URL!

• Motivo 1: o nome do modelo não corresponde ao endpoint da API. Por exemplo, você usa um endpoint multimodal para chamar um modelo de texto ou um endpoint de texto para chamar um modelo multimodal.

Solução:

1. Quando você usa modelos multimodais como qwen3.7-plus, qwen3-vl-plus, qwen3.8-max, ou qwen3.8-flash por meio do DashScope, use o método MultiModalConversation.call() ou o endpoint de geração multimodal. Consulte Compreensão de imagem e vídeo. Ao mudar de um modelo de texto simples (como qwen3.7-max) para um modelo multimodal (como qwen3.8-max ou qwen3.8-flash), altere a invocação de Generation.call() para MultiModalConversation.call(); caso contrário, a chamada retornará um erro de URL.

Se você usar a estrutura spring-ai-alibaba, confirme se definiu o parâmetro multimodal withMultiModel.

2. Quando você usa modelos de texto como qwen3.7-max, qwen3.7-plus, ou deepseek-v4-pro por meio do DashScope, use Generation.call() ou o endpoint de geração de texto. Consulte Visão geral da geração de texto.

• Motivo 2: a versão do SDK do DashScope está desatualizada. Versões mais antigas não conseguem resolver o endereço de servidor correto para modelos de geração de imagem ou vídeo.

Solução: Instale o SDK

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

Causa: O URL do arquivo assinado no OSS expirou.

Solução: Acesse a URL do arquivo dentro do prazo de validade.

O item de conteúdo deve ser uma mensagem de um determinado modal.

Causa: Ao usar o DashScope SDK para chamar um modelo multimodal, a chave para cada elemento no content matriz deve ser image, video, audio, ou text.

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

Arquivo de vídeo inválido.

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

Solução: verifique se o arquivo de vídeo está corrompido ou em um formato não compatível.

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

Causa: a duração do vídeo excede o limite do Qwen-VL ou Qwen-Omni modelo.

Solução:

• Qwen2.5-VL: 2 segundos a 10 minutos.

• Outro Qwen-VL modelos e Qwen3.5-Omni-Plus: 2 a 40 segundos.

• Para os limites de vídeo de outros Qwen-Omni modelos, consulte Entrada multimodal.

Campo obrigatório: xxx

Causa: Falta um parâmetro de entrada.

Solução: Adicione o parâmetro correspondente com base na mensagem de erro xxx.

A solicitação não contém parâmetros obrigatórios ou está em formato incorreto. Verifique os parâmetros que você enviou.

Causa: Um parâmetro de entrada obrigatório está ausente ou tem um formato incorreto.

Solução: verifique se os parâmetros da solicitação estão completos e no formato correto.

Arquivos de treinamento ausentes.

Causa: um parâmetro está incorreto, ausente ou apresenta um problema de formato.

O estilo é inválido.

Causa: O style o valor não está no intervalo permitido.

Solução: Verifique se o style o valor do parâmetro é válido.

###parametros.video_ratio deve ser 9:16 ou 3:4.

Causa: O video_ratio parâmetro aceita apenas "9:16" ou "3:4".

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

erro de entrada json.

Causa: O JSON de entrada está incorreto.

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

erro de leitura de imagem.

Causa: Falha ao ler a imagem.

Solução: Verifique se o arquivo de imagem está corrompido ou em um formato não compatível.

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

Causa: Um parâmetro de entrada está fora do intervalo.

Solução: corrija o valor do parâmetro com base na mensagem de erro xxx.

O tamanho da imagem da pessoa e da imagem grosseira não são iguais.

Causa: A resolução de coarse_image difere de person_image.

Solução: Defina a resolução de coarse_image combinar person_image.

A solicitação não possui parâmetros obrigatórios ou os parâmetros estão fora do intervalo especificado, verifique os parâmetros que você envia.

Causa: Um parâmetro obrigatório está ausente ou fora dos limites.

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

erro de formato de imagem

Causa: O formato da imagem está incorreto.

Solução: o valor deve ser um URL de imagem ou uma string Base64.

Nenhuma mensagem encontrada na entrada

Causa: Os parâmetros da solicitação devem conter o campo de mensagens.

Solução: Consulte Qwen - edição de imagem.

Formato de imagem inválido ou arquivo corrompido

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

Solução: verifique se a imagem não está corrompida e atende aos requisitos de formato.

falha no download da imagem

Causa: A imagem não pode ser baixada.

Solução: verifique se o arquivo pode ser baixado.

comprimento de mensagens suporta apenas 1

Causa: O comprimento da matriz de mensagens só pode ser 1.

Solução: Você pode passar apenas uma mensagem. Veja Qwen - edição de imagem.

comprimento do conteúdo suporta apenas 2

Causa: O comprimento da matriz de conteúdo só pode ser 2.

Solução: Você pode passar apenas um conjunto de texto e imagem. Veja Qwen - edição de imagem.

falta de imagem ou texto

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

Solução: Consulte Qwen - edição de imagem.

num_images_per_prompt deve ser 1.

Causa: Um parâmetro de solicitação é inválido. O parâmetro n só pode ser 1.

Solução: Definir n para 1.

Formato de arquivos de entrada não suportado.

Causa: O formato de áudio ou imagem não é compatível.

Solução: Formatos de áudio suportados: mp3, wav, aac. Formatos de imagem suportados: jpg, jpeg, png, bmp, webp.

Falha ao baixar arquivos de entrada.

Causa: Falha ao baixar os arquivos de entrada.

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

erro de download do sistema operacional.

Causa: Falha ao baixar a imagem de entrada.

Solução: verifique se o link do OSS está correto e acessível.

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

Causa: O conteúdo da imagem não é compatível.

Solução: substitua a imagem por uma que seja aprovada na moderação de conteúdo.

erro de leitura de vídeo.

Causa: Falha ao ler o vídeo.

Solução: verifique se o arquivo de vídeo está corrompido ou em um formato não compatível.

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

Causa: O tamanho da imagem de entrada está fora do intervalo.

Solução: ajuste o tamanho da imagem para atender aos requisitos da API.

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

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

Solução: verifique a documentação da API para obter valores de parâmetros válidos.

O parâmetro de solicitação é inválido, verifique o parâmetro de solicitação.

Causa: O parâmetro de proporção é inválido.

Solução: Use "1:1" ou "3:4".

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

Causa: Nenhum dado foi enviado ao serviço por mais de 23 segundos. Isso ocorre com reconhecimento de fala (Paraformer) ou síntese de fala (CosyVoice).

Solução: verifique por que nenhum dado foi enviado por um longo período. Encerre a tarefa se não planeja enviar dados em 23 segundos.

Certifique-se de que o texto de entrada seja válido.

Causa: Ao usar síntese de fala (CosyVoice), o texto a ser sintetizado não foi enviado. Possíveis causas: o text parâmetro não tem valor ou uma exceção de código impediu a atribuição.

Solução: Verifique se o text parâmetro é atribuído e enviado.

Parâmetro obrigatório 'payload.model' ausente! Por favor, siga o protocolo!

Causa: Ao usar síntese de fala (CosyVoice), o model parâmetro não foi especificado.

Solução: Especifique o model parâmetro.

[tts:]Código de erro de retorno do motor: 418

Causa: Ao usar síntese de fala (CosyVoice), o voice parâmetro está errado ou o model a versão não corresponde à voice versão.

Solução:

1. Verifique o voice parâmetro:

   • Para uma voz padrão, verifique-a em relação ao "parâmetro de voz" no CosyVoice lista de vozes.

2. Verifique a correspondência de versão: os modelos v2 requerem vozes v2. Os modelos v1 requerem vozes v1. Não os misture.

Solicitação de voz inválida!

Causa: Ao usar síntese de fala (CosyVoice), o voice parâmetro não foi definido.

Solução: atribua um valor ao voice parâmetro. Para a API WebSocket, configure os parâmetros no formato JSON correto.

ref_images_url e obj_or_bg devem ter o mesmo comprimento.

Causa: Ao usar o recurso de referência de múltiplas imagens de Wan - edição geral de vídeo, o ref_images_url e obj_or_bg matrizes têm comprimentos diferentes.

Solução: Definir ref_images_url e obj_or_bg no mesmo comprimento.

verifique o estilo dos dados de entrada.

Causa: Um parâmetro de entrada não atende aos requisitos.

Solução: Corrija os parâmetros de entrada.

Um erro durante o pré-processamento do modelo.

Causa: O content o formato do campo está errado.

Solução:

• Não defina o conteúdo para um tipo de array, como [{"type": "text", "text": "Who are you?"}].

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

Causa:

• As dimensões da imagem não atendem às Qwen-VL requisitos do modelo.

• O tamanho da imagem de saída excede 10 MB.

Solução:

• As dimensões da imagem devem atender a estes requisitos:

  • A largura e a altura devem ter pelo menos 10 pixels.

  • A proporção não deve exceder 200:1 ou 1:200.

• Ajuste os parâmetros de geração de imagem.

Tipo de conteúdo errado de URL multimodal

Causa: O Content-Type no cabeçalho de resposta do URL está errado.

O Qwen-VL model suporta estes tipos de conteúdo: image/bmp, image/icns, image/x-icon, image/jpeg, image/jp2, image/png, image/sgi, image/tiff e image/webp. Consulte Imagens suportadas pelo Qwen-VL modelo.

Solução:

Para visualizar o Content-Type campo:

1. Abra um navegador como Chrome ou Firefox.

2. Pressione F12 ou clique com o botão direito e selecione “Inspecionar” para abrir as ferramentas do desenvolvedor.

3. Mude para a guia Rede.

4. Insira o URL da imagem na barra de endereço.

5. Encontre a solicitação e verifique o Content-Type na seção "Cabeçalhos de resposta".

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

Causa: Em uma API WebSocket ligue para CosyVoice, você enviou o continue-task instrução várias vezes após a configuração enable_ssml para true.

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

O texto SSML não é suportado no momento!

Causa: O atual CosyVoice modelo ou voz não suporta SSML ou SSML é usado incorretamente.

Solução: Verifique as Limitações.

[tts:]Código de erro de retorno do motor: 428

Causa: O CosyVoice síntese de fala instruction parâmetro é usado incorretamente. Questões específicas podem incluir o seguinte:

• Comprimento excedido: instruction não pode exceder 100 caracteres (os 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 formato livre permitidas (por exemplo, emoção, velocidade).
  • cosyvoice-v3-flash:
    • Deve seguir um formato fixo.
    • Apenas chinês instruction é suportado.
    • Suportado instruction varia de acordo com o timbre. Veja CosyVoice lista de vozes para obter detalhes.

Solução:

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

Pelo menos uma das 'letras' ou 'prompt' deve ser fornecida.

Causa: Nem o lyrics nem o prompt parâmetro foi fornecido ao usar o modelo Fun-Music.

Solução: Forneça pelo menos um dos lyrics ou prompt parâmetro em sua solicitação.

O conteúdo das letras é ilegal e não pode ser usado para geração de música.

Causa: o conteúdo das letras não passou na verificação de moderação de conteúdo ao usar o modelo Fun-Music. As letras podem conter conteúdo infrator.

Solução: modifique a letra para remover qualquer conteúdo infrator ou não compatível e tente novamente.

400-inválido_request_error-invalid_value

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

Causa: Ao usar o protocolo compatível com OpenAI, seed não está no intervalo [0, 231-1].

Solução: Definir seed para um valor em [0, 231-1].

400-inválido_request_error

você deve fornecer um parâmetro de modelo.

Causa: O model parâmetro não foi fornecido na solicitação.

Solução: Adicione o model parâmetro para a solicitação.

400-InvalidParameter.NotSupportEnableThinking

O modelo xxx não suporta enable_thinking.

Causa: O modelo não suporta enable_thinking.

Solução: Remover enable_thinking da solicitação ou use um modelo que suporte o modo de pensamento.

400-valor_inválido

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

Causa: A voz selecionada pertence a um modelo diferente.

Solução: Definir target_model para clonagem de voz para corresponder ao model para síntese de fala.

400-Atraso

Acesso negado, verifique se sua conta está em situação regular.

Causa: A conta tem um pagamento atrasado.

Solução: Verifique Visão geral do faturamento. Se nenhum pagamento estiver vencido, verifique se a chave API pertence à sua conta. Se sua conta não estiver atrasada, sua conta pode estar anormal. Para obter detalhes, entre em contato com o atendimento ao cliente para obter mais soluções de problemas. Se estiver vencido, liquide o saldo devedor e aguarde a atualização antes de tentar novamente.

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

Causa: Quando você liga QwenCloud por meio de um cliente terceirizado, como o OpenClaw, se a conta subjacente tiver um pagamento vencido ou saldo insuficiente, o cliente agregará o erro de cobrança do servidor nesta mensagem. O código de erro subjacente do lado do servidor é Arrearage (a mensagem Acesso negado, certifique-se de que sua conta esteja em situação regular. acima). Não é uma questão de cobrança do próprio cliente.

Solução: Verifique Visão geral do faturamento para pagamentos em atraso. Se estiver vencido, liquide o saldo e aguarde a atualização antes de tentar novamente. Se nenhum pagamento estiver vencido, verifique se a chave API pertence à sua conta.

###isv.OUT_OF_SERVICE

Causa: O saldo da conta é insuficiente, por isso o serviço foi suspenso.

Solução: Recarregue sua conta. O serviço é retomado automaticamente assim que o saldo for suficiente. Consulte Visão geral do faturamento.

400-Contain.Forbidden.Label.Error

contém rótulo de pedido de criação proibido

Causa: Sua conta possui uma etiqueta que proíbe fazer pedidos, portanto, esta solicitação de pedido está bloqueada e o pedido não pode ser feito.

Solução: Entre em contato com o atendimento ao cliente para confirmar o motivo da adição da etiqueta e solicitar sua remoção. Faça o pedido novamente após a remoção da etiqueta.

400-DataInspectionFailed/data_inspection_failed

Os dados de entrada ou saída podem conter conteúdo impróprio. / Os dados de entrada podem conter conteúdo impróprio. / Os dados de saída podem conter conteúdo impróprio.

Causa: Conteúdo bloqueado pela moderação.

Solução: Modifique a entrada e tente novamente.

Os dados de entrada xxx podem conter conteúdo impróprio.

Causa: Os dados de entrada, como o prompt ou a imagem, podem conter conteúdo confidencial.

Solução: verifique e modifique a entrada e tente novamente.

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

Causa: antes de a imagem de entrada entrar na inferência do modelo, ela foi sinalizada pela pré-verificação de segurança de conteúdo como suspeita de conter conteúdo confidencial ou não compatível e, portanto, foi bloqueada. O modelo não executou inferência na imagem, portanto, nenhum reconhecimento, OCR ou resultado de análise é retornado. Esta é uma verificação de conformidade de conteúdo pré-inferência em imagens de entrada multimodais.

Solução: Substitua ou modifique a imagem de entrada e tente novamente. Se for confirmado que a imagem está em conformidade, mas ainda estiver bloqueada de forma consistente, envie um ticket para verificação adicional.

400-APIConnectionError

Este é um erro de rede do lado do cliente; nenhum status HTTP é realmente retornado.

Erro de conexão.

Causa: Erro de conexão de rede (geralmente relacionado ao proxy).

Solução: Desative ou reinicie o proxy.

400-InvalidFile.DownloadFailed

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

Causa: Falha ao baixar o arquivo de áudio (Paraformer).

Solução: verifique se o URL está acessível publicamente.

400-InvalidFile.AudioLengthError

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

Causa: Duração do áudio fora do alcance.

Solução: certifique-se de que a duração seja de 1 a 300 segundos.

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

Causa: Duração do áudio fora do alcance.

Solução: certifique-se de que a duração seja de 1 a 180 segundos.

400-InvalidFile.NoHuman

A imagem de entrada não possui corpo humano. Carregue outra imagem com uma única pessoa.

Causa: Não há nenhuma pessoa na imagem de entrada ou nenhum rosto foi detectado.

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

400-InvalidFile.BodyProportion

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

Causa: A proporção da pessoa na imagem não atende ao requisito.

Solução: Faça upload de uma imagem com proporção de pessoa adequada.

400-InvalidFile.FacePose

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

Causa: A pose facial não atende ao requisito. O rosto deve estar visível e a cabeça não deve estar muito inclinada.

Solução: carregue uma imagem com um rosto visível e devidamente orientado.

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

Causa: A orientação do cabeçote está muito distorcida.

Solução: carregue uma imagem onde o rosto não esteja distorcido.

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

Causa: A orientação do cabeçote está muito distorcida.

Solução: carregue uma imagem onde o rosto não esteja distorcido.

400-InvalidFile.Resolution

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

Causa: A resolução da imagem não atende ao requisito.

Solução: a resolução deve estar entre 400*400 e 7.000*7.000.

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

Causa: A resolução da imagem não atende ao requisito.

Solução: o lado mais longo deve ter menos de 4.096 pixels. O lado mais curto deve ser maior que 224 pixels.

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

Causa: A resolução da imagem não atende ao requisito.

Solução: A resolução deve estar entre yyy*yyy e xxx*xxx.

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

Causa: A resolução da imagem não atende ao requisito.

Solução: a proporção deve ser menor que xxx e a resolução não deve exceder yyy*yyy.

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

Causa: A resolução do vídeo não atende ao requisito.

Solução: Cada lado deve ter entre xxx e yyy pixels.

400-ArquivoInválido.FPS

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

Causa: a taxa de quadros do vídeo não atende ao requisito.

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

400-InvalidFile.Value

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

Causa: A imagem está muito escura.

Solução: carregue uma imagem mais nítida com iluminação adequada.

400-InvalidFile.FrontBody

A pose da pessoa detectada é inválida, carregue outra imagem com vista frontal.

Causa: A pessoa está de costas para a câmera.

Solução: carregue uma imagem onde a pessoa esteja de frente para a câmera.

400-InvalidFile.FullFace

A pose do rosto detectado é inválida, carregue outra imagem com o rosto inteiro.

Causa: O rosto não está totalmente visível.

Solução: carregue uma imagem onde todo o rosto esteja visível e desobstruído.

400-InvalidFile.FaceNotMatch

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

Causa: o rosto na imagem de referência não corresponde ao rosto no vídeo.

Solução: certifique-se de que a imagem e o vídeo de referência contenham a mesma pessoa.

400-InvalidFile.Content

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

Causa: O primeiro quadro deve conter uma pessoa.

Solução: selecione um videoclipe com uma pessoa no primeiro quadro.

O humano é muito pequeno no primeiro quadro do vídeo de entrada. Escolha outro clipe.

Causa: A pessoa no primeiro quadro é muito pequena.

Solução: selecione um vídeo com uma pessoa maior no primeiro quadro.

O humano não está claro no primeiro quadro do vídeo de entrada. Escolha outro clipe.

Causa: A pessoa no primeiro quadro não está clara.

Solução: selecione um vídeo com uma pessoa nítida no primeiro quadro.

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

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

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

A imagem de entrada não possui corpo humano ou possui corpo humano pouco claro. Carregue outra imagem.

Causa: o corpo humano na imagem de entrada está incompleto ou ausente.

Solução: carregue uma imagem com um corpo humano completo e claro.

A imagem de entrada possui vários corpos humanos. Carregue outra imagem com uma única pessoa.

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

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

400-InvalidFile.FullBody

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

Causa: A pessoa no primeiro quadro não é uma foto de corpo inteiro.

Solução: Todo o corpo deve estar visível no primeiro quadro.

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

Causa: A pose da pessoa não atende ao requisito.

Solução: Faça upload de uma imagem que atenda aos requisitos. Para um tiro na cabeça, toda a cabeça deve estar visível. Para uma foto de meio corpo, o corpo dos quadris para cima deve estar visível. Ou altere a proporção para 1:1.

400-InvalidFile.BodyPose

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

Causa: A pose da pessoa não atende ao requisito.

Solução: carregue uma imagem onde os ombros e tornozelos estejam visíveis, a pessoa não esteja sentada ou virada de costas e a orientação não esteja muito distorcida.

400-InvalidFile.Size

Tamanho de arquivo inválido. O tamanho do arquivo de vídeo deve ser inferior a 200 MB e o tamanho do arquivo de áudio deve ser inferior a 15 MB.

Causa: O tamanho do arquivo excede o limite.

Solução: O vídeo deve ter menos de 200 MB. O áudio deve ter menos de 15 MB.

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

Causa: O tamanho do arquivo excede o limite.

Solução: A imagem deve ter menos de 5 MB.

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

Causa: O tamanho do arquivo excede o limite.

Solução: Mantenha o arquivo abaixo do limite de tamanho especificado.

400-InvalidFile.Duration

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

Causa: A duração do arquivo está fora do intervalo.

Solução: A duração deve estar entre xxx e yyy segundos.

400-InvalidFile.ImageSize

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

Causa: O tamanho da imagem excede o limite.

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

400-InvalidFile.AspectRatio

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

Causa: A proporção do arquivo está fora do intervalo.

Solução: A proporção deve estar entre 3:1 e 1:3.

Proporção de arquivo inválida. A proporção do arquivo (altura/largura) deve estar entre 2,0 e 0,5.

Causa: A proporção do arquivo está fora do intervalo.

Solução: A proporção deve estar entre 2,0 e 0,5.

400-InvalidFile.Openerror

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

Causa: O arquivo não pode ser aberto.

Solução: Verifique se o arquivo está corrompido ou em um formato não compatível.

400-InvalidFile.Template.Content

Conteúdo do modelo inválido.

Causa: você não tem permissão para o modelo de ação ou o conteúdo do modelo é inválido.

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

400-InvalidFile.Format

Formato de arquivo inválido, o formato de arquivo solicitado é um dos seguintes tipos: MP4, AVI, MOV, MP3, WAV, AAC, JPEG, JPG, PNG, BMP e WEBP.

Causa: O formato do arquivo não é compatível.

Solução: Formatos suportados: vídeo (mp4, avi, mov), áudio (mp3, wav, aac), imagem (jpg, jpeg, png, bmp, webp).

400-InvalidFile.MultiHuman

A imagem de entrada possui vários corpos humanos. Carregue outra imagem com uma única pessoa.

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

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

400-InvalidPerson

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

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

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

400-InvalidParameter.DataInspection

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

Causa: O download de um arquivo de imagem ou áudio expirou.

Solução: armazene arquivos em um bucket OSS na mesma região que o serviço modelo.

400-FlowNotPublished

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

Causa: O fluxo não está publicado.

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

400-InvalidImage.ImageSize

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

Causa: O tamanho da imagem excede o limite.

Solução: a proporção da imagem não deve ser superior a 2 e o lado mais longo não deve ser superior a 4096.

400-InvalidImage.NoHumanFace

Nenhum rosto humano detectado.

Causa: Nenhum rosto humano foi detectado. Isso ocorre somente com APIs de consulta assíncrona para tarefas de geração.

Solução: faça upload de uma imagem que contenha um rosto humano nítido.

400-InvalidImageResolution

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

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

Solução: A resolução deve estar entre 256 x 256 e 5760 x 3240 pixels.

400-InvalidImageFormat

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

Causa: O formato da imagem não é compatível.

Solução: Use o formato JPEG, PNG, JPG, BMP ou WEBP.

400-URL inválido

URL inválido fornecido em sua solicitação.

Causa: O URL é inválido.

Solução: use um URL válido.

O URL obrigatório está ausente ou é inválido. Verifique o URL da solicitação.

Causa: O URL de entrada é inválido ou está ausente.

Solução: Forneça o URL correto.

O URL da solicitação é inválido. Verifique se o URL está correto e se é uma imagem.

Causa: O URL de entrada é inválido.

Solução: verifique se o URL está correto e aponta para um arquivo de imagem.

O áudio de entrada é maior que xxs.

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

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

O tamanho do arquivo é maior que 15 MB.

Causa: O áudio de entrada excede 15 MB.

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

O tipo de arquivo não é suportado. Os tipos permitidos são: .wav, .mp3.

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

Solução: Use o formato wav ou mp3.

O URL da solicitação é inválido, verifique se o URL da solicitação está disponível e se o formato da imagem da solicitação é um dos seguintes tipos: JPEG, JPG, PNG, BMP e WEBP.

Causa: A imagem está inacessível ou o formato não é compatível.

Solução: verifique se o URL está acessível e se o formato da imagem é JPEG, JPG, PNG, BMP ou WEBP.

400-InvalidImage.FileFormat

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

Causa: O formato da imagem não é compatível.

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

400-InvalidURL.ConnectionRefused

Conexão com xxx recusada. Forneça o URL disponível.

Causa: O download foi recusado.

Solução: forneça um URL disponível.

400-URL inválido.Timeout

Baixe o tempo limite de xxx, verifique a conexão de rede.

Causa: O download expirou.

Solução: verifique a conectividade da rede.

400-BadRequestException

Tipo de peça inválido.

Causa: O processamento de documentos não suporta este tipo de arquivo.

Solução: carregue um tipo de arquivo compatível.

400-BadRequest.EmptyInput

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

Causa: O input parâmetro não foi adicionado à solicitação.

Solução: Adicione o input parâmetro para a solicitação.

400-BadRequest.EmptyParameters

Parâmetros obrigatórios "parâmetros" ausentes na solicitação.

Causa: O parameters parâmetro não foi adicionado à solicitação.

Solução: Adicione o parameters parâmetro para a solicitação.

400-BadRequest.EmptyModel

Parâmetro obrigatório "modelo" ausente na solicitação.

Causa: O model parâmetro não foi fornecido na solicitação.

Solução: Adicione o model parâmetro para a solicitação.

400-BadRequest.IllegalInput

O parâmetro de entrada requer formato json.

Causa: O formato de entrada não é JSON válido.

Solução: verifique se a entrada é JSON padrão.

400-BadRequest.InputDownloadFailed

Falha ao baixar o arquivo de entrada: xxx.

Causa: Falha ao baixar o arquivo de entrada. Possíveis causas: tempo limite de download, falha no download ou arquivo excedendo a cota de tamanho.

Solução: Solução de problemas com base na mensagem de erro xxx.

Falha ao baixar o arquivo de entrada.

Causa: Ao usar CosyVoice para clonagem de voz, o servidor não conseguiu baixar o áudio.

Solução: verifique se o arquivo de áudio pode ser baixado e se tem menos de 10 MB.

400-BadRequest.UnsupportedFileFormat

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

Causa: O formato do arquivo não é compatível.

Solução: Use um formato compatível.

400-BadRequest.TooLarge

Carga útil muito grande.

Causa: O tamanho do arquivo excede o limite.

Solução:

• Quando o parâmetro “finalidade” for “extração de arquivo”, os documentos não poderão ultrapassar 150 MB e as imagens não poderão ultrapassar 20 MB.

• Quando o parâmetro “finalidade” for “batch”, os arquivos não poderão ultrapassar 500 MB. Divida o arquivo e faça upload dos arquivos em lotes.

400-BadRequest.ResourceNotExist

O recurso necessário não existe.

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

400-Throttling.AllocationQuota

Cota alocada gratuita excedida.

Causa: O número de vocabulários personalizados excede o limite (padrão: 10 por conta).

Solução: exclua alguns vocabulários personalizados.

Limite máximo de armazenamento de voz excedido. Exclua as vozes existentes.

Causa: Ao usar CosyVoice para clonagem de voz, sua conta excede o limite de voz.

Solução: exclua algumas vozes ou solicite um aumento de cota.

400-Vestuário inválido

Imagem de roupa faltando. Insira pelo menos uma imagem de roupa de cima ou de baixo.

Causa: Falta uma imagem de roupa.

Solução: Forneça pelo menos uma imagem de uma peça de roupa de cima (top_garment_url) ou de uma peça de roupa de baixo (bottom_garment_url).

400-Esquema Inválido

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

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

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

400-InvalidSchemaFormat

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

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

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

400-InvalidInputLength

A resolução da imagem é inválida, certifique-se de que o maior comprimento da imagem seja menor que 4096 e o menor comprimento da imagem seja maior que 150. e o tamanho da imagem varia de 5 KB a 5 MB.

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

Solução: Consulte Requisitos de imagem de entrada.

400-FaqRuleBlocked

Os dados de entrada ou saída são bloqueados pela regra de perguntas frequentes.

Causa: O módulo de intervenção da regra de perguntas frequentes foi atingido.

400-ClientDisconnect

Cliente desconectado antes do término da tarefa!

Causa: O cliente se desconectou antes da conclusão da tarefa. Isso ocorre com serviços de síntese ou reconhecimento de fala.

Solução: não desconecte antes da conclusão da tarefa.

400-Erro de serviço não disponível

A função deve ser usuário ou assistente e o comprimento do conteúdo deve ser maior que 0.

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

Solução: verifique se o comprimento do conteúdo de entrada é maior que 0 e se o role parâmetro atende aos requisitos da API.

Suspeito de violação de IP 400

Os dados de entrada são suspeitos de estarem envolvidos em violação de IP.

Causa: Os dados inseridos são suspeitos de violação de propriedade intelectual.

Solução: verifique a entrada para garantir que não contém conteúdo que represente risco de violação.

400-Operação não suportada

A operação não é suportada no objeto árbitro.

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

Solução: verifique a correspondência do objeto de operação e do tipo.

400-CustomRoleBlocked

Os dados de entrada ou saída podem conter conteúdo impróprio com regras personalizadas.

Causa: A solicitação ou resposta não passou na política personalizada.

Solução: verifique o conteúdo ou ajuste a política personalizada.

400-Audio.AudioShortError

áudio válido muito curto!

Causa: Duração do áudio por CosyVoice clonagem de voz é muito curto.

Solução: Mantenha a duração do áudio em torno de 10 a 15 segundos. Garanta fala contínua com pelo menos um segmento durante 5 segundos.

400-Audio.AudioSilentError

erro de áudio silencioso.

Causa: CosyVoice clonagem de voz o arquivo de áudio está silencioso ou os segmentos não silenciosos são muito curtos.

Solução: mantenha a duração do áudio em torno de 10 a 15 segundos e inclua pelo menos um segmento de fala contínua durante 5 segundos.

400-Audio.PreprocessError

Erro de pré-processamento de áudio.

Causa: Ao usar CosyVoice para clonagem de voz, o pré-processamento de áudio falhou. Possíveis causas: o text O parâmetro difere significativamente do áudio, a fala efetiva é muito curta ou o áudio não contém som.

Solução: Ajuste o text parâmetro. Se o problema persistir, consulte nosso guia de gravação e grave o áudio novamente.

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

Causa: Ao usar CosyVoice para clonagem de voz, a fala efetiva no áudio é muito curta.

Solução: Siga o guia de gravação e grave novamente.

400-BadRequest.VoiceNotFound

Voz '%s' não encontrada.

Causa: Ao usar CosyVoice para clonagem de voz, você chamou a API delete voice, mas a voz já foi excluída ou não existe.

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

400-Audio.DecoderError

Falha no arquivo de áudio do decodificador.

Causa: Falha na decodificação de áudio ao usar CosyVoice para clonagem de voz.

Solução: Verifique se o arquivo de áudio está corrompido e se ele atende ao formato exigido. CosyVoice suporta WAV (16 bits), MP3 ou M4A.

400-Audio.AudioRateError

Taxa de amostragem de arquivo não suportada.

Causa: A taxa de amostragem de áudio não é suportada ao usar CosyVoice para clonagem de voz.

Solução: Use uma taxa de amostragem de pelo menos 24.000 Hz.

400-Audio.DurationLimitError

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

Causa: O áudio de CosyVoice a clonagem de voz é muito longa.

Solução: Mantenha o áudio abaixo de 60 segundos.

401-InvalidApiKey/inválido_api_key

Chave de API inválida fornecida. / Chave de API incorreta fornecida.

Causa: A chave de API está incorreta.

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

• Variável de ambiente incorreta

  • Incorreto:api_key=os.getenv("sk-xxx") . sk-xxx é tratado como um nome de variável de ambiente, não como uma chave.

  • Correto:

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

Certifique-se de ter definido DASHSCOPE_API_KEY

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

Não use este método no ambiente de produção.

• Entrada incorreta: as chaves de API começam com sk-ws- (sk- para chaves criadas anteriormente). Você pode ter inserido uma chave de outro provedor.

• Chave de API dedicada do Token Plan: o Token Plan fornece uma chave de API dedicada (começando com sk-sp-). Esta chave deve ser usada com o endpoint dedicado do Token Plan (https://token-plan.maas.qwencloudapi.com/compatible-mode/v1), e não o ponto de extremidade pré-pago. Atualize a chave de API e o URL base.

• Endpoint ou chave de API incorretos: certifique-se de que seu URL base esteja definido como https://maas.qwencloudapi.com/compatible-mode/v1 (compatível com OpenAI) ou https://maas.qwencloudapi.com/api/v1 (DashScope) e que sua chave de API foi criada em QwenCloud. Verifique sua chave de API em Chaves de API página.

• Problemas de compatibilidade de ferramentas: uma ferramenta de terceiros está configurada incorretamente. Por exemplo, Dificar a versão mais recente do plugin é instável – instale uma versão mais antiga do plugin TONGYI. Ou em versões mais antigas do Cline, Provedor de API deve ser Compatível com OpenAI, não Alibaba Qwen.

Se nenhuma das situações acima se aplicar, a chave API pode ter sido excluída. Obtenha uma nova chave e tente novamente.

401-NÃO AUTORIZADO

Acesso negado: você não está autorizado a acessar este espaço de trabalho ou o espaço de trabalho não existe. Por favor:\nVerifique a configuração do espaço de trabalho.\nVerifique as configurações do endpoint da API. Certifique-se de estar direcionando o ambiente correto.

Causa:

• O WorkspaceId é inválido ou a conta não é membro deste espaço de trabalho.

• O ponto final está incorreto.

Solução:

• Confirme se o WorkspaceId está correto e se a conta é um membro do espaço de trabalho e tente novamente.

401-token de acesso inválido ou token expirado

token de acesso inválido ou token expirado.

Possível causa: uma chave de API Token Plan foi usada com um URL base que pertence a outro plano de cobrança.

Solução: Use o URL base dedicado para o plano de token:

• Endpoint antrópico compatível: https://token-plan.maas.qwencloudapi.com/apps/anthropic
• Endpoint compatível com OpenAI: https://token-plan.maas.qwencloudapi.com/compatible-mode/v1

403-Acesso negado/acesso_negado

A API do usuário atual não oferece suporte a chamadas assíncronas.

Causa: A API não suporta invocação assíncrona.

Solução: Remover X-DashScope-Async do cabeçalho da solicitação ou defina seu valor como disable.

a API do usuário atual não oferece suporte a chamadas síncronas.

Causa: A API não oferece suporte a chamadas síncronas.

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

Inválido de acordo com a política: a política expirou.

Causa: A credencial de upload de arquivo expirou.

Solução: chame a API de upload de arquivo para gerar uma nova credencial.

Acesso negado.

Motivo: Acesso negado. Você não tem as permissões necessárias, a cota gratuita do modelo está esgotada e ele não oferece suporte ao uso pago ou o modelo foi descontinuado.

Solução: se o modelo estiver obsoleto, confirme seu status em Política de descontinuação do modelo e mude para um dos modelos alternativos recomendados lá.

Chamando um modelo exclusivo do Token Plan com uma chave de API geral

Causa: Modelos exclusivos do Token Plan (como qwen3.8-max-preview) só pode ser chamado por assinantes do Token Plan usando a chave de API exclusiva do plano (começando com sk-sp-) junto com o URL base exclusivo do Token Plan. Chamar esses modelos com uma chave de API geral (começando com sk-) retorna um 403 access_denied erro.

Solução: No console, acesse Minhas assinaturas e obtenha a chave de API exclusiva do plano de token e o URL base exclusivo na área Chave de API. Certifique-se de atualizar ambos. Para obter detalhes de configuração, consulte Início rápido. Se a chave de API e o URL base não corresponderem (por exemplo, uma chave de API exclusiva com o URL base geral), um erro de autenticação 401 será retornado; consulte 401-InvalidApiKey/invalid_api_key neste documento.

403-Acesso negado.Não comprado

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

Causa: Você não completou suas informações de faturamento em QwenCloud.

Solução: Preencha suas informações de faturamento:

1. ** Faça login em QwenCloud**: Se você não tiver um QwenCloud conta, registrar um primeiro.

2. Informações completas de faturamento: Vá para Faturamento (ou clique no seu avatar e selecione Faturamento com o selo "Informações de pagamento completas"), preencha os detalhes de faturamento necessários e adicione uma forma de pagamento. Para obter instruções passo a passo, consulte Preencher suas informações de faturamento.

403-Model.AccessDenied

Acesso ao modelo negado.

Causa: você não tem permissão para chamar este modelo.

Solução:

• Chamando modelos padrão: Ao usar uma chave de API de subespaço de trabalho para chamar modelos padrão (como qwen-plus), o subespaço de trabalho deverá ter permissões de chamada.

• Chamada de modelos personalizados: após a implantação bem-sucedida, os modelos personalizados só podem ser chamados com a chave API do seu espaço de trabalho e não requerem autorização de chamada de modelo.

403-App.AccessDenied

Acesso ao aplicativo negado.

Causa: você não tem permissão para acessar o modelo.

Solução:

• Confirme se o espaço de trabalho tem autorização de acesso.

• Verifique se a API KEY está correta.

• Se o Claude Code reportar um erro, use a chave API do espaço de trabalho padrão.

403-Workspace.AccessDenied

Acesso ao espaço de trabalho negado.

Causa: você não tem permissão para acessar o modelo do workspace.

Solução:

• Verifique se você é membro do espaço de trabalho.

• Use o QwenCloud chave de API da conta, que tem permissões para todos os espaços de trabalho.

403-Endpoint.AccessDenied

Acesso ao endpoint do espaço de trabalho negado.

Causa: você pode estar chamando um modelo obsoleto (por exemplo, versões históricas de instantâneos como qwen-max-2025-01-25). Após a descontinuação, o endpoint não estará mais disponível, causando esse erro.

Solução:

• Vá para Política de descontinuação do modelo para confirmar se o modelo está obsoleto.
• Se estiver obsoleto, mude para o modelo de substituição recomendado.

403-AllocationQuota.FreeTierOnly

O nível gratuito do modelo se esgotou. Se você want para continuar acessando o modelo de forma paga, desative o modo "usar somente nível gratuito".

Causa 1: a cota gratuita de novos usuários se esgotou.

Solução: Complete seu perfil e tente novamente.

Causa 2: Somente cota gratuita está ativado e a cota gratuita está esgotada.

A cota gratuita exibida no console é atualizada a cada minuto. Atualize a página para ver os dados mais recentes.

Solução:

• Para iniciar chamadas pagas, você pode desativar a Apenas cota gratuita alterne a qualquer momento sem esperar até que a cota gratuita se esgote.

• Se a opção já estiver desabilitada, mas as chamadas ainda falharem, verifique se a chave API foi alterada ou se tornou inválida. Tente redefinir a chave de API ou criar uma nova para testar a chamada.

• Se não houver registro de chamada para a solicitação no console, a solicitação pode não ter chegado ao servidor. Verifique a configuração do plugin do cliente ou a conexão de rede.

• Se você encontrar isso com um Token Plan, provavelmente é um problema de configuração. O Token Plan requer seu próprio URL base e [chave de API] dedicada (https://home.qwencloud.com/api-keys).

404-ModelNotFound/model_not_found

O modelo xxx fornecido não é compatível com a API Batch.

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

Solução: Consulte API de lote para modelos suportados e nomes corretos.

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

Causa: O modelo não existe ou QwenCloud não está ativado.

Solução:

• Verifique o nome do modelo no Model Marketplace.

• Faça login em QwenCloud.

• Se você estiver chamando um modelo por meio de um endpoint de implantação dedicado e receber ModelNotFound, verifique também o seguinte:

  1. Use o nome da implantação: Para um endpoint de implantação dedicado, o model O parâmetro deve ser definido como o nome da implementação (código do modelo), não como o nome do modelo. O nome da implantação fica visível na página Implantação do modelo no console, em um formato semelhante a qwen3.5-flash-2026-02-23-xxx. Chamar um endpoint de implantação dedicado com um nome de modelo ou chamar o endpoint de API padrão com um nome de implantação retorna model_not_found.
  2. Distinguir entre métodos de chamada: As chamadas padrão usam o endpoint de API padrão e o nome do modelo, enquanto as chamadas de implantação dedicadas usam o URL e o nome de implantação do endpoint de implantação dedicado. As chaves de API dos dois podem ser diferentes; misturá-los causa um invalid_api_key erro de autenticação.

modelo 404_não_suportado

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

Causa: O modelo não oferece suporte ao modo compatível com OpenAI.

Solução: Use o método DashScope.

404-WorkSpaceNotFound

WorkSpace não encontrado.

Causa: O espaço de trabalho não existe.

404-Não encontrado

Não encontrado!

Causa: O recurso não existe.

Solução: verifique o ID do recurso.

Caminho da solicitação não encontrado.

Causa: O endereço do serviço não existe ao usar o modelo Fun-Music.

Solução: verifique se o caminho do endpoint da API está correto e não contém caracteres inválidos.

429-Estrangulamento

Limitação de solicitações acionada.

Causa: a chamada da API acionou a limitação de taxa.

Solução: reduza a frequência da chamada ou tente novamente mais tarde.

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

Causa: muitas solicitações acionaram a limitação de taxa.

Solução: tente novamente mais tarde.

Todos os modelos têm taxa temporariamente limitada. Tente novamente em alguns minutos.

Causa: quando um cliente (como Claude Code) chama vários modelos com fallback automático, esta mensagem é retornada pelo cliente depois que cada modelo disponível acionou a limitação de taxa 429. Os códigos de erro subjacentes do lado do servidor são Throttling.RateQuota ou Throttling.AllocationQuota.

Solução:

• Aguarde alguns minutos e tente novamente. O limite da taxa será levantado automaticamente.

• Reduza a simultaneidade de solicitações para evitar o envio de muitas solicitações em um curto período.

• Para aumentar seu limite de taxa, consulte Limites de taxa para solicitar um aumento de cota.

  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 oferecem suporte a chamadas assíncronas; quando este cabeçalho é definido, mesmo uma única solicitação retorna 429. Remova o X-DashScope-Async cabeçalho ou defina seu valor como disablee tente novamente com uma chamada síncrona. Para obter mais informações, consulte A API do usuário atual não suporta chamadas assíncronas. em 403-AccessDenied/access_denied neste documento.

429-Throttling.RateQuota/LimitRequests/limit_requests

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

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

Solução: Consulte Limites de taxa e reduza a frequência da chamada.

429-Throttling.BurstRate/limit_burst_rate

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

Causa: A frequência da chamada aumentou acentuadamente, acionando a proteção de estabilidade do sistema.

Solução : adote uma estratégia de solicitação tranquila, como agendamento uniforme, espera exponencial ou buffer de fila de solicitação. Distribua as solicitações uniformemente dentro do intervalo de tempo para evitar picos instantâneos.

429-Throttling.AllocationQuota/insuficiente_quota

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

Causa: A taxa de consumo de token (TPS/TPM) acionou Limites de taxa.

Solução: Consulte os Limites de taxa documentação para limites do modelo e ajuste sua estratégia de chamada. Se as cotas padrão forem insuficientes, solicite um aumento temporário do TPM no console.

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

Causa: muitas solicitações em lote acionaram a limitação de taxa.

Solução: Tente novamente mais tarde.

Cota alocada gratuita excedida.

Causa: a cota gratuita expirou ou foi esgotada e o modelo não oferece suporte para pagamento conforme o uso.

Solução: Use outro modelo.

429-Throttling.ServiceOverloaded

InternalError.Algo: Ocorreu um erro no atendimento do modelo, a mensagem de erro é: [Too many requests.]

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

Solução: Tente novamente mais tarde.

429-Throttling.ResourceExhausted

InternalError.Algo: Ocorreu um erro no atendimento do modelo, a mensagem de erro é: [Too many requests.]

Causa: Os recursos de rede estão atualmente em estado saturado e não podem processar sua solicitação no momento.

Solução: Tente novamente mais tarde.

429-CommodityNotPurchased

A mercadoria ainda não foi comprada.

Causa: O espaço de trabalho não está inscrito.

Solução: inscreva-se primeiro no serviço do workspace.

429-Conta pré-paga vencida

A fatura pré-paga está vencida.

Causa: a fatura da assinatura do espaço de trabalho expirou.

429-Conta pós-paga vencida

A conta pós-paga está vencida.

Causa: o produto de inferência do modelo expirou.

430-Audio.DecoderError

Falha no arquivo de áudio do decodificador.

Causa: CosyVoice clonagem de voz falha na decodificação do arquivo de áudio.

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

430-Audio.FileSizeExceed

Arquivo muito grande

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

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

430-Audio.AudioRateError

Taxa de amostragem de arquivo não suportada

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

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

430-Audio.AudioSilentError

Arquivo silencioso não suportado.

Causa: CosyVoice clonagem de voz o arquivo de áudio está silencioso ou os segmentos não silenciosos são muito curtos.

Solução: mantenha a duração do áudio em torno de 10 a 15 segundos e inclua pelo menos um segmento de fala contínua durante 5 segundos.

500-InternalError/interno_error

Ocorreu um erro interno, tente novamente mais tarde ou entre em contato com o suporte técnico.

Causa: Ocorreu um erro interno.

Solução:

• Se estiver usando o Qwen-Omni modelo, e a API requer streaming, defina stream=true.

Erro interno do servidor!

Causa: Ocorreu um erro interno no algoritmo.

Solução: Tente novamente mais tarde.

solicitação asr falhou

Causa: Ao usar CosyVoice clonagem de voz, o arquivo de áudio é inválido porque não contém uma voz humana válida, o áudio não está claro ou contém ruído de fundo excessivo.

Solução: siga o guia de gravação, grave o áudio novamente e tente novamente.

Fluxo grpc cancelado remotamente.

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

Solução: Verifique o voice parâmetro e certifique-se de que um nome de timbre válido seja especificado. Veja CosyVoice lista de vozes para timbres disponíveis.

500-InternalError.FileUpload

erro de upload do oss.

Causa: Falha no upload do arquivo.

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

500-InternalError.Upload

Falha ao carregar o resultado.

Causa: Falha ao carregar o resultado da geração.

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

500-InternalError.Algo

erro interno de inferência.

Causa: Ocorreu uma exceção de serviço.

Solução: tente novamente primeiro para descartar um problema esporádico.

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

Causa: o modelo gerou JSON inválido, impedindo uma chamada de ferramenta normal.

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

Falta o comprimento do conteúdo do URL multimodal.

Causa: O Content-Length campo está faltando no cabeçalho de resposta da solicitação de URL.

Solução: tente um link de imagem diferente se o problema persistir.

Para visualizar o Content-Length campo:

1. Abra um navegador como Chrome ou Firefox.

2. Pressione F12 ou clique com o botão direito e selecione “Inspecionar” para abrir as ferramentas do desenvolvedor.

3. Mude para a guia Rede.

4. Insira o URL da imagem na barra de endereço.

5. Encontre a solicitação e verifique o Content-Length na seção "Cabeçalhos de resposta".

Nenhum servidor back-end disponível

Causa: o serviço de back-end está temporariamente indisponível. Isso pode ser causado por uma atualização de serviço, dimensionamento, agendamento de recursos ou uma falha transitória.

Solução:

1. Faça login no console e confirme se sua conta não está vencida. Se sua conta estiver vencida, recarregue sua conta e aguarde alguns minutos para que o pagamento entre em vigor.
2. Uso curl ou ping para testar a conectividade com maas.qwencloudapi.com.
3. Verifique o status do serviço no console.
4. Após confirmar que sua conta e rede estão normais, aguarde alguns minutos e chame a API novamente.

Ocorreu um erro no serviço do modelo, a mensagem de erro é: [Solicitação rejeitada pelo mecanismo de inferência!]

Causa: Ocorreu um erro no servidor de serviço de modelo.

Solução: Tente novamente mais tarde.

Ocorreu um erro na veiculação do modelo. A mensagem de erro é: [Cluster 'xxx' não encontrado!]

Causa: A solicitação da API foi roteada para um cluster de serviço indisponível. Isso geralmente acontece porque os serviços de modelo ainda não foram implementados na região especificada na solicitação.

Solução: verifique se o URL base na sua solicitação ou configuração do SDK está correto. Os serviços de modelo estão disponíveis na região de Singapura, portanto o URL base deve ser https://maas.qwencloudapi.com/compatible-mode/v1 para o modo compatível com OpenAI, ou https://maas.qwencloudapi.com/api/v1 para o modo nativo DashScope.

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

Causa: Ocorreu um erro durante o tempo de execução do algoritmo.

Solução: Tente novamente mais tarde.

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

Causa: Ocorreu um erro de inferência.

Solução: Verifique se a imagem de entrada está corrompida. Verifique se a imagem da pessoa contém um rosto completo e claro.

A função deve estar em [usuário, assistente]

Causa: Ao usar Qwen-MT, a matriz de mensagens contém uma função diferente de user.

Solução: O array de mensagens deve conter apenas um elemento com função user.

Incorporação_pipeline_Error: xxx

Causa: Ocorreu um erro no pré-processamento de imagem ou vídeo.

Solução: verifique se a imagem ou vídeo enviado e o código de solicitação atendem aos requisitos e tente novamente.

Falha no recebimento da resposta de backend em lote!

Causa: Ocorreu um erro de serviço interno.

Solução: Tente novamente mais tarde.

[music]Falha ao receber resposta de back-end em lote!

Causa: o serviço do modelo Fun-Music excedeu o limite de simultaneidade.

Solução: reduza o número de solicitações simultâneas e tente novamente.

Outros tipos de erro de servidor.

Causa: Ocorreu um erro interno desconhecido ao usar o modelo Fun-Music.

Solução: Forneça o ID da solicitação ao suporte técnico para solução de problemas.

Ocorreu um erro interno durante a execução, tente novamente mais tarde ou entre em contato com o suporte técnico. / erro de processo de algoritmo. /erro de inferência. / Ocorre um erro interno durante o cálculo. Tente este modelo mais tarde.

Causa: Ocorreu um erro interno no algoritmo.

Solução: Tente novamente mais tarde.

índice da lista fora do intervalo

Causa: O último elemento na matriz de mensagens deve ser uma Mensagem do Usuário.

Solução: Ajuste o messages array então o último elemento é {"role": "user", ...}.

500-InternalError.Timeout

Ocorreu um erro de tempo limite interno durante a execução. Tente novamente mais tarde ou entre em contato com o suporte do serviço.

Causa: uma tarefa assíncrona não retornou nenhum resultado em três horas.

Solução: verifique o status de execução da tarefa ou entre em contato com o suporte técnico.

500-Erro do sistema

Ocorreu um erro de sistema, tente novamente mais tarde.

Causa: Ocorreu um erro no sistema.

Solução: Tente novamente mais tarde.

500-ModelServiceFailed

Falha ao solicitar serviço de modelo.

Causa: Falha na chamada de serviço do modelo.

Solução: Tente novamente mais tarde.

500-RequestTimeOut

A solicitação expirou. Tente novamente mais tarde. /Tempo limite de resposta! / Erro de E/S na solicitação POST para "https://maas.qwencloudapi.com/compatible-mode/v1/chat/completions": tempo limite

Causa:

• Modelo de idioma: a solicitação expirou (o tempo limite é de 300 segundos).

• Reconhecimento de fala (Paraformer): Nenhum áudio ou apenas áudio silencioso foi enviado por muito tempo.

• Modelo de geração/edição de imagens: O tempo de processamento excedeu o limite devido às grandes dimensões da imagem ou alta complexidade.

Solução:

• Modelo de linguagem: use saída de streaming. Consulte Saída de streaming.

• Paraformador: Conjunto heartbeat para trueou encerre a tarefa de reconhecimento imediatamente.

• Modelo de imagem: reduza a resolução da imagem, simplifique os requisitos de edição ou tente novamente mais tarde.

500-ResponseTimeout

Tempo limite do fluxo de resposta

Causa: Ocorreu um tempo limite de execução interno ao usar o modelo Fun-Music.

Solução: Tente novamente mais tarde.

500-InvokePluginFailed

Falha ao invocar o plugin.

Causa: Falha na chamada do plug-in.

Solução: Verifique a configuração e a disponibilidade do plug-in.

500-AppProcessFailed

Falha ao prosseguir com a solicitação de inscrição.

Causa: Falha no fluxo do aplicativo.

Solução: verifique a configuração do aplicativo e os nós de fluxo.

500-RewriteFailed

Falha ao reescrever o conteúdo do prompt.

Causa: Falha na chamada do modelo de reescrita de prompt.

Solução: Tente novamente mais tarde.

500-Recuperação falhou

Falha ao recuperar dados de documentos.

Causa: Falha na recuperação do documento.

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

500/503-Serviço indisponível

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

Causa: Os recursos da rede estão saturados.

Solução: Tente novamente mais tarde.

503-Modelo não disponível

O modelo não está disponível. Tente novamente mais tarde.

Causa: O modelo está temporariamente indisponível.

Solução: Tente novamente mais tarde.

Erros do SDK

error.AuthenticationError: Nenhuma chave de API fornecida. Você pode definir por dashscope.api_key = your_api_key no código ou pode defini-lo por meio da variável de ambiente DASHSCOPE_API_KEY= your_api_key.

Causa: Nenhuma chave de API foi fornecida ao usar o DashScope SDK.

Solução: Consulte Configurar sua chave de API.

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

Causa: Nenhuma chave de API foi fornecida.

Solução:

• Passe a chave API usando uma variável de ambiente (recomendado)

Definir DASHSCOPE_API_KEY (veja Configurar sua chave API). Ao inicializar o client, leia a chave com os.getenv:

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

• Passe a chave API em texto simples (somente teste)

Passe a chave API diretamente para api_key:

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

Observação: Isso representa um risco à segurança. Não use na produção.

Solicitação incorreta para URL: xxx

Causa: Adicionando response.raise_for_status() com a biblioteca de solicitações Python evita que os detalhes do erro do servidor sejam retornados.

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

Não é possível resolver o símbolo 'ttsv2'

Causa: O SDK do DashScope está desatualizado para síntese de fala (CosyVoice).

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

##Erro de rede

NoApiKeyException: não é possível encontrar a chave de API.

Causa: A variável de ambiente não entrou em vigor.

Solução: Reinicie o cliente ou IDE e tente novamente. Consulte Perguntas frequentes.

ConnectException: Falha ao conectar ao maas.qwencloudapi.com

Causa: A rede local tem um problema.

Solução: Verifique as configurações da rede local. Você pode ter um problema de certificado que impede o acesso HTTPS ou um firewall configurado incorretamente. Experimente um ambiente de rede ou servidor diferente.

InputRequiredException: Parâmetro inválido: o texto é nulo

Causa: Ao usar síntese de fala (CosyVoice), o texto a ser sintetizado não foi enviado.

Solução: atribua um valor ao text parâmetro.

MultiModalConversation.call() faltando 1 argumento posicional obrigatório: 'messages'

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

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

incompatível_modelo

O modelo 'xxx' para esta solicitação não corresponde ao restante do lote. Cada lote deve conter solicitações de um único modelo.

Causa: Em uma única tarefa em lote, todas as solicitações devem usar o mesmo modelo.

Solução: Verifique seu arquivo de entrada de acordo com o formato do arquivo de entrada.

duplicado_custom_id

O custom_id 'xxx' para esta solicitação é uma duplicata de outra solicitação. O parâmetro custom_id deve ser exclusivo para cada solicitação em um lote.

Causa: Em uma única tarefa em lote, o ID de cada solicitação deve ser exclusivo.

Solução: Verifique o arquivo de entrada de acordo com o formato do arquivo de entrada e garanta que todos os IDs de solicitação sejam exclusivos.

A capacidade de upload do arquivo excede o limite. / O número do arquivo de upload excede o limite.

Causa: Falha no upload do arquivo. O espaço de armazenamento da conta corrente está cheio ou quase cheio.

Solução: Use o Compatível com OpenAI - Arquivo API para excluir arquivos desnecessários. O armazenamento suporta até 10.000 arquivos e 100 GB no total.

Erros de WebSocket

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

Causa: Ao usar o reconhecimento de fala por streaming com o Paraformer, os dados do resultado do reconhecimento são muito grandes.

Solução: Envie áudio em segmentos. Cada segmento deve ter cerca de 100 milissegundos, com dados entre 1 KB e 16 KB.

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

Causa: Ao usar CosyVoice síntese de voz, uma conexão WebSocket não pôde ser estabelecida em 5 segundos.

Solução: verifique as configurações de rede local e firewall ou tente um ambiente de rede diferente.

formato de áudio não suportado:xxx

Causa: O CosyVoice o formato de áudio de clonagem de voz não atende aos requisitos.

Solução: Use WAV (16 bits), MP3 ou M4A. A extensão do arquivo por si só não garante o formato. Use uma ferramenta como ffprobe ou mediainfo para confirmar o formato de codificação.

erro interno desconhecido

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

Solução: Use WAV (16 bits), MP3 ou M4A. Use uma ferramenta como ffprobe ou mediainfo para confirmar o formato de codificação.

Resposta de back-end inválida recebida (nome de status ausente)

Causa: Ao usar a API RESTful para reconhecimento de arquivos de áudio com o Paraformer, um parâmetro de solicitação é digitado incorretamente.

Solução: compare seu código com a referência da API.

NÃO_INPUT_AUDIO_ERROR

Causa: Nenhuma fala válida foi detectada.

Solução: Para reconhecimento de fala em tempo real com Paraformer:

1. Verifique se há entrada de áudio.

2. Verifique se o formato de áudio está correto. Formatos suportados: pcm, wav, mp3, opus, speex, aac, amr.

SUCESSO_COM_NO_VALID_FRAGMENT

Causa: A consulta de reconhecimento do Paraformer foi bem-sucedida, mas o VAD não detectou nenhuma fala válida.

Solução: verifique se o áudio contém fala válida. O silêncio puro não produz nenhum resultado de reconhecimento.

ASR_RESPONSE_HAVE_NO_WORDS

Causa: A consulta de reconhecimento do Paraformer foi bem-sucedida, mas o resultado final está vazio.

Solução: verifique se o áudio contém fala válida ou se toda a fala é composta por palavras de preenchimento filtradas por disfluency_removal_enabled.

ARQUIVO_DOWNLOAD_FALHA

Causa: Falha no download do arquivo de áudio do Paraformer.

Solução: verifique se o caminho do arquivo de áudio está correto e acessível externamente.

ARQUIVO_CHECK_FAILED

Causa: O formato do arquivo de áudio do Paraformer está incorreto.

Solução: Use o formato WAV ou MP3 de faixa única/faixa dupla.

ARQUIVO_TOO_LARGE

Causa: O arquivo de áudio do Paraformer é muito grande.

Solução: se o arquivo exceder 2 GB, segmente-o em arquivos menores.

ARQUIVO_NORMALIZAR_FAILED

Causa: O arquivo de áudio do Paraformer não foi normalizado.

Solução: Verifique se o arquivo de áudio está corrompido e pode ser reproduzido.

ARQUIVO_PARSE_FAILED

Causa: Falha ao analisar o arquivo de áudio do Paraformer.

Solução: Verifique se o arquivo de áudio está corrompido e pode ser reproduzido.

MKV_PARSE_FAILED

Causa: Falha ao analisar o arquivo MKV do Paraformer.

Solução: Verifique se o arquivo de áudio está corrompido e pode ser reproduzido.

ARQUIVO_TRANS_TASK_EXPIRED

Causa: A tarefa de reconhecimento de arquivo de áudio do Paraformer expirou.

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

PEDIDO_INVALID_FILE_URL_VALUE

Causa: O Paraformador file_url parâmetro é inválido.

Solução: Verifique o file_url formato do parâmetro.

CONTEÚDO_LENGTH_CHECK_FAILED

Causa: O Paraformador content-length verificação falhou.

Solução: Verifique content-length na resposta HTTP corresponde ao tamanho real do arquivo.

ARQUIVO_404_NOT_FOUND

Causa: O arquivo Paraformer não existe.

Solução: verifique o URL do arquivo.

ARQUIVO_403_PROIBIDO

Causa: Você não tem permissão para baixar o arquivo de áudio do Paraformer.

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

ARQUIVO_SERVER_ERROR

Causa: O servidor de arquivos não está disponível.

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

ÁUDIO_DURAÇÃO_TOO_LONG

Causa: O arquivo de áudio do Paraformer excede 12 horas.

Solução: segmente o áudio e envie diversas tarefas de reconhecimento. Use ferramentas como FFmpeg para dividir o áudio.

DECODE_ERROR

Causa: O Paraformer não conseguiu detectar as informações do arquivo de áudio.

Solução: verifique se o arquivo está em um formato de áudio compatível.

NÃO_VALID_AUDIO_ERROR

Causa: Ao usar o Paraformer, o áudio é inválido.

Solução: verifique se o formato de áudio, a taxa de amostragem e outros parâmetros atendem aos requisitos.

InvalidParameter: a tarefa não pode ser nula

Causa: O input campo está faltando na carga útil da instrução run-task ou finish-task, ou o campo input.text campo está faltando na instrução continue-task no CosyVoice API WebSocket.

Solução:

1. instrução run-task: verifique se a carga contém "input": {} (um objeto vazio). O input campo é obrigatório.

2. instrução de continuação da tarefa: Verifique payload.input contém o text campo com um valor não vazio.

3. instrução de conclusão da tarefa: verifique se a carga contém "input": {}.

código de fechamento 1007 Modelo não encontrado

Causa: Ao chamar um modelo em tempo real (por exemplo, Qwen3.5-Omni-Flash-Realtime) pelo protocolo WebSocket, o nome do modelo na solicitação está incorreto ou o serviço de modelo não está ativado. O servidor fecha a conexão com código de fechamento 1007 e razão Model not found.

Solução:

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

200-BailianGateway.Workspace.NotAuthorised

Causa: Este erro pode ocorrer devido a: (1) O URL acessado contém caracteres especiais ou usa um formato não padrão, o que faz com que a validação da autorização do espaço de trabalho falhe. (2) Um usuário de subconta tentou operar em um espaço de trabalho sem as permissões necessárias.

Solução: (1) Retorne ao QwenCloud página inicial e navegue até a página de destino. (2) O proprietário da conta ou um usuário com permissões de administrador deve conceder as permissões de espaço de trabalho necessárias ao usuário da subconta.

200-BailianGateway.Team.NotAuthorised

Causa: O usuário da subconta atual não tem permissão para a equipe (organização) que está acessando. Quando um usuário de subconta acessa recursos de equipe (organização) para os quais não está autorizado, a verificação de autorização em nível de equipe do gateway falha e retorna esse erro.

Solução: o proprietário da conta ou um usuário com permissões de administrador deve adicionar o usuário da subconta à equipe (organização) correspondente e conceder as permissões apropriadas no gerenciamento de permissões.