Errores
Errores HTTP
Nuestra API sigue un formato predecible de códigos de error HTTP:
- 400 -
invalid_request_error
: Hubo un problema con el formato o contenido de tu solicitud. También podemos usar este tipo de error para otros códigos de estado 4XX no listados a continuación. - 401 -
authentication_error
: Hay un problema con tu clave API. - 403 -
permission_error
: Tu clave API no tiene permiso para usar el recurso especificado. - 404 -
not_found_error
: No se encontró el recurso solicitado. - 413 -
request_too_large
: La solicitud excede el número máximo permitido de bytes. - 429 -
rate_limit_error
: Tu cuenta ha alcanzado un límite de velocidad. - 500 -
api_error
: Ha ocurrido un error inesperado interno en los sistemas de Anthropic. - 529 -
overloaded_error
: La API de Anthropic está temporalmente sobrecargada.
Al recibir una respuesta de streaming a través de SSE, es posible que ocurra un error después de devolver una respuesta 200, en cuyo caso el manejo de errores no seguiría estos mecanismos estándar.
Formas de error
Los errores siempre se devuelven como JSON, con un objeto error
de nivel superior que siempre incluye valores de type
y message
. Por ejemplo:
De acuerdo con nuestra política de versionado, podemos expandir los valores dentro de estos objetos, y es posible que los valores de type
aumenten con el tiempo.
ID de solicitud
Cada respuesta de la API incluye un encabezado único request-id
. Este encabezado contiene un valor como req_018EeWyXxfu5pfWkrYcMdjWG
. Cuando contactes al soporte sobre una solicitud específica, por favor incluye este ID para ayudarnos a resolver tu problema rápidamente.
Was this page helpful?