English
Türkçe
FrançaisYaygın hatalar
| Belirti | Olası sebep | Çözüm |
|---|---|---|
| 401 Invalid or revoked API key | Yanlış kopyalanmış, iptal edilmiş veya eksik key. | Header'ı kontrol et, API Keys sayfasında key durumuna bak, gerekiyorsa yeni key üret. |
| 403 (gate / suspended / unverified) | Askı, kapalı API erişimi, doğrulanmamış e-posta veya abonelik gereksinimi. | Hesap sayfasındaki uyarıları gider, planını kontrol et. |
| 404 model | Paneldeki görünen ad ile API ID'si farklı. | GET /v1/models yanıtındaki id alanını kullan. |
| 400 messages / input | Boş gövde veya dönüştürülemez girdi. | messages / input alanını ve JSON biçimini kontrol et. |
| 400 tool / unsupported_tools | Eşleşmemiş tool çifti veya kullanılamaz tool tanımı. | Assistant tool_calls ile tool sonucunu birlikte gönder; tool şemalarını sadeleştir. |
| 429 | RPM, kota veya eşzamanlılık sınırı. | reason ve Retry-After'a uy; kota ise pencereyi bekle. |
| 502 / 503 | Geçici upstream veya servis sorunu. | Süre bütçeli backoff ile tekrar dene; sürerse destek ile X-Request-ID'yi paylaş. |
| Stream yarım kesildi | Proxy buffering, kısa client timeout veya kopan bağlantı. | Buffering'i kapat, timeout'u büyüt, terminal olay gelmeden yanıtı tamamlama. |
| Yanlış protokol | Chat istemcisiyle Responses ucu veya tersi. | SDK baseURL'inin son segmentini kontrol et; agent rehberindeki ilgili sayfayı izle. |
Destek talebinde yanıttaki X-Request-ID header değerini, model ID'sini ve saat bilgisini ekle.