Errores y límites de tasa

Fetch Hive devuelve errores en JSON para solicitudes inválidas o fallidas a la API pública. Los errores de runtime de la API pública incluyen un message legible para humanos, un código estable y error como alias de compatibilidad.

Formato de la respuesta de error

{
  "error": "Invalid access.",
  "message": "Invalid access.",
  "error_code": "validation_error"
}

Algunas respuestas de plan y de límite de tasa también incluyen code para compatibilidad con clientes existentes. Los nuevos clientes deben leer error_code. Consulta Códigos de error para ver la lista completa de códigos, el endpoint del catálogo y la guía para el manejo desde el cliente.

Códigos de estado comunes

`401 Unauthorized`

Fetch Hive devuelve 401 cuando el encabezado Authorization está ausente, es inválido o usa una clave de API revocada. Ejemplo:

{
  "error": "Invalid access."
}

`404 Not Found`

Fetch Hive devuelve 404 cuando el recurso no existe para tu cuenta. Respuesta de ejemplo para una ejecución de flujo de trabajo:

{
  "error": "Prompt workflow run not found"
}

Respuesta de ejemplo para una búsqueda de solicitud:

{
  "error": "Request not found"
}

`422 Unprocessable Entity`

Fetch Hive devuelve 422 cuando la solicitud está autenticada pero es inválida para ese endpoint. Ejemplos:

{
  "error": "Agent not found."
}

{
  "error": "Data set not found."
}

{
  "error": "You've reached your credit cap."
}

`502 Bad Gateway`

Fetch Hive devuelve 502 cuando un proveedor falla al procesar una solicitud de prompt o agente. Ejemplo:

{
  "error": "openai API error: provider rejected the request"
}

Límites de tasa y concurrencia

Las solicitudes a la API pública cuentan contra el tope diario de llamadas a la API de tu plan. Si excedes ese tope, Fetch Hive devuelve 429 Too Many Requests antes de ejecutar la solicitud. Respuesta de ejemplo para el tope diario de la API:

{
  "error": "Daily API rate limit reached",
  "code": "api_rate_limit_exceeded",
  "message": "You have reached your daily limit of 50 API calls. Resets at midnight UTC. Upgrade your plan for higher limits.",
  "limit": 50,
  "current": 50
}

La concurrencia de flujos de trabajo depende de tu plan.

Plan	Tope de concurrencia
Lite	1
Starter	3
Pro	5
Entreprise	Personalizado

Si excedes tu tope de concurrencia, Fetch Hive devuelve 429 Too Many Requests. Ejemplo:

{
  "error": "You've reached your concurrency limit. Try again later or use async mode."
}

Si ves esta respuesta en una solicitud de flujo de trabajo, reintenta más tarde o cambia a entrega por callback para que Fetch Hive pueda encolar la ejecución.

Relacionado

Consulta Autenticación para el encabezado bearer requerido
Consulta Códigos de error para los valores estables de error_code y GET /v1/error_codes
Consulta Invocar flujo de trabajo para solicitudes de flujo de trabajo con entrega por callback

Autenticación Códigos de error

⌘I

​Errores y límites de tasa

​Formato de la respuesta de error

​Códigos de estado comunes

​401 Unauthorized

​404 Not Found

​422 Unprocessable Entity

​502 Bad Gateway

​Límites de tasa y concurrencia

​Relacionado