Kod ve gövde
Hatalar
Gateway hataları { error: { message, type } } biçiminde döner. 404 yanıtında ayrıca code alanı bulunur.
| HTTP | Tip | Ne zaman | Gövde | Ne yapmalı |
|---|---|---|---|---|
| 401 | invalid_api_key | Anahtar yok, geçersiz veya iptal edilmiş. | {"error":{"message":"Invalid API key","type":"invalid_api_key"}} | API Anahtarları sayfasından etkin bir anahtar kullanın. |
| 402 | insufficient_quota | Hesap bakiyesi veya anahtar limiti yetersiz. | {"error":{"message":"Insufficient balance. Please top up in the dashboard.","type":"insufficient_quota"}} | Bakiye yükleyin veya anahtar limitini artırın. Bakiye yükle → |
| 403 | account_disabled | Hesap devre dışı. | {"error":{"message":"Account disabled","type":"account_disabled"}} | Destek ile iletişime geçin. |
| 403 | email_not_verified | E-posta doğrulaması zorunlu ve hesap doğrulanmamış. | {"error":{"message":"Your email address is not verified. Please complete the verification link.","type":"email_not_verified"}} | Doğrulama bağlantısını tamamlayın. |
| 404 | model_not_found | Model kimliği katalogda yok veya bu anahtar için kapalı. | {"error":{"message":"The model 'example-model' does not exist or you do not have access to it.","type":"invalid_request_error","code":"model_not_found"}} | GET /v1/models listesindeki bir kimlik kullanın. |
| 423 | model_blocked | Model geçici olarak engelli. | {"error":{"message":"Model 'example-model' is temporarily blocked (up to 1 hour).","type":"model_blocked"}} | Yanıttaki süreyi bekleyip yeniden deneyin. |
| 429 | rate_limit_exceeded | İstek hızı limiti aşıldı. | {"error":{"message":"Too many requests — please try again shortly","type":"rate_limit_exceeded"}} | Retry-After başlığını bekleyin; üstel geri çekilme uygulayın. |
| 502 | upstream_error | Upstream’e ulaşılamadı. | {"error":{"message":"The model service is temporarily unreachable","type":"upstream_error"}} | Kısa bir süre sonra yeniden deneyin. |
| 503 | service_unavailable | Bakım modu veya upstream kimlik hatası. | {"error":{"message":"The system is temporarily unavailable. Please try again later.","type":"service_unavailable"}} | Durum sayfasını kontrol edin; bakım bitince yeniden deneyin. Durum sayfası → |
Gövdeler koddaki gerçek mesajlardır. Model adı ve istek kimliği örnektir.
Anthropic Messages (/v1/messages) hataları { type: "error", error: { type, message } } zarfında döner; HTTP durum kodları aynıdır. x-should-retry ve retry-after korunur.