Sorun giderme

Gördüğünüz duruma uyan belirtiyi izleyin. Neredeyse her durumda en hızlı tanılama aracı Logs sekmesidir: her isteğin durumunu ve hata desenini (tek bir anahtar mı? tek bir model mi? her şey mi?) gösterir. Bkz. Etkinlik ve kayıtlar.

İstekler engelleniyor

Her istek 402 insufficient_credits hatasıyla başarısız oluyor

Neden: modül bu tesis için etkinleştirilmemiştir veya ön ödemeli bakiye tükenmiştir (Overview sekmesi "Bakiyeniz tükendi. Bakiye yükleyene kadar çıkarım istekleri engellenecek." uyarısını gösterir). API anahtarları için, Model Router'ın etkinleştirilmediği bir tesis bunun yerine 403 "Model Router bu tesis için etkinleştirilmemiş" yanıtını döndürür.

Çözüm: Model Router'ı Welcome to Model Router sayfasından etkinleştirin (bkz. Başlarken), ardından Budgets & Limits → Balance & Top-up bölümünden bakiye yükleyin. Bakiye hesaba geçtikten birkaç saniye sonra istekler yeniden işlenmeye başlar. Sorunun tekrarlanmasını önlemek için otomatik bakiye yüklemeyi etkinleştirin. Bkz. Bütçeler ve bakiye yükleme.

İstekler 402 budget_exceeded hatasıyla başarısız oluyor

Neden: bir harcama limitine ulaşılmıştır. Hata mesajı hangi dönemin (günlük / aylık / ömür boyu) söz konusu olduğunu ve günlük ile aylık limitler için tesisinizin saat diliminde tam olarak ne zaman sıfırlanacağını belirtir. Bu, hesap genelindeki limit olabileceği gibi belirli bir anahtarın veya bağlı hizmetin limiti de olabilir (kapsamlı olduğunda mesajda "Bu anahtarın" / "Bu ajanın" ifadesi yer alır).

Çözüm: belirtilen sıfırlamayı bekleyin, limiti yükseltin (Budgets & Limits → Spend Limits ya da anahtarın veya hizmetin yapılandırması) veya ömür boyu kesin üst sınır için Reset hard cap seçeneğini kullanın. Spend Limits sayfası, hangi limitlerin "Limit reached" durumunda olduğunu tam olarak gösterir.

İstekler 403 content_policy_violation hatasıyla başarısız oluyor

Neden: istem, block modundaki bir içerik filtresiyle veya istem enjeksiyonu kalkanıyla eşleşmiştir.

Çözüm: Settings → Guardrails bölümünü gözden geçirin. Bir entegrasyonun gerçekten farklı kurallara ihtiyacı varsa tesis genelindeki politikayı gevşetmek yerine o entegrasyonun Override facility guardrails anahtarını kullanın. Bkz. Guardrails.

İstekler 429 hatasıyla başarısız oluyor

Neden: anahtar veya bağlı hizmet, Requests / min veya Tokens / min hız limitini aşmıştır.

Çözüm: bir süre bekleyip yeniden deneyin veya anahtarın ya da hizmetin yapılandırmasındaki hız limitlerini yükseltin (boş = sınırsız). Bkz. API anahtarları.

Belirli bir model hata döndürüyor, diğerleri çalışıyor

Neden: model tesisiniz için devre dışı bırakılmış, anahtarın model kısıtlamasıyla hariç tutulmuş olabilir ya da sağlayıcı sorun yaşıyor olabilir.

Çözüm: Settings → Models bölümünü (model etkin mi?), anahtarın Restrict models listesini ve modelin zaman içindeki hata oranı için Activity → Performance → Reliability & performance by model bölümünü kontrol edin.

API anahtarı sorunları

401 Unauthorized

Neden: invalid_api_key koduyla ("API anahtarı eksik veya geçersiz") birlikte döndüyse Authorization: Bearer … üst bilgisi eksik veya hatalı biçimlendirilmiştir. Kod olmadan ("Geçersiz API anahtarı") döndüyse anahtar tanınmıyordur (yanlış yazılmıştır veya rotate işleminden sonra kalan eski bir gizli anahtardır) ya da iptal edilmiştir.

Çözüm: üst bilgi biçimini doğrulayın; anahtarın durumunu Settings → Service Access & API Keys bölümünden kontrol edin. İptal edilmiş bir anahtarı yeniden etkinleştirin veya anahtar yenilendiyse hizmetinizi yeni gizli anahtarla güncelleyin.

Anahtarın gizli değerini kaybettim

