Códigos de Error
La API utiliza códigos de estado HTTP estándar y devuelve información detallada de errores en un formato de respuesta consistente.
| Código | Significado |
|---|
| 200 | Éxito |
| 400 | Solicitud Incorrecta — parámetros no válidos |
| 401 | No Autorizado — token no válido o expirado |
| 402 | Pago Requerido — cuota insuficiente |
| 403 | Prohibido — acceso denegado a este recurso |
| 404 | No Encontrado — el recurso no existe |
| 413 | Carga Demasiado Grande — el cuerpo de la solicitud es demasiado grande |
| 429 | Demasiadas Solicitudes — límite de velocidad excedido |
| 500 | Error Interno del Servidor |
| 502 | Bad Gateway — servicio de IA upstream no disponible |
| 503 | Servicio No Disponible — sobrecarga temporal |
Todos los errores devuelven una estructura JSON consistente:
{
"error": {
"code": 400,
"message": "Invalid prompt parameter",
"type": "invalid_request_error",
"param": "prompt",
"fallback_suggestion": "provide a valid prompt"
}
}
| Campo | Tipo | Descripción |
|---|
error.code | integer | Código de estado de error HTTP |
error.message | string | Descripción del error legible por humanos |
error.type | string | Categoría del tipo de error (ver abajo) |
error.param | string | El nombre del parámetro relacionado (cuando aplica) |
error.fallback_suggestion | string | Acción sugerida para resolver el error |
| Tipo | Código HTTP | Descripción |
|---|
invalid_request_error | 400 | El parámetro de solicitud no es válido o falta |
authentication_error | 401 | Token de API no válido o expirado |
insufficient_quota_error | 402 | La cuenta no tiene créditos suficientes. Recargar aquí |
permission_error | 403 | Sin permiso para acceder a este modelo o recurso |
not_found_error | 404 | Recurso solicitado (modelo, tarea) no encontrado |
request_too_large_error | 413 | El cuerpo de la solicitud excede los límites de tamaño |
rate_limit_error | 429 | Demasiadas solicitudes — reintente después del intervalo sugerido |
internal_server_error | 500 | Error interno del servidor — intente nuevamente más tarde |
upstream_error | 502 | Servicio de IA upstream no disponible — pruebe un modelo diferente |
service_unavailable_error | 503 | Servicio temporalmente no disponible — reintente después de 30 segundos |
import requests
response = requests.post(
"https://api.evolink.ai/v1/videos/generations",
headers=headers,
json=payload
)
if response.status_code == 200:
task = response.json()
print(f"Task created: {task['id']}")
elif response.status_code == 429:
# Rate limited — back off and retry
print("Rate limited. Retrying...")
elif response.status_code == 402:
print("Insufficient credits. Please top up at https://evolink.ai/dashboard/billing")
else:
error = response.json().get("error", {})
print(f"Error [{error.get('type')}]: {error.get('message')}")
if error.get("fallback_suggestion"):
print(f"Suggestion: {error.get('fallback_suggestion')}")
- Las generaciones de video fallidas no se cobran a su cuenta
- Consulte el estado de la tarea mediante Tareas Asíncronas para obtener detalles del fallo
- La mayoría de los errores pueden resolverse ajustando los parámetros y reintentando