ShardoAI Docs
Гайды

Обработка ошибок

Коды ошибок и как на них реагировать

Обработка ошибок

Все ошибки возвращаются в формате:

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key not found or revoked",
    "type": "authentication_error"
  }
}

Коды

StatuscodeЧто делать
400invalid_requestПроверьте тело запроса
401invalid_api_keyСгенерируйте новый ключ
403insufficient_scopeКлюч без нужных прав
404model_not_foundПроверьте model в запросе
429rate_limit_exceededBackoff по Retry-After
429tokens_per_minute_exceededBackoff или повысьте тариф
500internal_errorПовторите с экспоненциальной задержкой
503model_overloadedПодождите и повторите

Идемпотентность

Передайте заголовок Idempotency-Key: <uuid> чтобы безопасно повторять запросы — повтор с тем же ключом вернёт исходный ответ.

On this page