Respuestas de error
Códigos de estado HTTP comunes, errores compatibles con OpenAI y errores de tareas asíncronas.
TENSORAXIS intenta devolver una forma de error que coincida con el estilo de API que estás utilizando. Las API compatibles con OpenAI suelen devolver un objeto error; las API de tareas asíncronas suelen devolver code, message y data.
Errores compatibles con OpenAI
{
"error": {
"message": "invalid request",
"type": "invalid_request_error",
"param": "",
"code": "invalid_request"
}
}Campos:
| Campo | Descripción |
|---|---|
error.message | Mensaje de error legible por humanos |
error.type | Tipo de error de TENSORAXIS o del proveedor upstream |
error.param | Parámetro de solicitud relacionado, cuando esté disponible |
error.code | Código de error, normalmente más estable que message |
Errores de tareas asíncronas
Las API de tareas asíncronas, como video, música y dibujo, pueden devolver:
{
"code": "invalid_request",
"message": "prompt is required",
"data": null
}Para la generación de video, un error de solicitud común es la falta de prompt. Si envías el cuerpo de nivel superior con estilo Volcengine content[] directamente a /v1/video/generations, TENSORAXIS no puede leer el campo prompt y devuelve 400 prompt is required.
Códigos de estado HTTP comunes
| Estado | Significado | Solución común |
|---|---|---|
400 | Cuerpo, parámetro o formato de modelo no válido | Verifica el JSON, los campos obligatorios y el nombre del modelo |
401 | Falló la autenticación | Verifica el token y el encabezado de autenticación |
403 | Problema de permisos o cuota | Verifica el alcance del token, la cuota de la cuenta y el acceso al grupo |
404 | Recurso no encontrado | Verifica el nombre del modelo, el ID de la tarea o la ruta |
429 | Límite de tasa excedido | Reduce la concurrencia, vuelve a intentarlo más tarde o ajusta los límites de token/grupo |
5xx | Error del servidor o upstream | Vuelve a intentarlo más tarde; contacta con soporte si persiste |
Para clientes automatizados, ramifica según los códigos de estado HTTP y los valores de code en lugar de comparar el texto completo de message. Los mensajes pueden variar según el proveedor upstream, el idioma o la configuración de implementación.