Yakalanması Gereken Kamuya Açık Tanımlayıcılar
| Tanımlayıcı | Nerede Görünür | Kullanım Amacı |
|---|---|---|
request_id | Hata gövdesi, gösterge paneli logları, kullanım kayıtları | Talep düzeyinde destek ve uzlaştırma |
id / task_id | Asenkron oluşturma ve durum yanıtları | Görüntü, video, müzik ve 3D işlerini anketleme |
poll_url | Asenkron oluşturma yanıtları | Tercih edilen durum URL’si |
billing_transaction_id | Yerleştiğinde akış dışı yanıtlar, asenkron görev durum yanıtları, kullanım kayıtları, X-Billing-Transaction-ID | Maliyet uzlaştırması |
X-Task-ID | Asenkron görev yanıt başlıkları | Başlık düzeyinde görev korelasyonu |
| Kendi işiniz/kullanıcı ID’niz | Uygulamanız | TokenLab etkinliğini kullanıcı iş akışına bağlama |
Ne Kaydedilmeli
İsteği teşhis etmek için yeterince log kaydedin, sırları sızdırmadan:- Uç nokta, HTTP yöntemi, model, durum kodu, zaman damgası ve gecikme.
- Kamuya açık tanımlayıcılar:
request_id,task_id,poll_urlvebilling_transaction_idmevcutsa. - Sanitize edilmiş istek şekli: hangi alanların mevcut olduğu, tam istem veya özel medya içeriği değil.
- Terminal asenkron durum yanıtları, kamuya açık hata alanları dahil.
- İstemci tekrar sayısı ve tekrarın yeni bir görev oluşturup oluşturmadığı veya mevcut birini devam ettirip ettirmediği.
Authorization, API anahtarları, yönetim tokenları, imzalı URL’ler, özel medya URL’leri, tam istemler ve kullanıcı kişisel verilerini saklamaktan kaçının, aksi takdirde bunları saklamak için açık izin almadığınız sürece.
Hata Ayıklama Matrisi
| Belirti | İlk Kontrol | Yararlı Sayfa |
|---|---|---|
401 veya 403 | API anahtarı, yönetim tokenı, organizasyon erişimi, anahtar kapsamı | Kimlik Doğrulama |
402 | Bakiye, API anahtarı harcama limiti, model fiyatı durumu | Faturalama & Fiyatlandırma |
429 | Hesap katmanı, uç nokta hız limiti, tekrar davranışı | Hız Limitleri |
400 invalid_request_error | Desteklenmeyen alan, yanlış uç nokta, gerekli alanın eksikliği veya model sözleşmesi uyuşmazlığı | Hata Yönetimi |
| Asenkron görev bulunamıyor | Yanlış API anahtarı, eski görev ID’si, süresi dolmuş görev veya kamuya açık olmayan görev ID’si | Asenkron İşler & Anketleme |
| Maliyet UI ile eşleşmiyor | Yerleşim zamanlaması veya yanlış tanımlayıcıyı karşılaştırma | Faturalama & Fiyatlandırma |
Kullanım Uzlaştırması
Sunucu tarafı uzlaştırması için Yönetim API’sini kullanın:GET /v1/management/api-keys/{keyId}/usage scene, accessChannel, logicalModel, modelVendor, startDate ve endDate ile filtreleme yapabilir. Bu kayıtları gösterge paneli sayfalarını kazımak veya yukarı akış sağlayıcı görev ID’lerine güvenmek yerine kullanın.
Akış yanıtları, akış gönderildikten sonra yerleşebilir, bu nedenle kullanım daha sonra kaydedilse bile bir faturalama başlığı mevcut olmayabilir. Asenkron medya görevleri, terminal anketlemesinden sonra yerleşebilir.
Destek Paketi Şablonu
Destekle iletişime geçerken şunları dahil edin:request_id.- Asenkron işler için
task_idvepoll_url. - Mevcutsa
billing_transaction_id. - Uç nokta, yöntem, model, zaman damgası ve durum kodu.
- Sanitize edilmiş istek şekli ve kamuya açık hata gövdesi.
- Beklenen sonucunuzu ve kullanıcının gerçekten gördüğünü.
Operasyonel Kontroller
- Tekrar eden
401,402,429ve5xxyanıtları için ayrı olarak uyarı verin; genellikle farklı sahipleri vardır. - Ürün SLA’nızdan daha uzun süre terminal olmayan asenkron işleri takip edin.
- Aynı kullanıcı iş ID’si için tekrar eden oluşturma girişimlerini takip edin.
- Tamamlanan işleri örnekleyin ve kullanıcıya görünür varlık, kullanım kaydı ve saklanan görev kaydının uyumlu olduğunu doğrulayın.
API Referansı
| Konu | Referans |
|---|---|
| Hata Yönetimi | Hata Yönetimi |
| Hız Limitleri | Hız Limitleri |
| Faturalama & Fiyatlandırma | Faturalama & Fiyatlandırma |
| API Anahtarı Kullanımını Al | API Anahtarı Kullanımını Al |
| Görev Durumunu Al | Görev Durumunu Al |