Alibaba Cloud Model Studio:Códigos de error

Este tema describe los mensajes de error comunes que podría encontrar al utilizar Alibaba Cloud Model Studio y proporciona soluciones.

400-InvalidParameter

parameter.enable_thinking debe establecerse en false para llamadas sin streaming/parameter.enable_thinking solo admite llamadas en streaming

Causa: Llamó a un modelo en modo de pensamiento utilizando un método de salida sin transmisión.

Solución: Establezca el parámetro enable_thinking en false, o utilice el método de salida en streaming para llamar al modelo de modo de pensamiento.

El parámetro thinking_budget debe ser un entero positivo y no mayor que xxx

Causa: El parámetro thinking_budget está fuera del rango permitido.

Solución: Consulte la longitud máxima de cadena de pensamiento indicada para el modelo en la Lista de modelos y configure este parámetro con un valor mayor que 0 y no superior a dicho límite.

Este modelo solo admite modo streaming; habilite el parámetro stream para acceder al modelo. / La API del usuario actual no admite llamadas HTTP.

Causa: El modelo solo admite salida en streaming, pero el streaming no se habilitó durante la llamada.

Solución: Utilice el método de salida en streaming para llamar al modelo.

Este modelo no admite enable_search.

Causa: El modelo actual no admite la capacidad de búsqueda web, pero el parámetro enable_search se estableció en true.

Solución: Llame a un modelo que admita búsqueda web.

¡La configuración de idioma actual no es compatible!

Causa: Al utilizar el modelo Qwen-MT, el formato de source_lang o target_lang es incorrecto o no está incluido en los idiomas admitidos.

Solución: Proporcione el nombre en inglés o el código de idioma correctos.

El parámetro incremental_output debe ser "true" cuando enable_thinking es true

Causa: Cuando el modo de pensamiento está habilitado, el modelo solo admite salida en streaming incremental, pero el parámetro incremental_output no se estableció en true.

Solución: Establezca el parámetro incremental_output en true antes de realizar la llamada. La API devolverá entonces contenido incremental.

El parámetro incremental_output de este modelo no se puede establecer en False.

Causa: El modelo solo admite salida en streaming incremental, pero el parámetro incremental_output no se estableció en true.

Solución: Establezca el parámetro incremental_output en true antes de realizar la llamada. La API devolverá entonces contenido incremental.

El rango de longitud de entrada debe ser [1, xxx] (InternalError.Algo.InvalidParameter)

Causa: La longitud de entrada supera el límite máximo del modelo.

Solución:

• Si realiza la llamada mediante código, asegúrese de que el recuento total de tokens en la matriz messages se mantenga dentro del límite máximo de tokens de entrada del modelo.
• Al utilizar un cliente de chat (como Chatbox) o la consola de Alibaba Cloud Model Studio para conversaciones continuas, cada solicitud incluye el historial de conversación, lo que puede exceder fácilmente el límite del modelo. Si esto ocurre, inicie una nueva conversación.

El rango de max_tokens debe ser [1, xxx]

Causa: El parámetro max_tokens no se encuentra dentro del rango [1, tokens máximos de salida del modelo].

Solución: Consulte el valor de "Tokens Máximos de Salida" en la documentación de la Lista de Modelos para conocer el límite superior de max_tokens.

Temperature debe estar en [0.0, 2.0)/'temperature' debe ser Float

Causa: El parámetro temperature está fuera del rango [0.0, 2.0).

Solución: Establezca el parámetro temperature en un número mayor o igual a 0 y menor que 2.

El rango de top_p debe ser (0.0, 1.0]/'top_p' debe ser Float

Causa: El parámetro top_p está fuera del rango (0.0, 1.0].

Solución: Establezca el parámetro top_p en un número mayor que 0 y menor o igual a 1.

El parámetro top_k debe ser mayor o igual que 0

Causa: El parámetro top_k está establecido en un número menor que 0.

Solución: Establezca el parámetro top_k en un número mayor o igual a 0.

Repetition_penalty debe ser mayor que 0.0

Causa: El parámetro repetition_penalty está establecido en un número menor o igual a 0.

Solución: Establezca el parámetro repetition_penalty en un número mayor que 0.

Presence_penalty debe estar en [-2.0, 2.0]

Causa: El parámetro presence_penalty está fuera del rango [-2.0,2.0].

Solución: Establezca el parámetro presence_penalty dentro del rango [-2.0,2.0].

El rango de n debe ser [1, 4]

Causa: El parámetro n no se encuentra dentro del rango [1, 4].

Solución: Establezca el parámetro n dentro del rango [1, 4].

El rango de seed debe ser [0, 9223372036854775807]

Causa: Al utilizar el protocolo DashScope, el parámetro seed no se encuentra dentro del rango [0, 9223372036854775807].

Solución: Establezca el parámetro seed dentro del rango [0, 9223372036854775807].

El método de solicitud 'GET' no es compatible.

Causa: La API actual no admite el método de solicitud GET.

Solución: Consulte la referencia de la API y utilice un método de solicitud compatible (como POST) para reenviar la solicitud.

Los mensajes con rol "tool" deben ser una respuesta a un mensaje precedente con "tool_calls"

Causa: Durante la llamada de herramientas, no agregó un Assistant Message al arreglo messages.

Solución: Agregue la primera respuesta de Mensaje del Asistente del modelo al arreglo de mensajes antes de agregar el Mensaje de Herramienta.

Un mensaje de asistente con "tool_calls" debe ir seguido de mensajes de herramienta que respondan a cada "tool_call_id"

Causa: Un mensaje de asistente que contiene tool_calls debe ir seguido de mensajes con el rol tool que respondan a cada tool_call_id. Este error suele indicar que la secuencia de mensajes enviada a la API de Model Studio durante la llamada de herramientas está mal formada, por ejemplo, un mensaje de usuario sigue directamente a un mensaje de asistente que contiene tool_calls.

Solución: Después del mensaje de asistente que contiene tool_calls, y antes de enviar el siguiente mensaje de usuario, inserte los mensajes correspondientes con el rol tool. Cada uno de estos mensajes debe llevar el tool_call_id coincidente y el resultado de la ejecución de esa herramienta. Cada tool_call_id en el mensaje de asistente debe ser respondido exactamente por un mensaje tool.

Cuerpo requerido no válido; verifique el formato del cuerpo de la solicitud.

Causa: El formato del cuerpo de la solicitud no cumple con los requisitos de la API.

Solución: Verifique el cuerpo de la solicitud para asegurarse de que sea un JSON válido. Los problemas comunes incluyen comas finales (,), corchetes sin cerrar y comillas sin cerrar.

Ejemplo incorrecto (al campo text le falta la comilla de cierre, por lo que el cuerpo no es un 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}]}]}}

Ejemplo correcto:

