Sorun giderme

Belirtiyle başlayın, ardından çözümü izleyin. Arızaların çoğu temel URL, anahtar, model kimliği veya bakiyeden kaynaklanır.

Belirti odaklı tablo

Kimlik Doğrulama

İptal edilmiş bir anahtar, anahtar önekini belirten bir mesaj döndürür:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "API Key has been revoked (keyPrefix=...)"
}

Kontrol listesi:

• Model API ve Felo API'leri için başlık Authorization: Bearer <key> biçimindedir.
• Data API ayrıca X-API-Key: <key> kabul eder.
• Anahtar tırnak içine alınmamıştır ve kopyalanan bir ortam değişkeninden gelen sondaki yeni satır yoktur.
• Dağıtılan ortamda değişken gerçekten tanımlıdır; yerelde çalışan bir anahtar üretimde eksik olabilir.
• Anahtar silinmemiş veya döndürülmemiştir. Silinen veya döndürülen bir anahtar yeniden gösterilemez; yeni bir anahtar oluşturun.

Anahtar oluşturma ve sınırlar için bkz. Kimlik Doğrulama.

Temel URL tuzakları

İki yaygın hata:

1. SDK'nın zaten genişlettiği bir temel URL'ye /chat/completions eklemek.
2. Anthropic temel URL'sini https://openapi.felo.ai/api/v1 olarak ayarlamak. SDK /v1/messages ekler, böylece istek /api/v1/v1/messages olur.

Model kimliği sorunları

Model kimlikleri, upstream sağlayıcının dahili adları veya görünen ad değil, katalogdaki genel kimliklerdir.

• Kimliği modeller sayfasında veya GET /api/v1/models içinde arayın.
• Modelin çağırdığınız protokolü desteklediğini doğrulayın (supported_protocols).
• Bir kanal sabitlediyseniz, o kanalın bu model için yayımlanmış ve çalıştırılabilir olduğunu doğrulayın. Kullanılamayan bir kanal geri dönüş değildir.

Bkz. Kanallar ve Sağlayıcı Yönlendirme.

Akış sorunları

• stream: true ayarını sorgu parametresi olarak değil, istek gövdesinde yapın.
• Yanıt gövdesini bir akış olarak okuyun. Tam yanıtı beklemek akışın amacını bozar.
• Bazı proxy'ler ve sunucusuz platformlar yanıtları arabelleğe alır. İsteği proxy'leyen rota için arabelleğe almayı devre dışı bırakın.
• Chat Completions, choices[0].message değil choices[0].delta akıtır. Nihai içerik birçok parça boyunca gelir.
• Bağlantı düşerse bir akış temiz bir nihai olay olmadan bitebilir. Düşen bir bağlantıyı eksik yanıt olarak değerlendirin.

Eşzamansız görev sorunları

• Görev ailesine ait olan durum endpoint'ini yoklayın. Felo iş akışları GET /v2/tasks/{task_id}/status kullanır; model video ve görsel görevleri kendi oluşturma endpoint'lerini kullanır.
• Yalnızca başarıda değil, arızalar ve süre dolmaları dahil her nihai durumda durun.
• Video ve görsel geri çağırmaları şu anda yok sayılır. Bir webhook beklemeyin.
• Bir sonuç URL'si kısa ömürlü olabilir. Bir indirme süresi dolarsa durum endpoint'inden yeni bir URL isteyin.
• Yeniden göndermeden önce görevi kontrol edin. Çalışan bir görevi yeniden göndermek bir kopya oluşturur ve ikisi de faturalandırılır.

Bkz. Eşzamansız Görevler.

Data API sorunları

• Data API referansındaki tam yöntem yolunu koruyun.
• İstek gövdeleri sağlayıcıya özgüdür. Bir sağlayıcı için çalışan bir alanın başka biri için çalışacağı garanti değildir.
• Bir sağlayıcı hatası, sağlayıcıya özgü bir mesajla 4xx yanıtı içinde gelebilir. request_id ve yanıt gövdesini günlüğe kaydedin.

Güvenlik hatırlatmaları

• Bir API anahtarını asla tarayıcı koduna, mobil uygulama paketine veya herkese açık bir depoya koymayın. Sunucuda tutun ve istekleri proxy'leyin.
• Tam anahtarı günlüğe kaydetmeyin. Tanımlamanız gerekiyorsa bir önek kaydedin.
• Sızmış olabilecek bir anahtarı hemen döndürün.

Destekle iletişime geçmeden önce

Şunları toplayın:

1. Endpoint ve HTTP yöntemi.
2. HTTP durumu, code ve request_id.
3. Model kimliği veya görev kimliği.
4. Saat dilimiyle birlikte zaman damgası.
5. Gizli bilgiler çıkarılmış minimal bir istek gövdesi.

Bunu hesap e-postasıyla birlikte desteğe gönderin. Tam API anahtarını eklemeyin.

İlgili

• Hatalar, Sınırlar ve Yeniden Denemeler
• Protokoller ve SDK'lar
• Faturalandırma ve Krediler
• Kimlik Doğrulama