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

  1. İ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.

  2. Ö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.

  3. 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.

  4. 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.

  5. 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ürKullanım amacı
request_idHata gövdeleri, dashboard günlükleri, kullanım kayıtlarıİstek düzeyinde destek ve mutabakat
id / task_idAsenkron oluşturma ve durum yanıtlarıGET /v1/tasks/{id} ile herhangi bir asenkron işi sorgulama
poll_urlAsenkron oluşturma yanıtlarıDurum URL'i; id ile /v1/tasks/{id} adresini sorgulayın
billing_transaction_idTamamlandığında akış dışı yanıtlar, asenkron görev durum yanıtları, kullanım kayıtları, X-Billing-Transaction-IDMaliyet mutabakatı
X-Task-IDAsenkron görev yanıt başlıklarıBaşlık düzeyinde görev ilişkilendirme
Kendi iş/kullanıcı kimliğinizUygulamanızBir 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_url ve billing_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 kontrolFaydalı sayfa
401 veya 403API anahtarı, yönetim token'ı, organizasyon erişimi, anahtar kapsamıKimlik Doğrulama
402Bakiye, API anahtarı harcama limitiFaturalandırma ve Fiyatlandırma
429Hesap seviyesi, uç nokta hız sınırı, yeniden deneme davranışıHız Sınırları
400 invalid_request_errorDesteklenmeyen alan, yanlış uç nokta, eksik zorunlu alan veya model isteği uyumsuzluğuHata Yönetimi
Asenkron görev bulunamıyorYanlış API anahtarı, hatalı yazılmış kimlik veya süresi dolmuş görevAsenkron İşler ve Sorgulama
Maliyet arayüzle eşleşmiyorMutabakat 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_id ve poll_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, 429 ve 5xx yanı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ı

KonuReferans
Hata YönetimiHata Yönetimi
Hız SınırlarıHız Sınırları
Faturalandırma ve FiyatlandırmaFaturalandırma ve Fiyatlandırma
API Anahtarı Kullanımını AlAPI Anahtarı Kullanımını Al
Görev Durumunu AlGörev Durumunu Al

Bu sayfada