{"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 la solicitud, puede validar la sintaxis del cuerpo de la solicitud con un validador JSON como jsonlint.com. También puede utilizar el modelo grande para ayudar a corregir el formato del cuerpo de la solicitud.

el contenido de entrada debe ser una cadena.

Causa: Los modelos de texto sin formato no admiten establecer el campo content en messages en un tipo que no sea cadena.

Solución: No establezca content en un tipo de matriz como [{"type": "text","text": "Who are you?"}].

El campo content es un campo obligatorio.

Causa: Al realizar una solicitud, no especificó el parámetro content, por ejemplo: {"role": "user"}.

Solución: Especifique el parámetro content, por ejemplo: {"role": "user","content": "Who are you?"}.

Debe existir "prompt" o "messages" y ambos no pueden ser none

Causa: Al llamar a un modelo de lenguaje grande, no especificó ni el parámetro messages ni el parámetro prompt (que está obsoleto). Si especificó messages pero aún recibió un error, es posible que el formato sea incorrecto; por ejemplo, al usar DashScope-HTTP, messages debe colocarse dentro de un objeto input, no al mismo nivel que el parámetro model.

Solución: Especifique el parámetro messages. Si ya lo hizo pero sigue recibiendo un error, consulte la referencia de la API de generación de texto para verificar su ubicación.

'messages' debe contener la palabra 'json' en alguna forma para usar 'response_format' de tipo 'json_object'.

Causa: Al utilizar salida estructurada, el prompt no incluye la palabra clave json.

Solución: Agregue la palabra clave json (sin distinción entre mayúsculas y minúsculas) a su prompt, por ejemplo: “Por favor, genere la salida en formato JSON.”

La respuesta en modo Json no es compatible cuando enable_thinking es true

Causa: Habilitó el modo de pensamiento del modelo mientras utilizaba salida estructurada.

Solución: Al utilizar salida estructurada, establezca enable_thinking en false para desactivar el modo de pensamiento. Alternativamente, consulte las preguntas frecuentes ¿Cómo utilizar la salida estructurada con modelos en modo de pensamiento?

Los nombres de herramientas no pueden ser [search]

Causa: El nombre de la herramienta no puede establecerse como search.

Solución: Establezca el nombre de la herramienta en un valor distinto de search.

Formato desconocido de response_format; response_format debe ser un dict que incluya 'type' y una clave opcional 'json_schema'. El tipo de response_format proporcionado por el usuario es xxx.

Causa: El parámetro response_format especificado no cumple con los requisitos.

Solución: Para utilizar salida estructurada, establezca el parámetro response_format en {"type": "json_object"}.

El valor del parámetro enable_thinking está restringido a True.

Causa: Para ciertos modelos (como qwen3.7-plus), no puede establecer el parámetro enable_thinking en false.

Solución:

• Si llama a través de una herramienta de terceros (como Cherry Studio), active el interruptor de pensamiento en el cuadro de entrada.
• Si realiza la llamada mediante código, establezca enable_thinking en true.

La salida 'audio' solo es compatible con stream=true

Causa: La solicitud requiere salida de audio, pero la transmisión no estaba habilitada.

Solución: Establezca el parámetro stream en true para habilitar la salida por transmisión.

tool_choice es una de las cadenas que deben ser ["none", "auto"]

Causa: El parámetro tool_choice es incorrecto durante la llamada a funciones.

Solución: Establézcalo en "auto" (permita que el LLM elija herramientas autónomamente) o "none" (fuerce la no utilización de herramientas).

El modelo no existe.

Causa: El parámetro model no es válido o tiene un formato incorrecto.

Solución:

• Verificar formato del nombre del modelo: Asegúrese de que el parámetro model utilice las mayúsculas correctas y no contenga espacios adicionales.
• Utilice el nombre de modelo correcto: Compare el model que ingresó con los nombres de modelo en la Lista de modelos para asegurarse de que sea correcto. No mezcle nombres de modelos de la comunidad de código abierto con los ID de modelos de Model Studio, como usar qwen3.7-plus en lugar de Qwen/Qwen3.7-Plus.

El parámetro result_format debe ser "message" cuando enable_thinking es true

Causa: Al llamar a un modelo en modo de pensamiento, el parámetro result_format no se estableció en "message".

Solución: Establezca el parámetro result_format en "message".

El audio está vacío

Causa: El audio de entrada es demasiado corto, lo que resulta en puntos de muestreo insuficientes.

Solución: Aumente la duración del audio.

Análisis de archivo en curso, inténtelo de nuevo más tarde.

Causa: Al usar el modelo Qwen-Long, el archivo aún no ha terminado de analizarse.

Solución: Espere a que finalice el análisis del archivo antes de reintentar.

El parámetro "stop" debe ser de tipo "str", "list[str]", "list[int]" o "list[list[int]]", y todos los elementos dentro de la lista deben ser del mismo tipo.

Causa: El parámetro stop no cumple con el formato requerido: str, list[str], list[int], o list[list[int]].

Solución: Consulte la referencia de la API de generación de texto y configure correctamente el parámetro stop.

Error de valor, el tamaño del lote no es válido, no debe ser mayor que xxx.

Causa: Al llamar a un modelo de Embedding, el número de textos supera el límite del modelo.

Solución: Consulte la información sobre tamaño de lote en la documentación de Embedding y controle el número de textos de entrada.

[] es demasiado corto

Causa: La matriz de mensajes de entrada está vacía.

Solución: Agregue un mensaje antes de enviar la solicitud.

La llamada a la herramienta no es compatible.

Causa: El modelo que está utilizando no admite el parámetro tools.

Solución: Cambie a un modelo Qwen o DeepSeek que admita Function Calling.

La entrada de mensajes proporcionada no es válida. La información del error es [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: El campo content de un mensaje en la matriz messages contiene un elemento de un tipo no admitido. Cuando content es una matriz, cada elemento debe ser una cadena o un objeto válido (como {"type": "text", "text": "..."} o {"type": "image_url", ...}). Pasar un número, un valor booleano, una matriz anidada o un objeto cuyo type no sea compatible activa este error. El código de estado HTTP correspondiente es 400 y el código de error es InternalError.Algo.InvalidParameter.

Escenario común: Cuando utiliza un modelo solo de texto (como la serie de texto Qwen-Max, incluyendo qwen3.7-max) y los messages (especialmente el historial de conversaciones de múltiples turnos) contienen elementos content multimodales como imágenes (image_url), también se activa este error, ya que los modelos solo de texto no aceptan imágenes ni otras entradas modales. En algunas herramientas integradas o agentes, este error puede mostrarse como un mensaje similar a "el proveedor del modelo devolvió contenido vacío".

Solución:

• Modelos solo de texto: Establezca content como una cadena en lugar de una matriz o cualquier otro tipo. Si su caso de uso requiere imágenes u otra entrada multimodal, cambie a un modelo multimodal (como las series Qwen-VL o Qwen3-VL); si debe seguir usando un modelo solo de texto, elimine los elementos multimodales como imágenes (image_url) de messages y del historial de conversaciones antes de realizar la llamada.
• Modelos multimodales: Cada elemento en el arreglo content debe ser un objeto válido cuyo type sea uno de los tipos de modalidad admitidos por el modelo, como text, image_url, video_url o video. No incluya números, valores booleanos, arreglos anidados ni elementos a los que les falte type o cuyo valor de type no sea válido.

Falta el parámetro requerido (xxx) o no es válido; por favor, revise los parámetros de la solicitud.

Causa: Los parámetros de llamada a la API no son válidos.

Solución: Verifique los parámetros de la solicitud para asegurarse de que todos los parámetros requeridos se proporcionen y tengan el formato correcto.

Cuando el mensaje de error especifica el parámetro data_sources, generalmente significa que al llamar a la API CreateIndex, se omitió el parámetro requerido SourceType, lo que provocó que la posterior API SubmitIndexJob fallara. Al crear una base de conocimientos a partir de documentos, establezca este parámetro en DATA_CENTER_FILE; al crearla a partir de categorías, establézcalo en DATA_CENTER_CATEGORY. Consulte la documentación de CreateIndex para obtener más detalles.

input debe contener file_urls

Causa: Al utilizar el reconocimiento de voz (Paraformer) para el reconocimiento de archivos grabados, no asignó un valor al parámetro de solicitud file_urls.

Solución: Incluya el parámetro file_urls en su solicitud y asígnele un valor.

La URL proporcionada no parece ser válida. Asegúrese de que tenga el formato correcto.

Causa: Al utilizar modelos de comprensión visual, omnimodales o de comprensión de audio, la URL o ruta local proporcionada no es válida o no cumple con los requisitos.

Solución:

• Pasar una URL: Debe comenzar con http://, https:// o data:. Si comienza con data:, incluya "base64" antes de los datos codificados en Base64.

• Al pasar una ruta local: Debe comenzar con file://.

• Pasar una URL temporal:
  • Para llamadas HTTP, asegúrese de que el encabezado de la solicitud incluya X-DashScope-OssResourceResolve: enable.
  • Para llamadas mediante SDK: Solo se admite DashScope SDK; no utilice OpenAI SDK.

La entrada debe ser un diccionario válido o una instancia de GPT3Message

Causa: El formato del campo messages no es válido; por ejemplo, corchetes no coincidentes o pares clave-valor faltantes.

Solución: Compruebe que la estructura JSON del campo messages sea correcta.

Error de valor, contents no es str ni lista de str.: input.contents

Causa: Al utilizar un modelo de Embedding, la entrada no es una cadena ni una lista de cadenas.

Solución: Cambie el formato de entrada a una cadena o una lista de cadenas.

No hay servidor backend disponible

Causa: El servicio backend de Model Studio no está disponible temporalmente. Esto puede deberse a una actualización del servicio, escalado, programación de recursos o un fallo transitorio.

Solución:

1. Inicie sesión en la consola de Alibaba Cloud y vaya a la página de Expenses and Costs para confirmar que su cuenta no tenga pagos vencidos. Si su cuenta tiene pagos vencidos, recárguela y espere unos minutos a que el pago surta efecto.
2. Use curl o ping para probar la conectividad a dashscope.aliyuncs.com.
3. Inicie sesión en la consola de Model Studio y verifique el estado del servicio.
4. Después de confirmar que su cuenta y red funcionan correctamente, espere unos minutos y vuelva a llamar a la API.

La entrada de la modalidad de video no cumple con los requisitos porque: el rango de imágenes de secuencia debe ser (4, 512)./(4,80).

Causa: Al utilizar el modelo VL de Qwen para ingresar video como una lista de imágenes, el número de imágenes no cumple con los requisitos.

Solución: Para los modelos de las series Qwen3-VL y Qwen2.5-VL, proporcione de 4 a 512 imágenes; para otros modelos, proporcione de 4 a 80 imágenes. Consulte Comprensión de imágenes y videos para obtener más detalles.

Se excedió el límite de bytes máximos por elemento data-uri: 10485760'. / El tamaño del archivo multimodal es demasiado grande

Causa: El archivo de imagen o video local pasado a un modelo multimodal (Qwen-VL, QVQ, Qwen-Omni) excede el límite de tamaño.

Solución:

• Archivos locales: Después de la codificación Base64, un solo archivo no debe exceder 10 MB.

• URLs de archivos: Los archivos de imagen no deben exceder 10 MB; para archivos de video:

  • Qwen3-VL, qwen3-vl-max: hasta 2 GB;
  • Serie qwen3-vl-plus: hasta 1 GB;
  • Otros modelos: hasta 150 MB.

Consulte ¿Cómo comprimir imágenes o videos para cumplir con los requisitos de tamaño?

La entrada debe ser 'Cherry', 'Serena', 'Ethan' o 'Chelsie': parameters.audio.voice

Causa: Al usar Qwen-Omni o Qwen-TTS, el parámetro voice es incorrecto.

Solución: Establézcalo en uno de los siguientes valores: 'Cherry', 'Serena', 'Ethan' o 'Chelsie'.

La longitud y el ancho de la imagen no cumplen con las restricciones del modelo.

Causa: Las dimensiones (ancho y alto) de la imagen pasada al modelo VL de Qwen no cumplen con los requisitos del modelo.

Solución: Las dimensiones de la imagen deben cumplir con lo siguiente: tanto el ancho como la altura deben ser de al menos 10 píxeles, y la relación de aspecto no debe exceder 200:1 o 1:200.

Error al decodificar la imagen durante la inspección de datos.

Causa: Error al decodificar la imagen.

Solución: Confirme que la imagen no esté dañada y que su formato sea compatible.

El formato del archivo no es válido y no se puede abrir. / El formato de audio no es válido y no se puede abrir. / El formato multimedia no es compatible o es incorrecto para la inspección de datos.

Causa: El formato de archivo no es compatible o el archivo no se puede abrir.

Solución: Confirme que el archivo no esté dañado, que la extensión del nombre del archivo coincida con el formato real y que el formato sea compatible.

Los mensajes de entrada no contienen elementos con el rol de usuario.

Causa:

• Al llamar al modelo, no pasó un Mensaje de Usuario;
• O bien, al llamar a una aplicación de flujo de trabajo de Alibaba Cloud Model Studio a través de la API, los parámetros pasados al nodo inicial deben enviarse mediante el parámetro biz_params (no user_prompt_params).

Solución: Asegúrese de pasar un User Message al modelo o de pasar correctamente los parámetros personalizados.

Error al descargar contenido multimodal. / Se agotó el tiempo de espera para descargar el recurso multimedia durante el proceso de inspección de datos. / No se pudo descargar el recurso multimedia durante el proceso de inspección de datos.

Causa: El servidor no puede descargar el archivo multimedia desde la URL pública, posiblemente debido a:

• Problema de conectividad: Se está utilizando una dirección de red interna de Alibaba Cloud Object Storage Service.
• Latencia de red: Acceso entre regiones que provoca tiempos de espera agotados.
• Inestabilidad del servicio: Servicio de almacenamiento de origen lento o inaccesible.
• Bloqueo por política de seguridad: El User-Agent que envía el servidor al descargar una URL pública contiene el identificador DashScopeUserBot. La política de seguridad de un servidor de terceros puede bloquear las solicitudes que llevan este identificador, provocando que la descarga falle.

Solución:

• Cambiar servicio de almacenamiento

  Utilice un servicio de almacenamiento en la misma región que el servicio de modelos. Recomendamos utilizar Alibaba Cloud Object Storage Service para generar URL públicas (no utilice direcciones internas).

• Ajustar método de transferencia

  Si falla al pasar una URL pública, consulte Pasar archivos locales (codificados en Base64 o rutas de archivo) y cambie al método recomendado:

  Tipo de archivo	Especificaciones del archivo	DashScope SDK (Python, Java)	Compatible con OpenAI / HTTP de DashScope
  Imagen	Mayor que 7 MB pero menor que 10 MB	Pasar ruta local	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Pasar ruta local	Codificado en Base64
  Video	Mayor que 100 MB	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service
  	Mayor que 7 MB pero menor que 100 MB	Pasar ruta local	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Pasar ruta local	Codificado en Base64
  Audio	Mayor que 10 MB	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service
  	Mayor que 7 MB pero menor que 10 MB	Pasar ruta local	Solo URL pública; recomendamos utilizar Alibaba Cloud Object Storage Service
  	Menor que 7 MB	Pasar ruta local	Codificado en Base64

  La codificación Base64 aumenta el tamaño de los datos; el archivo original debe ser menor que 7 MB.

  Usar Base64 o rutas locales evita tiempos de espera de descarga en el servidor y mejora la estabilidad.

• PermitirDashScopeUserBot

  Si la imagen está alojada en un servidor bajo su control, permita en su política de seguridad las solicitudes cuyo User-Agent contenga DashScopeUserBot. Alternativamente, pase archivos locales (codificados en Base64 o rutas de archivo) para que el servidor no necesite descargar la URL pública.

No se pudo encontrar el recurso multimedia solicitado durante el proceso de inspección de datos.

Causa: La URL del recurso proporcionada no es válida o es inaccesible.

Solución:

• Confirme que la URL tenga el formato correcto y sea accesible.
• Confirme que el archivo de recursos no se haya eliminado ni movido.
• Confirme que la URL no haya caducado (para URLs firmadas de OSS, verifique el período de validez).

error de url, ¡verifique la url!

• Causa 1: El nombre del modelo no coincide con el endpoint de la API: Por ejemplo, usar un endpoint multimodal para un modelo de texto plano, o un endpoint de texto plano para un modelo multimodal.

  Solución:

  1. Al utilizar modelos multimodales como qwen3.7-plus, qwen3-vl-plus, qwen3.8-max o qwen3.8-flash a través de DashScope: use MultiModalConversation.call() o el endpoint multimodal-generation. Consulte Comprensión de imágenes y videos. Al cambiar de un modelo de texto plano (como qwen3.7-max) a un modelo multimodal (como qwen3.8-max/qwen3.8-flash), cambie la invocación de Generation.call() a MultiModalConversation.call(); de lo contrario, la llamada devolverá un error de URL.

     Si utiliza el framework spring-ai-alibaba, confirme que ha establecido el parámetro multimodal withMultiModel.

  2. Al utilizar modelos de texto sin formato como qwen3.7-max, qwen-plus o deepseek-v4-pro a través de DashScope, use Generation.call() o el endpoint de generación de texto. Consulte Descripción general.

  3. Al utilizar la API de CosyVoice clonación de voz a través de DashScope: esta API incluye los parámetros model y target_model. Establezca model en voice-enrollment y target_model en el modelo específico de CosyVoice. Consulte CosyVoice API de Clonación/Diseño de Voz.

• Causa 2: La versión del SDK de DashScope está desactualizada: Las versiones anteriores del SDK no pueden reconocer la dirección correcta del servidor al llamar a modelos de generación de imágenes o videos.

  Solución: Actualice la versión del SDK

No tiene autorización para acceder al recurso multimedia durante el proceso de inspección de datos.

Causa: La URL firmada del archivo OSS pasada durante la invocación del modelo ha caducado.

Solución: Asegúrese de acceder al archivo dentro del periodo de validez de la URL.

El elemento de content debe ser un mensaje de una modalidad específica.

Causa: Al utilizar el SDK de DashScope para llamar a un modelo multimodal, cada elemento en el arreglo content debe tener una clave que sea una de las siguientes: image, video, audio o text.

Solución: Utilice el parámetro content correcto.

Archivo de video no válido.

Causa: El archivo de video proporcionado no es válido.

Solución: Compruebe si el archivo de video está dañado o si el formato es correcto.

La entrada de modalidad de video no cumple con los requisitos porque: El archivo de video es demasiado largo.

Causa: La duración del video excede el límite para los modelos Qwen VL o Qwen-Omni.

Solución:

• Qwen2.5-VL admite videos de entre 2 segundos y 10 minutos.
• Otros modelos Qwen VL y Qwen-Omni-Turbo admiten videos de entre 2 segundos y 40 segundos.

Para los límites de video de otros modelos Qwen-Omni, consulte Entrada de modalidad única.

Campo requerido: xxx

Causa: Falta un parámetro de entrada obligatorio.

Solución: Agregue el parámetro faltante según lo indicado por el mensaje de error xxx.

A la solicitud le faltan parámetros obligatorios o tiene un formato incorrecto; verifique los parámetros que envía.

Causa: Faltan parámetros requeridos o tienen un formato incorrecto.

Solución: Verifique que todos los parámetros de la solicitud estén completos y tengan el formato correcto.

Faltan archivos de entrenamiento.

Causa: Error de parámetro: faltan parámetros o el formato es incorrecto.

El estilo no es válido.

Causa: El valor de estilo está fuera de la enumeración permitida.

Solución: Verifique que el valor del parámetro style sea correcto.

El valor de style_level no es válido.

Causa: El valor de style_level está fuera de la enumeración permitida.

Solución: Consulte Generación de video EMO para obtener más detalles.

parameters.video_ratio debe ser 9:16 o 3:4.

Causa: El parámetro video_ratio solo puede ser 9:16 o 3:4.

Solución: Establezca el parámetro video_ratio en "9:16" o "3:4".

¡El parámetro xxx no es válido!

Causa: El parámetro de entrada excede el rango permitido.

Solución: Consulte Redibujado de estilo de video para obtener más detalles.

error de json de entrada.

Causa: El JSON de entrada no es válido.

Solución: Compruebe que el formato JSON de la solicitud sea correcto.

error al leer imagen.

Causa: Error al leer la imagen.

Solución: Compruebe si el archivo de imagen está dañado o si el formato es correcto.

los parámetros deben cumplir con la especificación: xxx.

Causa: El valor del parámetro de entrada excede el rango permitido.

Solución: Verifique y corrija el valor del parámetro según lo indicado por el mensaje de error xxx.

El tamaño de la imagen de persona y coarse_image no son iguales.

Causa: La resolución de coarse_image no coincide con person_image.

Solución: Asegúrese de que las resoluciones de coarse_image y person_image sean idénticas.

A la solicitud le faltan parámetros obligatorios o los parámetros están fuera del rango especificado; revise los parámetros que envía.

Causa: Faltan parámetros obligatorios de la API o están fuera de rango.

Solución: Verifique y corrija los parámetros de la solicitud.

error de formato de imagen

Causa: El formato de imagen es incorrecto.

Solución: Debe ser una URL de imagen o una cadena Base64.

No se encontraron mensajes en la entrada

Causa: Los parámetros de la solicitud deben incluir un campo messages.

Solución: Consulte Qwen - Edición de imágenes para más detalles.

Formato de imagen no válido o archivo dañado

Causa: El formato de la imagen de entrada es incorrecto o el archivo está dañado.

Solución: Verifique que el archivo se pueda abrir y descargar normalmente, y asegúrese de que esté completo y en un formato compatible.

Error al descargar la imagen

Causa: No se puede descargar la imagen.

Solución: Compruebe que el archivo se pueda descargar correctamente.

La longitud de messages solo admite 1

Causa: La longitud del arreglo messages solo admite 1.

Solución: Solo se puede pasar un mensaje de conversación. Consulte Qwen - Edición de Imágenes para más detalles.

La longitud del contenido solo admite 2

Causa: La longitud del arreglo content solo admite 2.

Solución: Solo se puede pasar un texto y una imagen. Consulte Qwen - Edición de Imágenes para más detalles.

Falta la imagen o el texto

Causa: A los parámetros de la solicitud les falta el campo de imagen o texto.

Solución: Consulte Qwen - Edición de imágenes para más detalles.

num_images_per_prompt debe ser 1.

Causa: El parámetro de la solicitud no es válido; el parámetro n (número de imágenes a generar) solo puede establecerse en 1.

Solución: Establezca el valor del parámetro n en 1.

Formato de archivos de entrada no compatible.

Causa: El formato de audio o imagen no cumple con los requisitos.

Solución: Formatos de audio admitidos: mp3, wav, aac; formatos de imagen admitidos: jpg, jpeg, png, bmp, webp. Consulte Generación de video LivePortrait para obtener más detalles.

Error al descargar los archivos de entrada.

Causa: Error en la descarga del archivo de entrada.

Solución: Compruebe que la URL del archivo sea accesible y que la red sea estable.

error de descarga de oss.

Causa: Error en la descarga de la imagen de entrada.

Solución: Compruebe que el enlace OSS de la imagen sea correcto y accesible.

El contenido de la imagen no cumple con la verificación de red segura.

Causa: El contenido de la imagen infringe las políticas de cumplimiento.

Solución: Reemplace la imagen por una que cumpla con las políticas de Moderación de Contenido.

error al leer video.

Causa: Error al leer el video.

Solución: Compruebe si el archivo de video está dañado o si el formato no es compatible.

el tamaño de la imagen de entrada es demasiado pequeño o demasiado grande.

Causa: Las dimensiones de la imagen de entrada son demasiado pequeñas o demasiado grandes.

Solución: Ajuste las dimensiones de la imagen para cumplir con los requisitos de la API.

El parámetro de la solicitud no es válido; por favor, revise el parámetro de la solicitud.

Causa: Este es un error genérico que ocurre en múltiples escenarios: el parámetro clothes_type no cumple con las normas (OutfitAnyone - Segmentación de imágenes) o el parámetro de relación de aspecto no cumple con las normas.

Solución: Consulte OutfitAnyone - Segmentación de imágenes para obtener más detalles. Para el parámetro de relación de aspecto: Las opciones válidas son "1:1" o "3:4".

El tipo o valor de {parameter} está fuera de la definición.

Causa: El tipo o valor del parámetro no cumple con los requisitos.

Solución: Consulte Generación de video LivePortrait para obtener más detalles.

tiempo de espera de la solicitud agotado después de 23 segundos.

Causa: No se enviaron datos al servicio durante más de 23 segundos. Este error ocurre al utilizar reconocimiento de voz (Paraformer) y síntesis de voz en tiempo real (CosyVoice).

Solución: Compruebe por qué no se enviaron datos al servidor durante un periodo prolongado. Si no se envía ningún mensaje al servidor durante más de 23 segundos, finalice la tarea inmediatamente.

Asegúrese de que el texto de entrada sea válido.

Causa: Si está utilizando síntesis de voz en tiempo real (CosyVoice), este error suele ocurrir porque no se envió texto para sintetizar. Las posibles causas incluyen las siguientes: parámetro faltante (no se asignó valor al parámetro text) o excepciones de código (falló la asignación a text).

Solución: Depure su código para asegurar que el parámetro text se asigne y envíe correctamente.

¡Falta el parámetro obligatorio 'xxx'! ¡Por favor, siga el protocolo!

Ejemplos de errores:

• ¡Falta el parámetro obligatorio 'payload.model'! ¡Siga el protocolo!
• ¡Falta el parámetro obligatorio 'payload.task_group'! ¡Siga el protocolo!

Causa:

1. El formato JSON del evento WebSocket es incorrecto (causa general).

   Al llamar a modelos mediante el protocolo WebSocket, el formato JSON enviado no es válido. Los problemas comunes incluyen los siguientes:

   • Anidación JSON incorrecta: los parámetros no están colocados en el nivel jerárquico correcto.
   • Nombre de parámetro mal escrito; por ejemplo, task_group escrito como taskgroup.
   • El valor del parámetro está vacío o no está asignado correctamente.

2. El método call() no se volvió a invocar después de stop() (escenario específico).

   Esto aplica únicamente a: DashScope Java SDK para reconocimiento de voz en tiempo real de Fun-ASR o Paraformer.

   Después de llamar al método stop() para finalizar el reconocimiento, no volvió a llamar al método call() antes de enviar más datos, lo que provocó un estado de sesión no válido y desencadenó este error.

   Diferencia entre usuarios de SDK y usuarios de WebSocket: "Missing required parameter" es un error a nivel de protocolo devuelto por el servidor y aparece solo cuando se usa directamente el protocolo WebSocket. Si utiliza la clase Recognition del SDK de Java de DashScope, el SDK intercepta esta operación en el lado del cliente y lanza una excepción de "Invalid state" ("Expected recognition state should be started, but current state is idle") en lugar de devolver el error "Missing required parameter".

Solución:

1. Para la causa 1, verifique el formato JSON y los parámetros.
2. Para la causa 2, asegúrese de que después de cada llamada a stop(), vuelva a llamar al método call() antes de la siguiente ronda de reconocimiento. Si utiliza el SDK de Java de DashScope, esté atento a la excepción "Invalid state" en el lado del cliente; si utiliza directamente el protocolo WebSocket, recibirá el error "Missing required parameter".

[tts:]El motor devolvió el código de error: 418

Causa: Al utilizar síntesis de voz en tiempo real (CosyVoice), el parámetro de solicitud voice (timbre) es incorrecto, o las versiones de model y voice no coinciden.

Solución:

1. Verifique voice la asignación del parámetro:

   • Si utiliza timbres predeterminados, verifíquelos en la sección "parámetro voice" del SDK de Python.
   • Si utiliza timbres clonados, use la API de clonación/diseño de voz de CosyVoice para confirmar que el estado del timbre es "OK" y que el timbre pertenece a la misma cuenta que realiza la llamada.

2. Verificar compatibilidad de versiones: Los modelos v2 solo pueden usar timbres v2; los modelos v1 solo pueden usar timbres v1. No mezcle versiones.

¡La voz solicitada no es válida!

Causa: Si está utilizando síntesis de voz en tiempo real (CosyVoice), este error suele ocurrir porque no se estableció ningún timbre.

Solución: Verifique que se haya asignado un valor al parámetro voice. Si está utilizando la referencia de la API de WebSocket, configure los parámetros en el formato JSON correcto según se especifica en la documentación de la API.

ref_images_url y obj_or_bg deben tener la misma longitud.

Causa: Al utilizar la función de referencia de múltiples imágenes en Wanxiang - Edición de video (2.1), las longitudes de las matrices de ref_images_url y obj_or_bg no coinciden.

Solución: Asegúrese de que las longitudes de los arreglos de ref_images_url y obj_or_bg sean idénticas.

verifique el estilo de los datos de entrada.

Causa: Los parámetros de entrada no cumplen con los requisitos.

Solución: Verifique y corrija los parámetros de entrada.

Ocurrió un error durante el preprocesamiento del modelo.

Causa: El campo content se pasó en un formato incorrecto.

Solución:

• Si realiza la llamada mediante código, no establezca content en un tipo de matriz como [{"type": "text", "text": "Who are you?"}].

El tamaño de la imagen no es compatible con la inspección de datos.

Causa:

• Las dimensiones (ancho y alto) de la imagen pasada al modelo VL de Qwen no cumplen con los requisitos del modelo.
• El tamaño de la imagen de salida excede el límite de 10 MB.

Solución:

• Las dimensiones de la imagen deben cumplir:

  • Tanto el ancho como la altura son de al menos 10 píxeles.
  • La relación de aspecto no debe exceder 200:1 o 1:200.

• Ajuste los parámetros para las imágenes generadas.

Content-Type incorrecto en la URL multimodal

Causa: El campo Content-Type en el encabezado de respuesta de la URL es incorrecto.

Tipos de contenido admitidos para los modelos Qwen VL: image/bmp, image/icns, image/x-icon, image/jpeg, image/jp2, image/png, image/sgi, image/tiff, image/webp. Consulte Formatos de imagen admitidos por los modelos Qwen VL para obtener más detalles.

Solución:

Verificar el campo Content-Type

1. Abra un navegador (como Chrome o Firefox).
2. Abra las herramientas para desarrolladores (generalmente presionando F12 o haciendo clic derecho y seleccionando "Inspect").
3. Cambie a la pestaña Network.
4. Ingrese la URL de la imagen en la barra de direcciones y visítela.
5. Encuentre la solicitud correspondiente y busque en Headers > Response Headers el campo Content-Type.

Campo obligatorio: image_url

Causa: Falta el parámetro de entrada image_url.

Solución: Consulte Generación de video Emoji y pase el parámetro image_url.

Campo obligatorio: driven_id

Causa: Falta el parámetro de entrada driven_id.

Solución: Consulte Generación de video Emoji y pase el parámetro driven_id.

ext_bbox no válido

Causa: El parámetro ext_bbox de entrada no es válido.

Solución: Consulte Generación de video Emoji y pase el valor correcto de ext_bbox.

Driven no existe: driven_id

Causa: La entrada driven_id no existe.

Solución: Consulte Generación de video Emoji y pase el valor correcto de driven_id.

Se ha infringido el límite de solicitud de texto, se esperaba 1.

Causa: Al llamar a la CosyVoice referencia de la API WebSocket de síntesis de voz, configuró enable_ssml como true y envió la instrucción continue-task varias veces.

Solución: Cuando enable_ssml está establecido en true, solo puede enviar la instrucción de continuar tarea una vez.

¡El texto SSML no es compatible en este momento!

Causa: Al utilizar la síntesis de voz de CosyVoice, el modelo o timbre actual no admite SSML, o la funcionalidad SSML no está habilitada correctamente.

Solución: Solucione el problema según Límites y restricciones.

[tts:]El motor devolvió el código de error: 428

Causa: El parámetro instruction de síntesis de voz de CosyVoice se utiliza incorrectamente. Los problemas específicos pueden incluir los siguientes:

• Longitud excedida: instruction no puede exceder 100 caracteres (los caracteres chinos cuentan como 2 caracteres; los demás como 1).

• Error de formato o idioma: Solo los siguientes modelos admiten instruction, con reglas diferentes:

  • cosyvoice-v3.5-flash, cosyvoice-v3.5-plus: se permiten instrucciones de forma libre (por ejemplo, emoción, velocidad).

  • cosyvoice-v3-flash:

    • Debe seguir un formato fijo.
    • Solo se admite instruction en chino.
    • El instruction admitido varía según el timbre. Consulte la Lista de timbres de CosyVoice para obtener más detalles.

Solución:

• Verifique que la longitud en caracteres de instruction no exceda 100.
• Confirme que su modelo admite el parámetro instruction.
• Al utilizar cosyvoice-v3-flash, asegúrese de que instruction esté en chino y siga el formato fijo correspondiente al timbre.

Debe proporcionarse al menos uno de los campos 'lyrics' o 'prompt'.

Causa: Al utilizar el modelo Fun-Music, la solicitud no incluyó el parámetro lyrics o prompt.

Solución: Incluya al menos lyrics o prompt en la solicitud.

El contenido de la letra es ilegal y no se puede utilizar para la generación de música.

Causa: Al utilizar el modelo Fun-Music, el contenido de la letra falló las verificaciones de cumplimiento, posiblemente por contener material infractor.

Solución: Modifique la letra para asegurar que no contenga contenido infractor o no conforme, y vuelva a intentarlo.

400-invalid_request_error-invalid_value

-1 es menor que el mínimo de 0 - 'seed'/'seed' debe ser Integer

Causa: Al utilizar el protocolo compatible con OpenAI, el parámetro seed no se encuentra dentro del rango [0, 2³¹-1].

Solución: Establezca el parámetro seed dentro del rango [0, 2³¹-1].

400-invalid_request_error

debe proporcionar un parámetro model.

Causa: La solicitud no incluyó el parámetro model.

Solución: Agregue el parámetro model a la solicitud.

400-InvalidParameter.NotSupportEnableThinking

El modelo xxx no admite enable_thinking.

Causa: El modelo actual no admite el parámetro enable_thinking.

Solución: Elimine el parámetro enable_thinking de la solicitud o utilice un modelo que admita el modo de pensamiento.

400-invalid_value

La voz solicitada 'xxx' no es compatible.

Causa: Durante la síntesis de voz en tiempo real de Qwen-TTS, el timbre seleccionado se generó mediante la clonación de voz de Qwen-TTS, pero los modelos utilizados difieren.

Solución: Verifique que el parámetro target_model utilizado durante la clonación de voz coincida con el parámetro model utilizado durante la síntesis de voz.

400-Arrearage

Acceso denegado; asegúrese de que su cuenta esté en buen estado.

Causa: La cuenta de Alibaba Cloud asociada con la API Key tiene un pago vencido, lo que causa la denegación de acceso.

Solución: Vaya a Gastos y costos para verificar si hay pagos pendientes:

• Sin pagos vencidos: Confirm que la API Key pertenece a la cuenta actual. Si su cuenta no tiene saldos vencidos, es posible que presente alguna anomalía. Para más detalles, póngase en contacto con el servicio de atención al cliente para una solución adicional.
• Pago vencido: Recargue prontamente. Después de recargar, las actualizaciones del saldo del sistema pueden retrasarse; espere un momento antes de volver a intentarlo.

El proveedor de la API devolvió un error de facturación: su clave de API se quedó sin créditos o tiene un saldo insuficiente. Revise el panel de facturación de su proveedor y recargue o cambie a una clave de API diferente.

Causa: Cuando llama a Model Studio a través de un cliente de terceros como OpenClaw, si la cuenta subyacente tiene un pago pendiente o saldo insuficiente, el cliente agrega el error de facturación del lado del servidor en este mensaje. El código de error subyacente del lado del servidor de Model Studio es Arrearage (es decir, el mensaje Acceso denegado, asegúrese de que su cuenta esté en buen estado mencionado anteriormente). No se trata de un problema de facturación del propio cliente.

Solución: Vaya a Gastos y costos para verificar si hay pagos pendientes: si existe un pago pendiente, recargue saldo inmediatamente (la actualización del saldo del sistema puede tardar después de la recarga, así que espere un momento antes de reintentar); si no hay pagos pendientes, confirme que la API Key utilizada pertenece a la cuenta actual.

isv.OUT_OF_SERVICE

Causa: El saldo de la cuenta de Alibaba Cloud es insuficiente, por lo que el servicio ha sido suspendido.

Solución: Recargue su cuenta de Alibaba Cloud. El servicio se reanudará automáticamente una vez que el saldo sea suficiente.

400-Contain.Forbidden.Label.Error

Contiene etiqueta prohibida para crear pedido

Causa: La cuenta de Alibaba Cloud tiene una etiqueta que prohíbe realizar pedidos, por lo que esta solicitud de pedido está bloqueada y no se puede realizar el pedido.

Solución: Utilice el diagnóstico de códigos de error para ver el resultado del diagnóstico de este código de error, y póngase en contacto con el soporte técnico para confirmar por qué se añadió la etiqueta y solicitar su eliminación. Realice el pedido nuevamente después de que se elimine la etiqueta.

400-DataInspectionFailed/data_inspection_failed

Los datos de entrada o salida pueden contener contenido inapropiado. / Los datos de entrada pueden contener contenido inapropiado. / Los datos de salida pueden contener contenido inapropiado.

Causa: La entrada o salida contiene contenido sensible sospechoso bloqueado por Green Net.

Solución: Modifique el contenido de entrada e inténtelo de nuevo.

Los datos de entrada xxx pueden contener contenido inapropiado.

Causa: Los datos de entrada (como prompts o imágenes) pueden contener contenido sensible. Solución: Realice comprobaciones de cumplimiento de contenido y modifique la entrada antes de reintentar.

Qwen rechazó la imagen de entrada antes de la inferencia del modelo; no se produjo ningún resultado real de anuncio/pornografía/OCR.

Causa: Antes de que la imagen de entrada entrara en la inferencia del modelo, fue marcada por la verificación previa de seguridad de contenido (Green Net) por sospecha de contener contenido sensible o no conforme y, por lo tanto, fue bloqueada. El modelo no ejecutó la inferencia sobre la imagen, por lo que no se devuelve ningún resultado de reconocimiento, OCR o análisis. Esta es una verificación de cumplimiento de contenido previa a la inferencia para imágenes de entrada multimodales y pertenece al mismo mecanismo de seguridad de contenido que el bloqueo de Green Net descrito anteriormente.

Solución: Reemplace o modifique la imagen de entrada e inténtelo de nuevo. Si se confirma que la imagen cumple con las normas pero sigue siendo bloqueada de manera consistente, envíe un ticket para una verificación adicional.

APIConnectionError (error de red del lado del cliente, no se devolvió ningún estado HTTP)

Error de conexión.

Causa: Problema de red local, generalmente debido a que un proxy está habilitado.

Solución: Desactive o reinicie el proxy.

400-InvalidFile.DownloadFailed

No se puede descargar el archivo de audio.

Causa: Al utilizar reconocimiento de voz (Paraformer) para el reconocimiento de archivos grabados, no se pudo descargar el archivo a reconocer.

Solución: Compruebe que la URL del archivo de audio sea accesible a través de la red pública.

400-InvalidFile.AudioLengthError

La duración del audio debe estar entre 1s y 300s.

Causa: La duración del audio no cumple con los requisitos.

Solución: Asegúrese de que la duración del audio esté dentro de [1, 300] segundos.

La duración del audio debe estar entre 1s y 180s.

Causa: La duración del audio no cumple con los requisitos.

Solución: Asegúrese de que la duración del audio esté dentro de [1, 180] segundos.

400-InvalidFile.NoHuman

La imagen de entrada no contiene ninguna persona. Por favor, cargue otra imagen con una sola persona.

Causa: La imagen de entrada no contiene ninguna persona o no se detectó ningún rostro.

Solución: Cargue una foto de una sola persona.

400-InvalidFile.BodyProportion

La proporción de la persona detectada en la imagen es demasiado grande o demasiado pequeña; por favor, cargue otra imagen.

Causa: La proporción de la persona en la imagen cargada no cumple con los requisitos.

Solución: Suba una imagen que cumpla con los requisitos de proporción de la persona.

400-InvalidFile.FacePose

La postura del rostro detectado no es válida; por favor, cargue otra imagen con el rostro completo y la orientación esperada.

Causa: La postura facial en la imagen cargada no cumple con los requisitos (el rostro debe ser visible con una inclinación mínima de la cabeza).

Solución: Suba una imagen que cumpla con los requisitos.

La postura del rostro detectado no es válida; por favor, cargue otra imagen con la orientación esperada.

Razón: La orientación facial en la imagen cargada no cumple con los requisitos (el rostro no debe tener un desplazamiento significativo).

Solución: Asegúrese de que el rostro en la imagen no tenga inclinación.

La postura del rostro detectado no es válida; por favor, cargue otra imagen con la orientación esperada.

Razón: La postura facial en la imagen cargada no cumple con los requisitos (el rostro no debe tener un desplazamiento significativo).

Solución: Asegúrese de que el rostro en la imagen no tenga inclinación.

400-InvalidFile.Resolution

La resolución de la imagen no es válida; asegúrese de que la longitud mayor de la imagen sea menor que 7000 y que la longitud menor sea mayor que 400.

Causa: El tamaño de la imagen cargada no cumple con los requisitos.

Solución: La resolución de la imagen no debe exceder 7000×7000 y debe ser de al menos 400×400.

La resolución de la imagen no es válida; asegúrese de que la longitud mayor de la imagen sea menor que 4096 y que la longitud menor sea mayor que 224.

Causa: El tamaño de la imagen cargada no cumple con los requisitos.

Solución: La resolución de la imagen debe tener un lado más largo menor a 4096 píxeles y un lado más corto mayor a 224 píxeles.

La resolución de la imagen no es válida; asegúrese de que la longitud mayor de la imagen sea menor que xxx y que la longitud menor sea mayor que yyy.

Causa: El tamaño de la imagen cargada no cumple con los requisitos.

Solución: La resolución de la imagen no debe exceder xxx×xxx y debe ser de al menos yyy×yyy.

La resolución de la imagen no es válida; asegúrese de que la relación de aspecto sea menor que xxx y que la longitud mayor de la imagen sea menor que yyy.

Causa: El tamaño de la imagen cargada no cumple con los requisitos.

Solución: La relación de aspecto de la imagen debe ser menor que xxx, y la resolución no debe exceder yyy×yyy.

Resolución de video no válida. La altura o anchura del video debe ser xxx ~ yyy.

Causa: La resolución del video no cumple con los requisitos.

Solución: La longitud del lado del video debe estar entre xxx e yyy.

400-InvalidFile.FPS

FPS de video no válido. Los FPS del video deben ser 15 ~ 60.

Causa: La tasa de cuadros del video no cumple con los requisitos.

Solución: La tasa de fotogramas del video debe estar entre 15 y 60 fps.

400-InvalidFile.Value

El valor de la imagen no es válido; cargue otra imagen más clara.

Causa: La imagen cargada es demasiado oscura.

Solución: Asegúrese de que el rostro en la imagen sea nítido.

400-InvalidFile.FrontBody

La pose de la persona detectada no es válida; por favor, cargue otra imagen con vista frontal.

Causa: La imagen subida muestra a la persona de espaldas.

Solución: Asegúrese de que la persona mire directamente a la cámara.

400-InvalidFile.FullFace

La pose del rostro detectado no es válida; por favor, cargue otra imagen con el rostro completo.

Causa: La pose facial en la imagen cargada no cumple con los requisitos (el rostro debe ser visible).

Solución: Asegúrese de que el rostro en la imagen esté completo y sin obstrucciones.

400-InvalidFile.FaceNotMatch

No hay ningún rostro en el video que coincida con la imagen de referencia proporcionada.

Causa: Falló la coincidencia facial entre la imagen de referencia y el video.

Solución: Consulte Generación de video VideoRetalk para obtener más detalles.

400-InvalidFile.Content

El primer fotograma del video de entrada no contiene ninguna persona. Por favor, seleccione otro clip.

Causa: El primer fotograma del video debe contener una persona.

Solución: Elija un clip de video que incluya a una persona.

La persona es demasiado pequeña en el primer fotograma del video de entrada. Por favor, seleccione otro clip.

Causa: La persona en el primer fotograma del video es demasiado pequeña.

Solución: Elija un video donde la persona ocupe una mayor proporción en el primer fotograma.

La persona no se ve clara en el primer fotograma del video de entrada. Por favor, seleccione otro clip.

Causa: La persona en el primer fotograma del video no es clara.

Solución: Elija un video donde la persona se vea con claridad en el primer fotograma.

La imagen de entrada no tiene cuerpo humano o tiene múltiples cuerpos humanos. Por favor, cargue otra imagen con una sola persona.

Causa: La imagen de entrada no contiene ninguna persona o contiene varias personas.

Solución: Cargue una foto de una sola persona.

La imagen de entrada no tiene cuerpo humano o este no es claro. Por favor, cargue otra imagen.

Causa: La imagen de entrada contiene un cuerpo humano incompleto o ausente.

Solución: Suba una imagen que contenga un cuerpo humano completo y claro.

La imagen de entrada contiene múltiples personas. Por favor, cargue otra imagen con una sola persona.

Causa: La imagen de entrada contiene varias personas.

Solución: Cargue una foto de una sola persona.

400-InvalidFile.FullBody

La persona no aparece de cuerpo completo en el primer fotograma del video de entrada. Por favor, seleccione otro clip.

Causa: La persona en el primer fotograma del video no es de cuerpo entero.

Solución: El cuerpo completo debe ser visible.

La postura de la persona detectada no es válida; por favor, cargue otra imagen de cuerpo completo o cambie el parámetro de relación a 1:1.

Causa: La postura de la persona en la imagen subida no cumple con los requisitos.

Solución: Cargue una imagen que cumpla con los requisitos: para fotos de rostro, la cabeza debe ser completamente visible; para fotos de medio cuerpo, el área por encima de las caderas debe ser completamente visible; o ajuste la relación de aspecto de la imagen a 1:1.

400-InvalidFile.BodyPose

La postura de la persona detectada no es válida; por favor, cargue otra imagen con el cuerpo completo y la orientación esperada.

Causa: La postura de la persona individual no cumple con los requisitos.

Solución: Cargue una imagen que cumpla con los requisitos: los hombros y los tobillos deben ser visibles, no debe ser desde atrás, la persona no debe estar sentada y la inclinación del cuerpo debe ser mínima.

400-InvalidFile.Size

Tamaño de archivo no válido. El tamaño del archivo de video debe ser menor a 200MB y el tamaño del archivo de audio debe ser menor a 15MB.

Causa: El tamaño del archivo no cumple con los requisitos.

Solución: Los archivos de video deben ser menores que 200 MB; los archivos de audio deben ser menores que 15 MB.

Tamaño de archivo no válido. El tamaño del archivo de imagen debe ser menor que 5MB.

Causa: El tamaño del archivo no cumple con los requisitos.

Solución: Los archivos de imagen deben ser menores a 5 MB.

Tamaño de archivo no válido. El tamaño del archivo de video/audio/imagen debe ser menor que xxx MB.

Causa: El tamaño del archivo no cumple con los requisitos.

Solución: Los archivos de video/audio/imagen deben ser menores que el límite especificado en MB.

400-InvalidFile.Duration

Duración de archivo no válida. La duración del archivo debe ser de xxx s ~ yyy s.

Causa: La duración del archivo no cumple con los requisitos.

Solución: La duración del archivo de video/audio debe estar entre xxx e yyy segundos.

400-InvalidFile.ImageSize

El tamaño de la imagen supera el límite.

Causa: El tamaño de la imagen excede el límite.

Solución: La relación de aspecto de la imagen no debe exceder 2, y el lado más largo no debe exceder 4096.

400-InvalidFile.AspectRatio

Relación de archivo no válida. La relación de aspecto del archivo (alto/ancho) debe estar entre 3:1 y 1:3.

Causa: La relación de aspecto del archivo no cumple con los requisitos.

Solución: La relación de aspecto del archivo de video debe estar entre 3:1 y 1:3.

Relación de archivo no válida. La relación de aspecto del archivo (alto/ancho) debe estar entre 2.0 y 0.5.

Causa: La relación de aspecto del archivo no cumple con los requisitos.

Solución: La relación de aspecto del archivo de imagen debe estar entre 2.0 y 0.5.

400-InvalidFile.Openerror

Archivo no válido, no se puede abrir el archivo como video/audio/imagen.

Causa: No se puede abrir el archivo.

Solución: Compruebe si el archivo está dañado o si el formato es correcto.

400-InvalidFile.Template.Content

Contenido de plantilla no válido.

Causa: La plantilla de acción carece de permisos o el contenido no cumple con los requisitos.

Solución: Verifique los permisos y el contenido de la plantilla.

400-InvalidFile.Format

Formato de archivo no válido, el formato del archivo de la solicitud debe ser uno de los siguientes tipos: MP4, AVI, MOV, MP3, WAV, AAC, JPEG, JPG, PNG, BMP y WEBP.

Causa: El formato del archivo no cumple con los requisitos.

Solución: Utilice formatos compatibles: video—mp4, avi, mov; audio—mp3, wav, aac; imagen—jpg, jpeg, png, bmp, webp.

400-InvalidFile.MultiHuman

La imagen de entrada contiene múltiples personas. Por favor, cargue otra imagen con una sola persona.

Causa: La imagen de entrada contiene varias personas.

Solución: Cargue una foto de una sola persona.

400-InvalidPerson

La imagen de entrada no tiene cuerpo humano o tiene múltiples cuerpos humanos. Por favor, cargue otra imagen con una sola persona.

Causa: La imagen de entrada no contiene ninguna persona o contiene varias personas.

Solución: Cargue una foto de una sola persona.

400-InvalidParameter.DataInspection

No se pudo descargar el recurso multimedia durante el proceso de inspección de datos.

Causa: Se agotó el tiempo de descarga de archivos de imagen o audio.

Solución: Si realiza llamadas desde fuera de China, la inestabilidad de la red transfronteriza puede causar tiempos de espera en la descarga. Almacene los archivos en OSS nacional antes de llamar al modelo. Alternativamente, utilice el espacio de almacenamiento temporal para subir archivos.

400-FlowNotPublished

El flujo aún no se ha publicado; publíquelo e inténtelo de nuevo.

Causa: El flujo no está publicado.

Solución: Publique el flujo e inténtelo de nuevo.

400-InvalidImage.ImageSize

El tamaño de la imagen supera el límite.

Causa: El tamaño de la imagen excede el límite.

Solución: La relación de aspecto de la imagen no debe exceder 2, y el lado más largo no debe exceder 4096.

400-InvalidImage.NoHumanFace

No se detectó rostro humano.

Causa: No se detectó ningún rostro (solo para interfaces de consulta asíncrona de tareas de generación).

Solución: Cargue una imagen que contenga un rostro humano claro.

400-InvalidImageResolution

La resolución de la imagen de entrada es demasiado grande o pequeña.

Causa: La resolución de la imagen de entrada es demasiado grande o demasiado pequeña.

Solución: La resolución de la imagen debe ser de al menos 256×256 píxeles y no superior a 5760×3240 píxeles.

400-InvalidImageFormat

La imagen de entrada tiene un formato no válido.

Causa: El formato de imagen no cumple con los requisitos.

Solución: Utilice imágenes en formato JPEG, PNG, JPG, BMP o WEBP.

400-InvalidURL

URL no válida proporcionada en su solicitud.

Causa: La URL no es válida.

Solución: Utilice una URL válida.

Falta la URL requerida o no es válida; verifique la URL de la solicitud.

Causa: La URL de entrada no es válida o falta.

Solución: Proporcione una URL correcta.

La URL de la solicitud no es válida; asegúrese de que la url sea correcta y corresponda a una imagen.

Causa: La URL de entrada no es válida.

Solución: Asegúrese de que la URL sea correcta y apunte a un archivo de imagen.

El audio de entrada dura más de xxs.

Causa: El archivo de audio de entrada excede la duración máxima de xx segundos.

Solución: Recorte el archivo de audio a menos de xx segundos.

El tamaño del archivo es mayor que 15MB.

Causa: El archivo de audio de entrada supera el límite de 15 MB.

Solución: Comprima el archivo de audio a menos de 15 MB.

El tipo de archivo no es compatible. Los tipos permitidos son: .wav, .mp3.

Causa: El formato de audio de entrada no cumple con los requisitos.

Solución: Solo se admiten los formatos wav y mp3.

La URL de la solicitud no es válida; verifique que la URL de la solicitud esté disponible y que el formato de la imagen solicitada sea uno de los siguientes tipos: JPEG, JPG, PNG, BMP y WEBP.

Causa: La imagen es inaccesible o el formato del archivo descargado no es compatible.

Solución: Asegúrese de que la URL sea accesible y que el formato de la imagen sea JPEG, JPG, PNG, BMP o WEBP.

400-InvalidImage.FileFormat

Tipo de imagen no válido. Asegúrese de que el archivo cargado sea una imagen válida.

Causa: El formato del archivo de imagen no es compatible.

Solución: Utilice imágenes en formato JPG, JPEG, PNG, BMP o WEBP.

400-InvalidURL.ConnectionRefused

Conexión a xxx rechazada; proporcione una URL disponible.

Causa: Se rechazó la descarga.

Solución: Proporcione una URL accesible.

400-InvalidURL.Timeout

Tiempo de espera agotado al descargar xxx; compruebe la conexión de red.

Causa: Tiempo de espera de descarga agotado.

Solución: Verifique la conectividad de red.

400-BadRequestException

Tipo de parte no válido.

Causa: Aplica solo a escenarios de conversación del modelo Qwen-Long donde el usuario cargó un tipo de archivo aún no soportado por Qwen-Long.

Solución: Suba un tipo de archivo compatible con Qwen-Long.

400-BadRequest.EmptyInput

Falta un parámetro de entrada requerido en la solicitud.

Causa: La solicitud no incluyó el parámetro input.

Solución: Agregue el parámetro input a la solicitud.

400-BadRequest.EmptyParameters

Falta el parámetro requerido "parameters" en la solicitud.

Causa: La solicitud no incluyó el parámetro parameters.

Solución: Agregue el parámetro parameters a la solicitud.

400-BadRequest.EmptyModel

Falta el parámetro requerido "model" en la solicitud.

Causa: La solicitud no proporcionó el parámetro model.

Solución: Agregue el parámetro model a la solicitud.

400-BadRequest.IllegalInput

El parámetro de entrada requiere formato json.

Causa: El formato del parámetro de entrada no cumple con los requisitos JSON de la API.

Solución: Verifique el formato del parámetro de entrada y asegúrese de que sea un JSON válido.

400-BadRequest.InputDownloadFailed

Error al descargar el archivo de entrada: xxx.

Causa: Falló la descarga del archivo de entrada, posiblemente debido a tiempo de espera agotado, fallo en la descarga o tamaño de archivo que excede los límites.

Solución: Solucione el problema basándose en el mensaje de error detallado xxx.

Error al descargar el archivo de entrada.

Causa: Al utilizar la clonación de voz de Qwen-TTS, el servidor no pudo descargar el archivo de audio para la clonación.

Solución: Verifique si el archivo de audio se puede descargar normalmente. Si es así, verifique que el tamaño del archivo no exceda el límite (10 MB).

400-BadRequest.UnsupportedFileFormat

Formato de archivo no compatible.

Causa: Al utilizar la clonación de voz de CosyVoice, el formato de audio cargado no cumple con los requisitos del modelo.

Solución: El formato de audio debe ser WAV (16bit), MP3 o M4A. Tenga en cuenta que la extensión del archivo por sí sola no es fiable; por ejemplo, un archivo con extensión .mp3 podría ser realmente Opus. Utilice herramientas (como ffprobe, mediainfo) o comandos (como el comando file de Linux/macOS) para verificar el formato de codificación de audio real.

El formato del archivo de entrada no es compatible.

Causa: El formato del archivo de entrada no es compatible.

Solución: Utilice un formato de archivo compatible.

400-BadRequest.TooLarge

Carga útil demasiado grande.

Causa: El tamaño del archivo excede el límite.

Solución:

• Cuando "purpose" es "file-extract", los documentos no deben exceder 150 MB y las imágenes no deben exceder 20 MB.
• Cuando "purpose" es "batch", los archivos no deben exceder 500 MB. Divida y cargue archivos en lotes.

400-BadRequest.ResourceNotExist

El recurso requerido no existe.

Causa:

• Al llamar a las interfaces de actualización, consulta o eliminación para la clonación de voz de CosyVoice, el timbre correspondiente no existe.

400-Throttling.AllocationQuota

Su cuota actual es xxx

Causa: El número de timbres de clonación de voz de CosyVoice ha alcanzado el límite.

Solución: Elimine algunos timbres.

Se superó el límite máximo de almacenamiento de voces; elimine las voces existentes.

Causa: Al utilizar la clonación de voz de Qwen-TTS, superó el límite de timbres de la cuenta principal.

Solución: Elimine algunos timbres.

400-InvalidGarment

Falta la imagen de ropa. Por favor, introduzca al menos una imagen de prenda superior o inferior.

Causa: Falta la imagen de la prenda.

Solución: Proporcione al menos una imagen de prenda superior (top_garment_url) o de prenda inferior (bottom_garment_url).

400-InvalidSchema

El esquema de base de datos no es válido para text2sql.

Causa: No se proporcionó la información del esquema de base de datos.

Solución: Ingrese la información del esquema de la base de datos.

400-InvalidSchemaFormat

El formato del esquema de base de datos no es válido para text2sql.

Causa: El formato de la información de tabla de entrada no es válido.

Solución: Verifique y corrija el formato de la información de la tabla.

400-Audio.AudioShortError

¡audio válido demasiado corto!

Causa: La duración del audio para la clonación de voz CosyVoice es demasiado corta.

Solución: Mantenga la duración del audio alrededor de 10–15 segundos. Asegure habla continua con al menos un segmento de más de 5 segundos.

400-Audio.AudioSilentError

error de audio silencioso.

Causa: El archivo de audio de clonación de voz de CosyVoice es silencioso o los segmentos no silenciosos son demasiado cortos.

Solución: Mantenga la duración del audio alrededor de 10–15 segundos e incluya al menos un segmento de habla continua de más de 5 segundos.

400-InvalidInputLength

La resolución de la imagen no es válida; asegúrese de que la longitud mayor de la imagen sea menor que 4096 y que la longitud menor sea mayor que 150, y que el tamaño de la imagen oscile entre 5KB y 5MB.

Causa: Las dimensiones de la imagen o el tamaño del archivo no cumplen con los requisitos.

Solución: Consulte Requisitos de imagen de entrada.

400-FaqRuleBlocked

Los datos de entrada o salida están bloqueados por una regla de faq.

Causa: Se activó el módulo de intervención de reglas de preguntas frecuentes.

400-ClientDisconnect

¡El cliente se desconectó antes de que finalizara la tarea!

Causa: El cliente se desconectó antes de completar la tarea. Este error ocurre al utilizar servicios de síntesis o reconocimiento de voz.

Solución: Revise su código para evitar desconectarse del servidor antes de completar la tarea.

400-ServiceUnavailableError

Role debe ser user o assistant y la longitud de Content debe ser mayor que 0.

Causa: La longitud del contenido de entrada es 0 o role es incorrecto.

Solución: Asegúrese de que la longitud del contenido de entrada sea mayor que 0 y que el formato del parámetro (como role) cumpla con la documentación de la API.

400-IPInfringementSuspect

Se sospecha que los datos de entrada están involucrados en infracción de propiedad intelectual.

Causa: Los datos de entrada (como prompts o imágenes) son sospechosos de infringir derechos de propiedad intelectual.

Solución: Realice verificaciones de cumplimiento de contenido y asegúrese de que la entrada no contenga material infractor.

400-UnsupportedOperation

La operación no es compatible con el objeto de referencia.

Causa: El objeto asociado no admite esta operación.

Solución: Verifique que el objeto de operación y el tipo de operación coincidan.

No se puede eliminar el trabajo de ajuste fino porque su estado es completado, fallido o cancelado.

Causa: No se puede eliminar el trabajo de ajuste fino porque su estado ya es "succeeded", "failed" o "canceled".

Solución: Solo se pueden eliminar trabajos en estados específicos; no elimine trabajos en estados terminales.

400-CustomRoleBlocked

Los datos de entrada o salida pueden contener contenido inapropiado según una regla personalizada.

Causa: El contenido de la solicitud o respuesta falló las verificaciones de políticas personalizadas.

Solución: Revise el contenido o ajuste las políticas personalizadas.

400-Audio.PreprocessError

Error de preprocesamiento de audio.

Causa: Al utilizar la clonación de voz de Qwen-TTS, falló el preprocesamiento del audio a clonar, posiblemente porque: el contenido del parámetro text difiere significativamente de la transcripción del audio, el habla válida es demasiado corta o no hay sonido.

Solución: Ajuste el contenido del parámetro text. Si no es efectivo, vuelva a grabar el audio siguiendo las guías de grabación.

Ningún segmento cumple con el requisito de duración mínima

Causa: Al utilizar la clonación de voz de Qwen-TTS, el habla válida en el audio a clonar es demasiado corta.

Solución: Vuelva a grabar el audio siguiendo las directrices de grabación.

400-BadRequest.VoiceNotFound

Voz '%s' no encontrada.

Causa: Al utilizar la clonación de voz de Qwen-TTS, el timbre especificado en la llamada a la interfaz de eliminación ya ha sido eliminado o no existe.

Solución: Verifique que el parámetro voice sea correcto.

400-Audio.DecoderError

Error al decodificar el archivo de audio.

Causa: Al utilizar la clonación de voz de Qwen-TTS, falló la decodificación del audio a clonar. / Falló la decodificación del archivo de audio de clonación de voz de CosyVoice.

Solución: Verifique si el archivo de audio está dañado y asegúrese de que cumpla con los requisitos de formato (WAV (16bit), MP3 o M4A para CosyVoice).

400-Audio.AudioRateError

Tasa de muestreo del archivo no compatible.

Causa: Al utilizar la clonación de voz de Qwen-TTS o CosyVoice, la tasa de muestreo del audio a clonar no cumple con los requisitos.

Solución: La tasa de muestreo debe ser de al menos 24,000 Hz.

400-Audio.DurationLimitError

La duración del audio excede el límite máximo permitido.

Causa: Al usar la clonación de voz de Qwen-TTS, el audio a clonar es demasiado largo.

Solución: El audio no debe exceder los 60 segundos.

401-InvalidApiKey/invalid_api_key

Se proporcionó una clave de API no válida. / Se proporcionó una clave de API incorrecta.

Causa: La clave API es incorrecta.

Solución: Causas comunes y soluciones:

• Lectura incorrecta de variable de entorno

  • Incorrecto: api_key=os.getenv("sk-xxx")—el sistema intenta leer una variable de entorno llamada sk-xxx, no usa sk-xxx como clave.

  • Correcto:

    • Si la variable de entorno está configurada: Utilice api_key=os.getenv("DASHSCOPE_API_KEY");

      Asegúrese de que la variable de entorno DASHSCOPE_API_KEY esté configurada antes de ejecutar.

    • Si la variable de entorno no está configurada: Use api_key = "sk-xxx".

      Este método es solo para depuración; no lo utilice en producción.

• Error tipográfico: Las claves de API de Alibaba Cloud Model Studio comienzan con sk-. Confirme que no haya utilizado por error una clave de otro proveedor y que al copiar no se hayan incluido espacios adicionales ni saltos de línea.

• API Key exclusiva del plan (Coding Plan / Token Plan Team Edition): Tanto Coding Plan como Token Plan Team Edition proporcionan una API Key exclusiva que comienza con sk-sp- y que debe usarse con su propia URL base exclusiva, y no debe mezclarse con la API Key/URL base general (mezclarlas devuelve este error de autenticación). Para Coding Plan, el endpoint exclusivo es https://coding-intl.dashscope.aliyuncs.com/v1; para Token Plan Team Edition, la URL base exclusiva se muestra en el área de API Key de Mis suscripciones en la consola. Confirm haber actualizado tanto la API Key como la URL base. Consulte Integración de herramientas de IA e Inicio rápido de Token Plan Team Edition para obtener detalles de configuración.

• Incompatibilidad de región: La API Key y la URL base pertenecen a regiones diferentes; por ejemplo, usar una API Key de China (Beijing) con una URL base de Singapore. Confirm que su API Key proviene de la página de región de Singapore, de la página de región de Beijing o de la página de región de US. URLs base por región:

  Región	Compatible con OpenAI	DashScope
  Singapur	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
  EE. UU. (Virginia)	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1

  ImportanteAlibaba Cloud Model Studio ha lanzado dominios específicos de espacio de trabajo para las regiones de China (Beijing) y Singapur. Los nuevos dominios dedicados ofrecen un rendimiento superior y una mayor estabilidad para las solicitudes de inferencia. Recomendamos migrar a los nuevos dominios:

  • China (Pekín): de https://dashscope.aliyuncs.com a https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • Singapur: de https://dashscope-intl.aliyuncs.com a https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

  {WorkspaceId} es su ID de espacio de trabajo, que se encuentra en la página Workspace Details de la consola de Alibaba Cloud Model Studio. El dominio existente permanece totalmente funcional.

• Problema de compatibilidad de herramientas: Las herramientas de terceros no están adaptadas correctamente (por ejemplo, la inestabilidad del último plugin de Dify causa errores; intente instalar una versión anterior del plugin Qwen; para versiones anteriores de Cline, seleccione OpenAI-Compatible en lugar de Alibaba Qwen como el API Provider).

Si none aplica, es posible que su API Key haya sido eliminada; obténgala nuevamente e inténtelo de nuevo.

401-NO AUTORIZADO

Acceso denegado: O bien no está autorizado para acceder a este espacio de trabajo, o bien el espacio de trabajo no existe. Por favor: Verifique la configuración del espacio de trabajo. Compruebe la configuración de su endpoint de API. Asegúrese de estar apuntando al entorno correcto.

Causa:

• WorkspaceId no es válido o la cuenta actual no es miembro del espacio de trabajo.
• O el endpoint de la solicitud (endpoint del servicio) es incorrecto.

Solución:

• Confirme que WorkspaceId es correcto y que la cuenta es miembro del espacio de trabajo antes de llamar a la API.
• Usuarios del sitio de China: utilicen el endpoint de la región de China (Beijing); usuarios del sitio internacional: utilicen el endpoint de la región de Singapur. Al utilizar la depuración en línea, confirme que el endpoint del servicio sea correcto.

401-token de acceso no válido o token caducado

token de acceso no válido o token caducado.

Posible causa: Token Plan utilizó erróneamente Coding Plan o la URL base de otro plan.

Solución: Utilice la URL base exclusiva del Token Plan:

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

403-AccessDenied/access_denied

La api del usuario actual no admite llamadas asíncronas.

Causa: La API no admite llamadas asíncronas.

Solución: Elimine el encabezado X-DashScope-Async o establezca su valor en disable.

la api del usuario actual no admite llamadas síncronas.

Causa: La API no admite llamadas síncronas.

Solución: Establezca X-DashScope-Async: enable en el encabezado de la solicitud.

Inválido según Policy: Policy caducada.

Causa: La credencial de carga de archivos caducó al obtener una URL pública temporal.

Solución: Vuelva a llamar a la API de credenciales de carga de archivos para generar una nueva credencial.

Acceso denegado.

Causa: No tiene permiso para acceder a este modelo. Es posible que el modelo requiera aprobación, que su cuota gratuita se haya agotado y no admita el modelo de pago por uso (por ejemplo, deepseek-r1-distill-llama-70b), o que el modelo haya sido descontinuado.

Solución: Si el modelo ha sido descontinuado, confirme su estado en la Política de descontinuación de modelos y cambie a uno de los modelos alternativos recomendados en ese tema.

Llamada a un modelo exclusivo de Token Plan con una API Key general

Causa: Los modelos exclusivos de Token Plan (como qwen3.8-max-preview) solo pueden ser llamados por suscriptores de Token Plan utilizando la API Key exclusiva del plan (que comienza con sk-sp-) junto con la URL base exclusiva de Token Plan. Llamar a estos modelos con una API Key general (que comienza con sk-) devuelve un error 403 access_denied.

Solución: En la consola de Alibaba Cloud Model Studio, vaya a Mis suscripciones y obtenga la API Key exclusiva del Token Plan y la URL base exclusiva desde el área de API Key. Asegúrese de actualizar ambas. Para detalles de configuración, consulte Inicio rápido de Token Plan Team Edition. Si la API Key y la URL base no coinciden (por ejemplo, una API Key exclusiva con la URL base general), se devuelve un error de autenticación 401; consulte 401-InvalidApiKey/invalid_api_key en este documento.

403-AccessDenied.Unpurchased

Acceso al modelo denegado. Por favor, asegúrese de ser elegible para utilizar el modelo.

Causa: El servicio Alibaba Cloud Model Studio no está activado.

Solución: Siga los pasos a continuación para activar el servicio Alibaba Cloud Model Studio.

1. Crear una cuenta: Si no tiene una cuenta de Alibaba Cloud, regístrese primero.

2. Seleccione una región: Alibaba Cloud Model Studio admite múltiples regiones con diferentes endpoints, modelos y precios. Vaya a la consola de Model Studio para elegir una región adecuada.

3. Completar el registro: Utilice su cuenta de Alibaba Cloud para ir a Completar el registro y proporcione la información requerida. Para más detalles, consulte Registrar una cuenta de Alibaba Cloud.

   • Para utilizar los servicios de modelos en la región de China (Beijing) (China continental), utilice su cuenta de Alibaba Cloud para completar la verificación de identidad, elija individual users o upgrade to enterprise según su situación y haga clic en Verify Now, luego solicite Purchase cloud resources in the Chinese mainland or use acceleration regions that include it. Para más información, consulte Resumen de verificación de identidad.

     Adquiera servicios en la nube específicos implementados en China continental o habilite regiones de aceleración que incluyan China continental (sujeto a disponibilidad del producto), tras completar la verificación de identidad y enviar una solicitud de compra.

4. Active Alibaba Cloud Model Studio: Utilice su cuenta de Alibaba Cloud para ir a Alibaba Cloud Model Studio, lea y acepte los términos, y el servicio se activará automáticamente. Si el acuerdo de servicio no aparece, significa que ya está activado.

403-Model.AccessDenied

Acceso al modelo denegado.

Causa: Sin permiso para llamar al modelo estándar especificado.

Solución:

• Llamada a modelos estándar: Al utilizar una clave de API de subespacio de trabajo para llamar a modelos estándar (por ejemplo, qwen-plus), el subespacio de trabajo debe tener permisos de llamada. Consulte Autorización de llamada de modelos.
• Llamada a modelos personalizados: Tras un despliegue exitoso, los modelos personalizados solo se pueden llamar con la clave API de su espacio de trabajo y no requieren autorización de llamada al modelo.

403-App.AccessDenied

Acceso a la aplicación denegado.

Causa: Sin permiso para acceder a la aplicación o al modelo.

Solución:

• Confirme que se han otorgado permisos de acceso al espacio de trabajo y al usuario RAM.
• Verifique que la aplicación esté publicada.
• Verifique nuevamente el ID de la aplicación y la clave API.
• Si se trata de un error de Claude Code, utilice la API Key predeterminada del espacio de trabajo.
• Si todo lo anterior es correcto, actualice los datos, vuelva a publicar e inténtelo de nuevo, o vuelva a crear el agente.

403-Workspace.AccessDenied

Acceso al espacio de trabajo denegado.

Causa: No tiene permiso para acceder a las aplicaciones o modelos del espacio de trabajo.

Solución:

• Si llama a un modelo de subespacio de trabajo, consulte Llamada a modelos en subespacios de trabajo.
• Alternativamente, utilice la clave de API de la cuenta principal, que tiene permisos para todos los espacios de trabajo.

403-Endpoint.AccessDenied

Acceso denegado al endpoint del espacio de trabajo.

Causa: Es posible que esté llamando a un modelo en desuso (por ejemplo, versiones de instantáneas históricas como qwen-max-2025-01-25). Tras la descontinuación, el endpoint deja de estar disponible, lo que provoca este error.

Solución:

• Vaya a Mecanismo de desuso de modelos para confirmar si el modelo está en desuso.
• Si está obsoleto, cambie a su modelo de reemplazo recomendado.

403-AllocationQuota.FreeTierOnly

El nivel gratuito del modelo se ha agotado. Si want continuar accediendo al modelo bajo un esquema de pago, desactive el modo "usar solo nivel gratuito" en la consola de administración.

Causa 1: Los nuevos usuarios agotan la cuota gratuita y realizan solicitudes.

Solución: Complete el registro antes de realizar la llamada.

Causa 2: Usted activó detención por agotamiento de cuota gratuita y realizó solicitudes después de que se agotara la cuota gratuita.

La cuota gratuita de la consola se actualiza cada minuto (actualizar manualmente).

Solución:

• Para continuar realizando llamadas de pago, puede desactivar el interruptor de detención por agotamiento de cuota gratuita en cualquier momento sin esperar a que se agote la cuota gratuita. Las llamadas de pago por uso se reanudan una vez desactivado.
• Si el interruptor ya está desactivado pero las llamadas siguen fallando, compruebe si la clave de API ha cambiado o ha dejado de ser válida. Intente restablecer la clave de API o crear una nueva para probar la llamada.
• Si no hay registro de llamadas para la solicitud en la consola, es posible que la solicitud no haya llegado al servidor. Verifique la configuración del complemento de su cliente o su conexión de red.
• Si utiliza Coding Plan, generalmente se trata de un error de configuración. Coding Plan requiere una URL base dedicada y una API Key. Consulte Inicio rápido de Coding Plan para obtener más detalles.

404-ModelNotFound/model_not_found

El modelo xxx proporcionado no es compatible con la API por lotes.

Causa: El modelo no admite llamadas por lotes o el nombre del modelo está mal escrito.

Solución: Consulte Compatible con OpenAI - Lote (entrada de archivo) para confirmar los modelos admitidos y los nombres correctos.

No se puede encontrar el modelo. / El modelo xxx no existe. / El modelo xxx no existe o usted no tiene acceso a él.

Causa: El modelo no existe o usted no ha activado Alibaba Cloud Model Studio.

Solución:

• Compare con los nombres de modelos en la Lista de modelos para verificar su entrada (valor del parámetro model).
• Vaya al Marketplace de Modelos para activar los servicios de modelos.
• Si está llamando a modelos a través de un endpoint de API internacional (por ejemplo, {WorkspaceId}.us-east-1.maas.aliyuncs.com), tenga en cuenta que los modelos disponibles varían según la región. Antes de realizar llamadas desde la región de EE. UU., verifique que el modelo de destino esté disponible en dicha región.

Endpoint de despliegue dedicado: Si obtiene ModelNotFound al llamar a un modelo a través de un endpoint de despliegue dedicado, verifique también lo siguiente:

• Usar el nombre de la implementación: Para un endpoint de implementación dedicada, el parámetro model debe establecerse con el nombre de la implementación (código del modelo, visible en la página de Dedicated Deployment en la consola de Model Studio, en un formato similar a qwen3.5-flash-2026-02-23-xxx), no con el nombre del modelo. Llamar a un endpoint de implementación dedicada con un nombre de modelo, o llamar al endpoint estándar de la API con un nombre de implementación, devuelve model_not_found.
• Distinga entre métodos de llamada: Las llamadas estándar utilizan el endpoint de API estándar y el nombre del modelo, mientras que las llamadas de implementación dedicada utilizan la URL del endpoint de implementación dedicada y el nombre de la implementación. Las claves de API para ambos pueden diferir, así que no las mezcle. Mezclarlas provoca un invalid_api_key error de autenticación.

404-model_not_supported

Modelo xxx no compatible para el modo de compatibilidad con OpenAI.

Causa: El modelo no admite acceso compatible con OpenAI.

Solución: Utilice el método nativo de DashScope para realizar la llamada.

404-WorkSpaceNotFound

No se puede encontrar el espacio de trabajo.

Causa: El espacio de trabajo no existe.

404-NotFound

¡No encontrado!

Causa:

• El recurso a consultar/operar no existe.

Solución:

• Verifique si el ID del recurso a consultar u operar es incorrecto.

Ruta de solicitud no encontrada.

Causa: Al usar el modelo Fun-Music, el endpoint del servicio no existe.

Solución: Verifique que la ruta de la API sea correcta y no contenga caracteres anómalos.

429-Throttling

Se activó la limitación de solicitudes.

Causa: Las llamadas a la API activaron el límite de velocidad.

Solución: Reduzca la frecuencia de llamadas o reintente más tarde.

Demasiadas solicitudes en la ruta. Inténtelo de nuevo más tarde.

Causa: Demasiadas solicitudes activaron la limitación de tasa.

Solución: Inténtelo de nuevo más tarde.

Todos los modelos tienen limitación de tasa temporalmente. Por favor, inténtelo de nuevo en unos minutos.

Causa: Al utilizar servicios como Coding Plan que llaman a múltiples modelos a través de un cliente (por ejemplo, Claude Code), este mensaje es devuelto por el cliente cuando todos los modelos disponibles han activado la limitación de tasa 429. Los códigos de error subyacentes del lado del servidor de Model Studio son Throttling.RateQuota o Throttling.AllocationQuota.

Solución:

• Espere unos minutos e inténtelo de nuevo. El límite de tasa se levantará automáticamente.
• Reduzca la concurrencia de solicitudes para evitar enviar demasiadas solicitudes en un período corto.
• Para aumentar su límite de tasa, consulte Limitación de tasa para solicitar un aumento de cuota.

429-Throttling.RateQuota/LimitRequests/limit_requests

Ha excedido su límite de solicitudes./Se excedió el límite de tasa de solicitudes, inténtelo de nuevo más tarde./Excedió su lista actual de solicitudes.

Causa: La frecuencia de llamadas (RPS/RPM) activó el límite de tasa.

Solución: Consulte Limitación de tasa para controlar la frecuencia de llamadas.

Nota: Si una sola llamada devuelve 429, verifique si el encabezado de la solicitud establece X-DashScope-Async: enable. Algunos modelos (como qwen-image-3.0-pro) no admiten llamadas asíncronas; cuando este encabezado está configurado, incluso una sola solicitud devuelve 429. Elimine el encabezado X-DashScope-Async o establezca su valor en disable, y luego reintente con una llamada síncrona. Para más información, consulte La API del usuario actual no admite llamadas asíncronas bajo 403-AccessDenied/access_denied en este tema.

429-Throttling.BurstRate/limit_burst_rate

La tasa de solicitudes aumentó demasiado rápido. Para garantizar la estabilidad del sistema, ajuste la lógica de su cliente para escalar las solicitudes de manera más gradual a lo largo del tiempo.

Causa: La frecuencia de llamadas aumentó repentinamente antes de alcanzar los límites de tasa, activando la protección de estabilidad del sistema.

Solución: Optimice la lógica del cliente para utilizar estrategias de solicitud fluidas (por ejemplo, programación uniforme, retroceso exponencial o almacenamiento en búfer de cola de solicitudes) a fin de distribuir las solicitudes uniformemente a lo largo del tiempo y evitar picos.

429-Throttling.AllocationQuota/insufficient_quota

Cuota asignada excedida, aumente su límite de cuota./ Ha excedido su cuota actual, verifique los detalles de su plan y facturación.

Causa: El consumo de tokens por segundo o minuto (TPS/TPM) activó la limitación de tasa.

Solución: Consulte la documentación de Limitación de velocidad para conocer los límites del modelo y ajustar la estrategia de llamadas. Si las cuotas predeterminadas son insuficientes, póngase en contacto con su gerente de cuenta para solicitar un aumento de cuota.

Consulte las preguntas frecuentes para evitar activar límites de tasa.

Demasiadas solicitudes. Las solicitudes por lotes están siendo limitadas debido a los límites de capacidad del sistema. Por favor, inténtelo de nuevo más tarde.

Causa: Demasiadas solicitudes Batch activaron el límite de tasa.

Solución: Su solicitud no se puede procesar ahora; inténtelo de nuevo más tarde.

Se excedió la cuota gratuita asignada.

Causa: La cuota gratuita caducó o se agotó, y el modelo no admite el pago por uso.

Solución: Reemplace con otro modelo; por ejemplo, si la cuota del modelo de audio de Qwen está agotada, utilice el modelo no en tiempo real (Qwen-Omni).

Se excedió el límite máximo de voces clonadas.

Causa: Al utilizar la clonación de voz de Qwen-TTS, superó el límite de timbres de la cuenta principal.

Solución: Elimine algunos timbres.

429-Throttling.ServiceOverloaded

InternalError.Algo: Ocurrió un error en el servicio del modelo, el mensaje de error es: [Demasiadas solicitudes.]

Causa: Los recursos de red se encuentran actualmente sobrecargados y no pueden procesar su solicitud por el momento.

Solución: Inténtelo de nuevo más tarde.

429-Throttling.ResourceExhausted

InternalError.Algo: Ocurrió un error en el servicio del modelo, el mensaje de error es: [Demasiadas solicitudes.]

Causa: Los recursos de red se encuentran actualmente saturados y no pueden procesar su solicitud por el momento.

Solución: Inténtelo de nuevo más tarde.

429-CommodityNotPurchased

El servicio aún no ha sido adquirido.

Causa: Suscripción al espacio de trabajo no adquirida.

Solución: Adquiera primero el servicio de espacio de trabajo.

429-PrepaidBillOverdue

La factura prepago está vencida.

Causa: La factura prepago del espacio de trabajo ha caducado.

429-PostpaidBillOverdue

La factura pospago está vencida.

Causa: El servicio de inferencia del modelo ha caducado.

429-BudgetLimitExceeded

El presupuesto configurado en Gestión de presupuestos se ha agotado. No podrá realizar más llamadas a la API hasta que se aumente o restablezca el límite del presupuesto.

Causa: El límite de presupuesto configurado en Gestión de presupuestos se ha agotado y se habilitó "Detener servicio al alcanzar el presupuesto".

Solución: Aumente el límite de presupuesto o desactive "Detener servicio al alcanzar el presupuesto" en la página de Budget Management para reanudar las llamadas.

430-Audio.DecoderError

Error al decodificar el archivo de audio.

Causa: Falló la decodificación del archivo de audio de clonación de voz de CosyVoice.

Solución: Utilice herramientas (como ffprobe, mediainfo) o comandos (como el comando file de Linux/macOS) para verificar el formato de codificación de audio real.

430-Audio.FileSizeExceed

Archivo demasiado grande

Causa: El tamaño del archivo de audio de clonación de voz de CosyVoice excede el límite.

Solución: El archivo de audio para clonación de voz debe ser menor de 10 MB.

430-Audio.AudioRateError

Tasa de muestreo del archivo no compatible

Causa: La tasa de muestreo del archivo de audio de clonación de voz de CosyVoice no es compatible.

Solución: Establezca la tasa de muestreo en 16 kHz o superior.

430-Audio.AudioSilentError

Archivo silencioso no compatible.

Causa: El archivo de audio de clonación de voz de CosyVoice es silencioso o los segmentos no silenciosos son demasiado cortos.

Solución: Mantenga la duración del audio alrededor de 10–15 segundos e incluya al menos un segmento de habla continua de más de 5 segundos.

500-InternalError/internal_error

Ha ocurrido un error interno; por favor, inténtelo de nuevo más tarde o contacte al soporte técnico.

Causa: Error interno.

Solución:

• Si utiliza el modelo (Qwen-Omni) y la API requiere transmisión, establezca stream=true.

• Si utiliza la clonación de voz de CosyVoice, las posibles causas son:

  • El archivo de audio no es estándar; por ejemplo, mala calidad de audio, ruido o fluctuaciones de volumen. Consulte las Directrices de grabación e inténtelo de nuevo.
  • La URL del archivo de grabación es inaccesible. Siga las instrucciones en la CosyVoice API de Clonación/Diseño de Voz y reintente.
  • El archivo de grabación es demasiado largo. Utilice grabaciones de alrededor de 10–15 segundos con al menos un segmento de habla continua de más de 5 segundos.

¡Error interno del servidor!

Causa: Error interno del algoritmo.

Solución: Inténtelo de nuevo más tarde.

error del servidor de preprocesamiento de audio

Uso de clonación de voz CosyVoice:

• Causa: El archivo de audio no es estándar; por ejemplo, tiene mala calidad de audio, ruido o fluctuaciones de volumen.

  Solución: Consulte las Directrices de grabación y reintente.

• Causa: La URL del archivo de grabación es inaccesible,

  Solución: Siga las instrucciones en la CosyVoice API de Clonación/Diseño de Voz y reintente.

• Causa: El archivo de grabación es demasiado largo.

  Solución: Utilice grabaciones de alrededor de 10–15 segundos con al menos un segmento de habla continua de más de 5 segundos.

error en la solicitud asr

Causa: Al utilizar clonación de voz de CosyVoice, el archivo de audio no es estándar: carece de habla válida o tiene un audio poco claro con mucho ruido.

Solución: Consulte las Directrices de grabación y reintente.

Flujo grpc cancelado remotamente.

Causa: El timbre utilizado en la síntesis de voz no existe.

Solución: Compruebe el parámetro voice y asegúrese de especificar un nombre de timbre válido. Consulte Síntesis de voz en tiempo real (CosyVoice) para ver los timbres disponibles.

500-InternalError.FileUpload

error de carga en oss.

Causa: Error al subir el archivo.

Solución: Verifique la configuración de OSS y la red.

500-InternalError.Upload

Error al subir el resultado.

Causa: Error al subir el resultado.

Solución: Verifique la configuración de almacenamiento o inténtelo de nuevo más tarde.

500-InternalError.Algo

error interno de inferencia.

Causa: Excepción del servicio.

Solución: Reintente primero para descartar problemas transitorios.

Se esperaba el delimitador ',': línea x columna xxx (carácter xxx)

Causa: Los datos JSON generados por el modelo no son válidos, lo que impide las llamadas a herramientas.

Solución: Cambie al modelo más reciente u optimice los prompts e inténtelo de nuevo.

Falta Content-Length en la URL multimodal.

Causa: Falta el campo Content-Length en el encabezado de respuesta de la URL.

Solución: Si no se resuelve, pruebe con otro enlace de imagen.

Verificar el campo Content-Length

1. Abra un navegador (como Chrome o Firefox).
2. Abra las herramientas para desarrolladores (generalmente presionando F12 o haciendo clic derecho y seleccionando "Inspect").
3. Cambie a la pestaña Network.
4. Ingrese la URL de la imagen en la barra de direcciones y visítela.
5. Encuentre la solicitud correspondiente y busque en Headers > Response Headers el campo Content-Length.

Ocurrió un error en el servicio del modelo, el mensaje de error es: [¡Solicitud rechazada por el motor de inferencia!]

Causa: Error del servidor backend del servicio de modelo.

Solución: Inténtelo de nuevo más tarde.

Ocurrió un error en el servicio del modelo; el mensaje de error es: [¡Clúster 'xxx' no encontrado!]

Causa: La solicitud de API se enruto a un clúster de servicio no disponible. Esto suele suceder porque los servicios de modelos de Alibaba Cloud Model Studio aún no están implementados en la región especificada en la solicitud.

Solución: Verifique que la región en la URL base de su solicitud o en la configuración del SDK sea correcta. Los servicios de modelos de Model Studio están disponibles actualmente en regiones como China (Beijing), Singapur y EE. UU. (Virginia). Asegúrese de llamar a una región donde el servicio esté implementado. Si utiliza un endpoint a nivel de espacio de trabajo (en el formato https://{WorkspaceId}.{region}.maas.aliyuncs.com/compatible-mode/v1), confirme que {region} es el identificador de una región donde el servicio está habilitado.

Ocurrió un error interno durante la ejecución del algoritmo.

Causa: Error de ejecución del algoritmo.

Solución: Inténtelo de nuevo más tarde.

Error de inferencia: Error de inferencia.

Causa: Error de inferencia.

Solución: Verifique si el archivo de imagen está dañado o si la calidad de la imagen de la persona es suficiente (debe contener un rostro completo y claro).

El rol debe estar en [user, assistant]

Causa: Al utilizar el modelo Qwen-MT, el arreglo messages contiene mensajes con roles distintos de user.

Solución: Asegúrese de que la matriz messages contenga solo un elemento, el cual debe ser un mensaje de usuario (User Message).

Embedding_pipeline_Error: xxx

Causa: Error de preprocesamiento de imagen o video.

Solución: Confirme que las imágenes/videos cargados y el código de solicitud cumplen con los requisitos, luego reintente.

¡Error al recibir respuesta del backend de procesamiento por lotes!

Causa: Error interno del servicio.

Solución: Inténtelo de nuevo más tarde.

[music]¡Error al recibir la respuesta del backend por lotes!

Causa: Al utilizar el modelo Fun-Music, se superaron los límites de concurrencia del servicio.

Solución: Reduzca las solicitudes simultáneas y reintente.

Otros tipos de error del servidor.

Causa: Al usar el modelo Fun-Music, se produjo una excepción interna desconocida del sistema.

Solución: Proporcione el ID de solicitud al personal técnico para la resolución de problemas.

Se ha producido un error interno durante la ejecución; inténtelo de nuevo más tarde o póngase en contacto con el soporte técnico. / error de proceso del algoritmo. / error de inferencia. / Se produce un error interno durante el cálculo; inténtelo con este modelo más tarde.

Causa: Error interno del algoritmo.

Solución: Inténtelo de nuevo más tarde.

índice de lista fuera de rango

Causa: El último elemento en el arreglo messages debe ser un mensaje de usuario.

Solución: Ajuste el orden de la matriz messages para asegurar que el último elemento sea {"role": "user", ...}.

500-InternalError.Timeout

Ha ocurrido un error de tiempo de espera interno durante la ejecución; por favor, inténtelo de nuevo más tarde o contacte al soporte del servicio.

Causa: La tarea asíncrona no devolvió resultados dentro de 3 horas, lo que provocó un tiempo de espera agotado.

Solución: Verifique la ejecución de la tarea o contacte a soporte.

500-SystemError

Ha ocurrido un error del sistema, inténtelo de nuevo más tarde.

Causa: Error del sistema.

Solución: Inténtelo de nuevo más tarde.

500-ModelServiceFailed

Error al solicitar el servicio del modelo.

Causa: Error en la llamada al servicio del modelo.

Solución: Inténtelo de nuevo más tarde.

500-RequestTimeOut

La solicitud ha expirado; inténtelo de nuevo más tarde. / ¡Tiempo de espera de respuesta agotado! / Error de E/S en la solicitud POST para "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions": tiempo de espera agotado

Causa:

• Tiempo de espera agotado al llamar a modelos grandes; el error de tiempo de espera ocurre después de 300 segundos.
• Al utilizar el reconocimiento de voz (Paraformer), no se envió audio al servidor durante mucho tiempo o hubo silencio prolongado.
• Al llamar a modelos de generación o edición de imágenes, el tiempo de procesamiento excede los límites debido al gran tamaño de la imagen o a su alta complejidad.

Solución:

• Utilice salida por streaming. Consulte Salida por streaming.
• Establezca el parámetro heartbeat en true o finalice las tareas de reconocimiento oportunamente.
• Al llamar a modelos de imágenes, intente reducir la resolución, simplificar las ediciones o reintentar más tarde.

500-ResponseTimeout

Tiempo de espera del flujo de respuesta

Causa: Al usar el modelo Fun-Music, la ejecución interna excedió el tiempo de espera.

Solución: Reintente la llamada.

500-InvokePluginFailed

Error al invocar el complemento.

Causa: Error en la invocación del complemento.

Solución: Verifique la configuración y disponibilidad del plugin.

500-AppProcessFailed

Error al procesar la solicitud de la aplicación.

Causa: Error en el procesamiento del flujo de la aplicación.

Solución: Verifique la configuración de la aplicación y los nodos de flujo.

500-RewriteFailed

Error al reescribir el contenido del prompt.

Causa: Falló la llamada al modelo grande para reescritura del prompt.

Solución: Inténtelo de nuevo más tarde.

500-RetrivalFailed

Error al recuperar datos de los documentos.

Causa: Error en la recuperación de documentos.

Solución: Verifique el índice de documentos y la configuración de recuperación.

500/503-ServiceUnavailable

Demasiadas solicitudes. Sus solicitudes están siendo limitadas debido a los límites de capacidad del sistema. Por favor, inténtelo de nuevo más tarde.

Causa: Los recursos de red están saturados; su solicitud no se puede procesar temporalmente.

Solución: Inténtelo de nuevo más tarde.

503-ModelUnavailable

El modelo no está disponible, inténtelo de nuevo más tarde.

Causa: Modelo temporalmente no disponible.

Solución: Inténtelo de nuevo más tarde.

Errores del SDK

error.AuthenticationError: No se proporcionó ninguna clave de API. Puede configurarla mediante dashscope.api_key = your_api_key en el código, o puede establecerla a través de la variable de entorno DASHSCOPE_API_KEY= your_api_key.

Causa: No se proporcionó la API Key al utilizar DashScope SDK.

Solución: Consulte Configuración de API Key como variable de entorno para obtener más detalles.

openai.OpenAIError: La opción de cliente api_key debe establecerse pasando api_key al cliente o configurando la variable de entorno OPENAI_API_KEY

Causa: No se proporcionó la API Key al usar el SDK de OpenAI.

Solución:

• Pase la API Key mediante variable de entorno (recomendado)

  Configure DASHSCOPE_API_KEY como variable de entorno (consulte Configuración de la clave de API como variable de entorno) y luego inicialice client leyéndola con os.getenv:

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

• Codificar la clave API directamente (solo para pruebas)

  Pase directamente la API Key al parámetro api_key:

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

  Nota: Esto representa un riesgo de seguridad; no lo utilice en producción.

Solicitud incorrecta para url:xxx

Causa: Al utilizar la biblioteca requests de Python, agregar response.raise_for_status() provoca errores sin devolver el contenido específico del error del servidor.

Solución: Use print(response.json()) para ver la respuesta del servidor.

No se puede resolver el símbolo 'ttsv2'

Causa: Si utiliza síntesis de voz en tiempo real (CosyVoice), este problema surge debido a una versión obsoleta del SDK de DashScope.

Solución: Instale la última versión del SDK de DashScope.

NetworkError

NoApiKeyException: No se puede encontrar api-key.

Causa: La configuración de la variable de entorno no surtió efecto.

Solución: Reinicie su cliente o IDE y vuelva a intentarlo. Consulte las Preguntas frecuentes para más escenarios.

ConnectException: Error al conectar a dashscope.aliyuncs.com

Causa: El entorno de red local es anómalo.

Solución: Verifique la red local; por ejemplo, acceso HTTPS bloqueado por problemas de certificados o configuraciones incorrectas del firewall. Pruebe con una red o servidor diferente.

InputRequiredException: Parámetro no válido: text es null

Causa: Al utilizar la síntesis de voz en tiempo real (CosyVoice), no se envió texto para sintetizar.

Solución: Asigne un valor al parámetro text al llamar a la API de síntesis de voz.

A MultiModalConversation.call() le falta 1 argumento posicional requerido: 'messages'

Causa: La versión actual del SDK de DashScope está desactualizada.

Solución: Instale la última versión del SDK de DashScope.

mismatched_model

El modelo 'xxx' de esta solicitud no coincide con el resto del lote. Cada lote debe contener solicitudes para un único modelo.

Causa: En una sola tarea por lotes (Batch), todas las solicitudes deben usar el mismo modelo.

Solución: Verifique su archivo de entrada conforme a Compatible con OpenAI - Lote (entrada de archivo).

duplicate_custom_id

El custom_id 'xxx' de esta solicitud es un duplicado de otra solicitud. El parámetro custom_id debe ser único para cada solicitud en un lote.

Causa: En una sola tarea por lotes (Batch), cada ID de solicitud debe ser único.

Solución: Verifique su archivo de entrada conforme a Compatible con OpenAI - Batch (entrada de archivo) para asegurarse de que todos los ID de solicitud sean únicos.

La capacidad de carga de archivos supera el límite. / El número de archivos cargados supera el límite.

Causa: La carga del archivo falló porque el espacio de almacenamiento de Alibaba Cloud Model Studio bajo su cuenta está lleno o casi lleno.

Solución: Elimine los archivos innecesarios a través de la interfaz Compatible con OpenAI - Archivo para liberar espacio. El almacenamiento actual admite hasta 10,000 archivos con un total no superior a 100 GB.

Errores de WebSocket

El mensaje de texto decodificado era demasiado grande para el búfer de salida y el endpoint no admite mensajes parciales

Causa: Al utilizar reconocimiento de voz en streaming (Paraformer), el servicio devolvió resultados de reconocimiento demasiado grandes.

Solución: Envíe el audio en segmentos de aproximadamente 100 ms cada uno, con un tamaño de datos entre 1 KB y 16 KB.

TimeoutError: no se pudo establecer la conexión websocket en 5s. Verifique su conexión de red, la configuración del firewall o el estado del servidor.

Causa: Si utiliza síntesis de voz (CosyVoice), la conexión WebSocket no pudo establecerse dentro de 5 segundos.

Solución: Verifique la red local, la configuración del firewall o pruebe con una red o servidor diferente.

formato de audio no compatible:xxx

Causa: Al utilizar la clonación de voz de CosyVoice, el formato de audio cargado no cumple con los requisitos del modelo.

Solución: El formato de audio debe ser WAV (16bit), MP3 o M4A. No confíe únicamente en las extensiones de archivo; utilice herramientas (como ffprobe, mediainfo) o comandos para verificar el formato de codificación real.

error interno desconocido

Causa: Es posible que el formato del archivo de audio de clonación de voz de CosyVoice no cumpla con los requisitos.

Solución: El formato de audio debe ser WAV (16bit), MP3 o M4A. Utilice herramientas para verificar el formato de codificación real.

Se recibió una respuesta de backend no válida (falta el nombre de estado)

Causa: Al utilizar la API RESTful de reconocimiento de archivos grabados de Paraformer, los parámetros de la solicitud están mal escritos.

Solución: Revise el código conforme a la documentación de la API.

NO_INPUT_AUDIO_ERROR

Causa: No se detectó habla válida.

Solución: Si utiliza el reconocimiento de voz en tiempo real de Paraformer, solucione el problema de la siguiente manera:

1. Verifique la entrada de audio.
2. Verifique el formato de audio (admitidos: pcm, wav, mp3, opus, speex, aac, amr).

SUCCESS_WITH_NO_VALID_FRAGMENT

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la consulta del resultado de reconocimiento fue exitosa, pero el módulo VAD no detectó habla válida.

Solución: Verifique si la grabación contiene habla válida. Si todo es silencio, es normal que no haya resultado de reconocimiento.

ASR_RESPONSE_HAVE_NO_WORDS

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la consulta del resultado de reconocimiento fue exitosa, pero el resultado final está vacío.

Solución: Verifique si la grabación contiene habla válida, o si el habla válida consiste únicamente en muletillas y el parámetro disfluency_removal_enabled las filtró.

FILE_DOWNLOAD_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el archivo a reconocer no se pudo descargar.

Solución: Verifique si la ruta del archivo de grabación es correcta y accesible a través de la red pública.

FILE_CHECK_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el formato del archivo es incorrecto.

Solución: Verifique si el archivo de grabación tiene formato WAV de pista única/dual o MP3.

FILE_TOO_LARGE

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el archivo a reconocer es demasiado grande.

Solución: Compruebe si el archivo de grabación excede 2 GB; de ser así, divídalo.

FILE_NORMALIZE_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la normalización del archivo falló.

Solución: Compruebe si el archivo de grabación está dañado o si se puede reproducir.

FILE_PARSE_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, falló el análisis del archivo.

Solución: Compruebe si el archivo de grabación está dañado o si se puede reproducir.

MKV_PARSE_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, falló el análisis MKV.

Solución: Compruebe si el archivo de grabación está dañado o si se puede reproducir.

FILE_TRANS_TASK_EXPIRED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la tarea de reconocimiento ha caducado.

Solución: TaskId no existe o ha caducado. Vuelva a enviar la tarea.

REQUEST_INVALID_FILE_URL_VALUE

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el parámetro file_link no es válido.

Solución: Confirme que el formato del parámetro file_url sea correcto.

CONTENT_LENGTH_CHECK_FAILED

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la verificación de content-length falló.

Solución: Verifique que el content-length de la respuesta HTTP coincida con el tamaño real del archivo al descargar la grabación.

FILE_404_NOT_FOUND

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el archivo a descargar no existe.

Solución: Verifique si la URL del archivo es correcta.

FILE_403_FORBIDDEN

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, no tiene permiso para descargar la grabación.

Solución: Verifique los permisos de acceso al archivo.

FILE_SERVER_ERROR

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, el servidor de archivos no está disponible.

Solución: Reintente más tarde o verifique el estado del servidor de archivos.

AUDIO_DURATION_TOO_LONG

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, la duración del archivo supera las 12 horas.

Solución: Divida el audio en segmentos y envíe múltiples tareas de reconocimiento. Utilice herramientas como FFmpeg para dividir.

DECODE_ERROR

Causa: Si utiliza el reconocimiento de archivos grabados de Paraformer, falló la detección de información del archivo de audio.

Solución: Confirme que el enlace de descarga apunte a un formato de audio compatible.

CLIENT_ERROR-[qwen-tts:]El motor devolvió el código de error: 411

Causa: Al utilizar la síntesis de voz en tiempo real de Qwen-TTS con el modelo qwen-tts-vc-realtime-2025-08-20, utilizó un timbre predeterminado. Este modelo solo admite timbres clonados.

Solución: Utilice un timbre generado mediante clonación de voz, no un timbre predeterminado.

NO_VALID_AUDIO_ERROR

Causa: Al utilizar el reconocimiento de voz (Paraformer), el audio a reconocer no es válido.

Solución: Verifique el formato de audio, la frecuencia de muestreo, etc., para asegurar que se cumplan los requisitos.

InvalidParameter: task no puede ser null

Causa: Al utilizar la API WebSocket de síntesis de voz de CosyVoice, al payload de run-task o finish-task le falta un campo input, o al payload de continue-task le falta input.text.

Solución:

1. Verifique el comando run-task: asegúrese de que la carga útil contenga "input": {} (objeto vacío); no omita input.
2. Verifique el comando continue-task: asegúrese de que payload.input contenga un campo de texto no vacío.
3. Verifique el comando finish-task: asegúrese de que payload contenga "input": {}.

código de cierre 1007 Modelo no encontrado

Causa: Al llamar a un modelo en tiempo real (por ejemplo, Qwen3-Omni-Flash-Realtime) mediante el protocolo WebSocket, el nombre del modelo en la solicitud es incorrecto o el servicio del modelo no está activado. El servidor cierra la conexión con el código de cierre 1007 y el motivo Model not found.

Solución:

• Compare con los nombres de modelos en la Lista de modelos para verificar su entrada (valor del parámetro model). El nombre de un modelo en tiempo real lleva un sufijo como -realtime, el cual no debe omitirse ni modificarse.
• Vaya al Marketplace de modelos para confirmar que el servicio del modelo está activado. Si no lo está, actívelo y vuelva a intentarlo.

200-BailianGateway.Workspace.NotAuthorised

Causa: Este error puede deberse a: (1) caracteres especiales o formatos no estándar en la URL de acceso que provocan un fallo en la validación de autorización del espacio de trabajo; (2) una subcuenta RAM que opera en un espacio de trabajo sin los permisos necesarios.

Solución: (1) Vuelva a visitar la página principal de la consola de Model Studio y navegue hasta la página de destino; (2) la cuenta principal o una cuenta RAM con permisos administrativos debe otorgar acceso a la subcuenta al espacio de trabajo correspondiente.

200-BailianGateway.Team.NotAuthorised

Causa: La subcuenta RAM actual no tiene permiso para el equipo (organización) al que está accediendo. Cuando una subcuenta RAM accede a recursos de un equipo (organización) para los cuales no está autorizada, la verificación de autorización a nivel de equipo de la puerta de enlace falla y devuelve este error.

Solución: La cuenta principal o una cuenta RAM con permisos administrativos debe agregar la subcuenta RAM al equipo correspondiente (organización) y otorgarle los permisos adecuados en la gestión de permisos.

Plan de codificación

Error de conexión

Causa: Error tipográfico en la URL base o problema de red.

Solución: Verifique la ortografía de la Base URL y la conexión de red.

cuota asignada por hora excedida

Causa: Cuota de solicitudes de 5 horas agotada.

Solución: La cuota se restablece automáticamente después de 5 horas.

cuota asignada semanal excedida

Causa: Cuota de solicitudes semanal agotada.

Solución: La cuota se restablece a las 00:00:00 (UTC+8) cada lunes.

cuota mensual asignada excedida

Causa: Cuota de solicitudes mensual agotada.

Solución: La cuota se restablece a las 00:00:00 (UTC+8) del día de suscripción cada mes.

cuota de concurrencia asignada excedida

Causa: Las solicitudes concurrentes actuales superan el límite asignado dinámicamente por la plataforma.

Solución: Inténtelo de nuevo en breve. La plataforma ajusta dinámicamente los límites de concurrencia según la carga general; los periodos de máxima demanda pueden activar esta restricción.

Se excedió la cuota asignada de uso. Inténtelo de nuevo más tarde.

Causa: Además de los límites de recuento de llamadas, Coding Plan también evalúa el consumo de recursos a corto plazo. Un alto consumo a corto plazo activa una limitación de tasa temporal.

Solución: Generalmente se recupera en una hora. Divida las tareas grandes en otras más pequeñas y envíelas gradualmente.