Documentation

Hatalar ve Sorun Giderme

Hız limitleri, yanıt başlıkları, yaygın API hataları ve önce denenecek en hızlı sorun giderme desenleri.

Hız limitleri

GateBeyz plan kademeleri istek ve eşzamanlılık limitlerini içerir. Kesin limitler, pilot aşamasında plana ve hesap durumuna göre değişebilir.

Yanıt başlıkları

Hız limiti başlıkları

http

x-ratelimit-tier: starter
x-ratelimit-limit-requests: 30
x-ratelimit-remaining-requests: 28
x-ratelimit-reset-requests: 2026-03-03T09:00:00.000Z
x-concurrent-limit: 2
x-concurrent-remaining: 3

Hata kodları

400 geçersiz gövde, 401 geçersiz veya eksik API anahtarı, 402 yetersiz bakiye, 403 WAF veya IP engeli, 429 hız sınırı aşıldı, 502/503/529 hizmet baskısı veya aşırı yük.

Sorun Giderme

Bazı OpenAI SDK varsayılanları ile 403

API uyumlu ortamlarda 403 hatası görüyorsanız, özel bir User-Agent ayarlayın.

Özel User-Agent

python

from openai import OpenAI

client = OpenAI(
    base_url='https://api.gatebeyz.xyz/v1',
    api_key='sk-gb-replace-with-your-key',
    default_headers={'User-Agent': 'GateBeyz/1.0'}
)

429 Çok Fazla İstek

Retry-After başlığını kontrol edin ve istek sıklığını veya eşzamanlılığını azaltın.

Bağlantı zaman aşımları

Birkaç saniye sonra tekrar deneyin. Hizmet geçici bir yük altında olabilir.

Değişim günlüğü

Mart 2026 — Responses API desteği, yeni GPT/Codex varyantları, daha iyi akış kullanımı raporlaması ve hesap araçları geliştirmeleri.

Şubat 2026 — OpenAI uyumlu uç nokta desteği ve model keşif geliştirmeleri.

Ocak 2026 — Gelişmiş düşünme desteği, yeni GPT/Gemini varyantları ve daha iyi kullanım görünürlüğü.