Gizli değer yalnızca oluşturma sırasında bir kez gösterilir ve kurtarılamaz. Rotate seçeneğini kullanın: yeni bir gizli değer verilir (bir kez gösterilir) ve anahtar etiketini, limitlerini ve geçmişini korur. Anahtarı kullanan her hizmeti güncelleyin: "Eski anahtarı kullanmaya devam eden tüm hizmetleri yeniden yapılandırmanız gerekecek."

Anahtar çalışıyor ancak kullanım yanlış ad altında görünüyor

Anahtarlar Activity ve Logs bölümlerinde Label değerleriyle tanımlanır. Anahtarı düzenleyip anlamlı bir etiket belirleyin; tek bir anahtarı paylaştırmak yerine her sisteme kendi anahtarını verin.

Ajan sorunları

Bir ajan Offline görünüyor

Neden: cihaz kapalıdır veya bağlantısı yoktur. Bu bir Model Router ayarı değil, cihaz bağlantısıyla ilgili bir durumdur.

Çözüm: cihazın gücünü ve ağını kontrol edin. Erişim yapılandırması etkilenmez ve cihaz yeniden bağlanır bağlanmaz tekrar çalışır.

Bir ajan yapay zeka isteklerine yanıt vermeyi bıraktı

Sırasıyla kontrol edin:

1. Bakiye: tükenmiş bir bakiye tüm ajanları engeller (ajan, kredi gerektiğini belirten bir durum gösterir). Bakiye yükleyin.
2. Hizmet başına limitler: Settings → Service Access & API Keys → Connected Services: ajan "Limit reached" durumunu gösteriyor mu? Limiti yükseltin veya sıfırlanmasını bekleyin.
3. Hesap limitleri: Budgets & Limits → Spend Limits.
4. Kayıtlar: isteklerindeki asıl hatayı görmek için ajana göre filtreleyin.

Bakiye ve faturalandırma soruları

Harcama rakamları geriden geliyor gibi görünüyor

Available balance ve Spent today rakamları canlıdır. Monthly usage her 15 dakikada bir bakiyenizle mutabık kılınır; bu nedenle çok yeni harcamaların orada görünmesi birkaç dakika sürebilir. İşlem geçmişi yalnızca bakiye yüklemelerini ve bakiye düzeltmelerini listeler; bu nedenle kullanım burada hiçbir zaman görünmez.

Otomatik bakiye yükleme çalışmadı

Balance & Top-up sayfasında bir başlık uyarısı olup olmadığını kontrol edin: kayıtlı kart yok, kart için kimlik doğrulama gerekiyor veya kart reddedildi. Kartı düzeltin (Update card / Edit payment details) veya bakiyeyi manuel olarak yükleyin. Otomatik bakiye yükleme kontrolleri yaklaşık her 15 dakikada bir çalışır; bu nedenle eşiğin yeni aşılmış olması durumunda yüklemenin tetiklenmesi birkaç dakika sürebilir.

Bir bakiye yükleme başarısız oldu

"Ek kart kimlik doğrulaması gerekiyor. Lütfen yeniden deneyin.": yeniden deneyin; bankanız doğrulama isteyebilir. "Bakiye yükleme tamamlanamadı.": ödeme reddedilmiştir; kartı kontrol edin veya başka bir tutar deneyin. Ödeme başarılı olmadıkça hiçbir kredi uygulanmaz.

Ücret alındı ancak bakiye değişmedi

Bakiye yüklemeleri anında hesaba geçer; sayfayı yenileyin. Bakiye başarılı bir ödemeyi hâlâ yansıtmıyorsa işlemin ayrıntılar panelinden (veya kart ekstrenizden) Transaction ID ve Payment reference değerlerini not edin ve bir destek talebi oluşturun.

Kayıtlar ve analiz soruları

Az önce yaptığım bir istek henüz Logs bölümünde yok

Live yenilemeyi açın (veya Refresh now seçeneğine tıklayın). İstekler normalde birkaç saniye içinde görünür; yük altında bu biraz daha uzun sürebilir.

Kayıtlarda istemediğim bir model görünüyor

model: "auto" gönderdiyseniz kayıtlar, Auto Router'ın çözümlediği modeli gösterir; Requested model: auto değerini görmek için isteğin ayrıntılarını açın. Bu beklenen bir davranıştır. Bkz. Modeller.

Satırlarda "No charge" görünüyor

Hiçbir maliyeti olmayan başarısız veya boş yanıtlar No charge etiketiyle işaretlenir; eksiksizlik için kaydedilirler ancak bakiyeden düşmezler.

CSV dışa aktarımım beklenenden küçük

Ham dışa aktarımlar 25.000 satırla sınırlıdır; tarih aralığını daraltın veya özet dışa aktarımı kullanın. Ayrıca şunu unutmayın: "Özetler tam günleri kapsar; bu nedenle gün içi veya grafik üzerinden yapılan bir seçim tam günlere genişletilir."