Temel kılavuzlar
Günlükler ve sorun giderme
İstekleri, görevleri ve ücretlendirmeleri takip etmek için gereken kimlikleri saklayın
TokenLab istek, görev ve faturalandırma kimliklerini günlüklerinizde tutun. Bunlar, istemi veya özel medyayı saklamadan bir kullanıcı eylemini sonucu ve ücreti ile ilişkilendirir.
Console üzerinde, yakalanan istek ve yanıt detayları yakalandıktan sonra 30 gün boyunca kullanılabilir; fiziksel temizleme kuyrukta olsa bile erişim tam süre dolduğunda sona erer. İstek kimliği ile faturalandırma/kullanım geçmişi bağımsız yaşam sürelerine sahiptir. Bkz: Veri saklama.
Bir istekten incelemeye ve desteğe
-
İsteğin sahibi olan çalışma alanında Çalıştırmalar kısmını açın. İstek Kimliğini (Request ID) bulun ve satırı seçin.
-
Özel bir sayfa için Tüm detayları aç seçeneğini belirleyin. İsteklere geri dön seçeneği liste filtrelerini geri yükler. Bir bağlantı asla başka bir çalışma alanına erişim izni vermez; o çalışma alanı için yetkilendirilmiş bir hesap kullanın.
-
Bekleyen veya bilinmeyen durumlar için önce ilerleme durumunu yenileyin. Başarısız veya kesintiye uğramış bir yanıt için, mevcut olduğunda Sorunu incele seçeneğini belirleyin. Bu, uygulama içi Agent üzerinde o istek için bir inceleme başlatır; orijinal model isteğini tekrar oynatmaz. Başarılı istekler varsayılan olarak inceleme gerektirmez.
-
Hala yardıma ihtiyacınız varsa, istek veya inceleme üzerinden insan desteği eylemini seçin. Bu, mevcut olduğunda bağlantılı istek ve konuşmayı içeren bir önizleme açar. Özeti inceleyin, özel içerikleri kaldırın ve ardından açıkça Gönder seçeneğini belirleyin. Yalnızca bir inceleme veya önizleme bir destek talebi göndermez.
-
Gönderimden sonra, onay bilgisini saklayın ve aynı konuşmaya Destek üzerinden devam edin. Mükerrer gönderim yapmak yerine, yanıtlar ve ek bilgiler için aynı konuşmayı kullanın.
Saklanması gereken kimlikler
| Tanımlayıcı | Nerede görünür | Kullanım amacı |
|---|---|---|
request_id | Hata gövdeleri, dashboard günlükleri, kullanım kayıtları | İstek düzeyinde destek ve mutabakat |
id / task_id | Asenkron oluşturma ve durum yanıtları | GET /v1/tasks/{id} ile herhangi bir asenkron işi sorgulama |
poll_url | Asenkron oluşturma yanıtları | Durum URL'i; id ile /v1/tasks/{id} adresini sorgulayın |
billing_transaction_id | Tamamlandığında akış dışı yanıtlar, asenkron görev durum yanıtları, kullanım kayıtları, X-Billing-Transaction-ID | Maliyet mutabakatı |
X-Task-ID | Asenkron görev yanıt başlıkları | Başlık düzeyinde görev ilişkilendirme |
| Kendi iş/kullanıcı kimliğiniz | Uygulamanız | Bir kullanıcı eylemi için TokenLab isteğini bulma |
Müşteriye yönelik kayıtlarda TokenLab kimlikleri kullanılmalıdır. Asla özel servis URL'lerini, önbellek anahtarlarını veya tanısal meta verileri ifşa etmeyin.
Neler günlüğe kaydedilmeli
İsteği, sırları sızdırmadan teşhis etmek için yeterli bilgiyi günlüğe kaydedin:
- Uç nokta, HTTP metodu, model, durum kodu, zaman damgası ve gecikme süresi.
- Genel tanımlayıcılar: Mevcut olduğunda
request_id,task_id,poll_urlvebilling_transaction_id. - İsteğin içinde gönderilen alan adları; tam istem veya özel medya içeriği değil.
- Nihai asenkron durum yanıtları ve güvenli hata alanları.
- İstemci yeniden deneme sayısı ve yeniden denemenin yeni bir görev mi oluşturduğu yoksa mevcut bir görevi mi devam ettirdiği.
Açık izniniz olmadıkça Authorization, API anahtarları, yönetim token'ları, imzalı URL'ler, özel medya URL'leri, tam istemler ve kullanıcı kişisel verilerini her zaman maskeleyin.
Sorun giderme matrisi
| Belirti | İlk kontrol | Faydalı sayfa |
|---|---|---|
401 veya 403 | API anahtarı, yönetim token'ı, organizasyon erişimi, anahtar kapsamı | Kimlik Doğrulama |
402 | Bakiye, API anahtarı harcama limiti | Faturalandırma ve Fiyatlandırma |
429 | Hesap seviyesi, uç nokta hız sınırı, yeniden deneme davranışı | Hız Sınırları |
400 invalid_request_error | Desteklenmeyen alan, yanlış uç nokta, eksik zorunlu alan veya model isteği uyumsuzluğu | Hata Yönetimi |
| Asenkron görev bulunamıyor | Yanlış API anahtarı, hatalı yazılmış kimlik veya süresi dolmuş görev | Asenkron İşler ve Sorgulama |
| Maliyet arayüzle eşleşmiyor | Mutabakat zamanlaması veya yanlış tanımlayıcının karşılaştırılması | Faturalandırma ve Fiyatlandırma |
Kullanım mutabakatı
Sunucu tarafında mutabakat için Yönetim API'sini kullanın:
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
-H "Authorization: Bearer mt-your-management-token"GET /v1/management/api-keys/{keyId}/usage uç noktası scene, model, modelVendor, startDate ve endDate parametrelerine göre filtreleme yapabilir. Console sayfalarını kazımak veya ücretleri yalnızca yanıt token sayıları üzerinden hesaplamak yerine bu kayıtları kullanın. Sadece tarih içeren bir endDate, o günün başlangıcındaki 00:00 UTC anlamına gelir; bkz: API Anahtarı Kullanımını Al.
Akış yanıtları, akış gönderildikten sonra tamamlanabilir, bu nedenle kullanım daha sonra kaydedilse bile faturalandırma başlığı eksik olabilir. Asenkron medya görevleri, terminal sorgulamasından sonra tamamlanabilir.
Desteğe neler gönderilmeli
Destek ile iletişime geçerken şunları ekleyin:
request_id.- Asenkron işler için
task_idvepoll_url. - Mevcut olduğunda
billing_transaction_id. - Uç nokta, metod, model, zaman damgası ve durum kodu.
- İstek alan adları ve güvenli hata gövdesi.
- Beklediğiniz sonuç ve kullanıcının gerçekte gördüğü şey.
API anahtarları, yönetim token'ları, özel medya, tam istemler, özel servis URL'leri veya tanısal tanımlayıcıları dahil etmeyin. Destek bir istek örneğine ihtiyaç duyarsa, maskelenmiş bir kopyasını gönderin.
Otomatize etmeye değer kontroller
- Tekrarlayan
401,402,429ve5xxyanıtları için ayrı ayrı uyarı oluşturun; her biri farklı bir müdahale gerektirir. - Ürün SLA'nızdan daha uzun süre terminal olmayan (tamamlanmayan) asenkron işleri takip edin.
- Aynı kullanıcı iş kimliği için mükerrer oluşturma denemelerini takip edin.
- Tamamlanmış işlerden örneklem alın ve kullanıcı tarafından görülebilir varlığın, kullanım kaydının ve saklanan görev kaydının birbiriyle uyumlu olduğunu doğrulayın.
API Referansı
| Konu | Referans |
|---|---|
| Hata Yönetimi | Hata Yönetimi |
| Hız Sınırları | Hız Sınırları |
| Faturalandırma ve Fiyatlandırma | Faturalandırma ve Fiyatlandırma |
| API Anahtarı Kullanımını Al | API Anahtarı Kullanımını Al |
| Görev Durumunu Al | Görev Durumunu Al |