Lista błędów
Kody błędów API integracji wtyczek, mapowanie statusów HTTP i troubleshooting.
Każda odpowiedź błędu z API integracji wtyczek używa tej samej koperty:
{
"error": {
"code": "quota_exceeded",
"message_i18n": {
"en": "Account does not have enough credits to reserve this job. Top up the credit balance.",
"pl": "Konto nie ma wystarczającej liczby kredytów..."
},
"retryable": false,
"doc_url": "https://app.qamera.ai/docs/plugin-api/errors/quota_exceeded"
}
}
code jest stabilny między wydaniami — rozgałęziaj na nim w kliencie. message_i18n jest informacyjny i może ewoluować. retryable doradza, czy ponowienie z tym samym payloadem może się udać.
Kody
| Kod | HTTP | Retryable | Znaczenie |
|---|---|---|---|
invalid_input | 400 | nie | Payload zapytania nie przeszedł walidacji |
unauthorized | 401 | nie | Brakujący, błędny lub odwołany klucz API |
forbidden | 403 | nie | Klucz nie ma wymaganego scope |
not_found | 404 | nie | Zasób nie istnieje lub jest niedostępny |
idempotency_conflict | 409 | nie | Idempotency-Key użyty ponownie z innym payloadem |
job_not_cancelable | 409 | nie | Zadanie nie jest w stanie pozwalającym na anulowanie |
job_not_completed | 409 | nie | Outputy zlecone przed ukończeniem zadania |
batch_limit_exceeded | 400 | nie | Za dużo elementów w batchu |
rate_limit_exceeded | 429 | tak | Wyczerpany budżet zapytań na klucz |
quota_exceeded | 402 | nie | Konto bez kredytów |
concurrency_limit_exceeded | 429 | tak | Konto osiągnęło limit równoczesnych zadań dla providera |
content_policy_violation | 422 | nie | Źródłowy asset lub parametry łamią politykę |
source_asset_unavailable | 422 | nie | Nie można pobrać wskazanego source asset |
low_quality_input | 422 | nie | Jakość source asset za niska dla wiarygodnej generacji |
output_unavailable | 410 | nie | Wygenerowany asset został usunięty z magazynu |
generation_failed | 502 | tak | Błąd upstream providera AI |
internal_error | 500 | tak | Nieoczekiwany błąd serwera |