Bağlantı ve kullanım

Çağrı başarısız olduğunda veya konuşma kesildiğinde, önce en küçük istekle üç şeyi doğrulayın: kimlik doğrulama, uç nokta yolu ve model kullanılabilirliği.

Platforma bağlanamıyor musunuz?

Şunları kontrol edin:

• Anahtar doğru mu, fazladan boşluk veya satır sonu var mı?
• Base URL doğru mu, yinelenen yol var mı?
• Uç nokta yolu istemci protokolüne uyuyor mu; örneğin OpenAI istemcisi için OpenAI uyumlu yol kullanılıyor mu?
• Yerel ağ, şirket vekili, güvenlik duvarı, DNS veya HTTPS denetimi istekleri engelliyor mu?
• Anahtarın süresi dolmuş mu, silinmiş mi veya kısıtlı hesaba mı ait?

OpenAI uyumlu çağrılarda en küçük akışsız istekle deneyin:

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

En küçük istek başarısızsa sorun genellikle ağ, kimlik doğrulama, yol ayarı, model izinleri veya hesap durumundadır.

Model seçili ama yanıt yok ya da hata mı var?

Yaygın nedenler:

• Model ID’si yanlış veya platform listesiyle eşleşmiyor.
• Model geçici olarak kullanılamıyor veya anahtara izin verilmiyor.
• Yanlış alan adı, iç içe yapı veya tür gibi nedenlerle istek biçimi geçersiz.
• Bakiye yetersiz, bağlam veya çıktı çok uzun ya da hizmet zaman aşımına uğradı.
• Üçüncü taraf istemci akış veya hata yanıtlarını doğru işlemiyor.

Tam model ID’sini konsoldan veya listeden kopyalayın, en küçük gövdeyle deneyin ve bağlam ile parametreleri kademeli ekleyin.

Sohbet hata verirse veya bağlantı kesilirse ne yapmalıyım?

Hatanın yerini belirleyin:

• İstek başlamadan önce: kimlik doğrulama, yol, model ve parametreleri kontrol edin.
• Akış sırasında: istemci zaman aşımı, vekil zinciri ve SSE ayrıştırmasını kontrol edin.
• Uzun bağlam veya çıktıda: istek boyutu, çıktı sınırları ve hizmet zaman aşımını kontrol edin.

Önerilen yaklaşım:

1. Belirli hata alanlarını okuyun.
2. Model hatasıyla akış ayrıştırma hatasını ayırmak için geçici olarak akışsız kullanın.
3. 429, ağ kararsızlığı ve bazı 5xx hataları için gecikmeli yeniden deneme ekleyin.
4. Sunucuda konuşma durumu olduğunu varsaymak yerine yeniden denemelere gerekli bağlamı ekleyin.
5. Sorun sürerse X-Request-ID kaydedin.