Yönetim
Yönetim API'si
Workspace bakiyelerini kontrol edin, API key'lerini yönetin ve kullanım ile faturalandırma bilgilerini alın
Bir TokenLab Workspace'ini yönetmek için kendi backend'inizden veya otomasyonunuzdan Management API'yi kullanın. Bir management token kullanır, bu nedenle programın normal bir API key'ine ihtiyacı yoktur.
Dashboard → API → Management Tokens bölümünde bir management token oluşturun:
Authorization: Bearer mt-your-management-tokenManagement token'ları ve API key'leri farklı rollere sahiptir. mt-... değerini yalnızca /v1/management/* ile kullanın. sk-... değerini /v1/responses gibi model API'leri ile kullanın.
Endpoint'ler
| Endpoint | Yöntem | Kullanım |
|---|---|---|
/v1/management/balance | GET | Workspace bakiyesini alın |
/v1/management/api-keys | GET | API key'lerini listeleyin |
/v1/management/api-keys | POST | Bir API key oluşturun |
/v1/management/api-keys/{keyId} | PATCH | Adını, limitini, modellerini, son kullanma tarihini veya durumunu değiştirin |
/v1/management/api-keys/{keyId}/usage | GET | Bireysel kullanım kayıtlarını alın |
/v1/management/api-keys/{keyId}/billing | GET | Faturalandırma özetini alın |
API Key'leri
- Yeni bir key'in tam secret değeri yalnızca oluşturma yanıtında görünür.
models: [], key düzeyinde herhangi bir model kısıtlaması eklemez.limitAmount: nullsınırsız anlamına gelir.0, key'in harcama yapmasını engeller.- Tutarlar USD kullanır.
CNYgöndermek400 currency_retireddöndürür. inactivetekrar etkinleştirilebilir. Bir key'i kalıcı olarak kullanımdan kaldırmak içinrevokedkullanın.
Kullanım ve Faturalandırma
/usage sayfalandırılmış kayıtlar döndürür ve model, model maker, scene ve tarih filtrelerini destekler. Sonuçlandırılmış kayıtlar billing_transaction_id içerebilir; bir ücretlendirmeyi bir istekle eşleştirmeniz gerektiğinde bunu request_id ile birlikte kaydedin.
/billing, model, model maker, scene ve tarihe göre gruplandırılmış toplamları döndürür. Workspace bakiye yüklemelerini veya faturalarını içermez.
2026-07-31 gibi yalnızca tarih içeren bir endDate, o günün başlangıcındaki 00:00 UTC anlamına gelir. Tüm günü dahil etmek için bir sonraki tarihi veya 2026-07-31T23:59:59Z gibi bir RFC3339 zamanını iletin.
Hatalar
Hatalar standart error nesnesini kullanır. Bunları duruma ve code değerine göre ele alın.
| Durum | code | Anlamı |
|---|---|---|
| 400 | validation_error | Bir alan veya sorgu parametresi geçersiz |
| 400 | invalid_model_access | models içindeki bir modele Workspace'in model politikası tarafından izin verilmiyor |
| 400 | currency_retired | limitCurrency değeri CNY; USD kullanın |
| 401 | invalid_management_token | Token eksik, hatalı biçimlendirilmiş veya iptal edilmiş |
| 403 | organization_inactive | Workspace aktif değil |
| 404 | not_found | API key bu Workspace'te bulunmuyor |
| 409 | api_key_revoked | İptal edilen bir key yeniden etkinleştirilemez; yeni bir key oluşturun |
| 429 | report_busy | Çok fazla kullanım veya faturalandırma raporu çalışıyor. Retry-After saniyesinden sonra tekrar deneyin |
Örnek
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"