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-token

Management 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

EndpointYöntemKullanım
/v1/management/balanceGETWorkspace bakiyesini alın
/v1/management/api-keysGETAPI key'lerini listeleyin
/v1/management/api-keysPOSTBir API key oluşturun
/v1/management/api-keys/{keyId}PATCHAdını, limitini, modellerini, son kullanma tarihini veya durumunu değiştirin
/v1/management/api-keys/{keyId}/usageGETBireysel kullanım kayıtlarını alın
/v1/management/api-keys/{keyId}/billingGETFaturalandı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: null sınırsız anlamına gelir. 0, key'in harcama yapmasını engeller.
  • Tutarlar USD kullanır. CNY göndermek 400 currency_retired döndürür.
  • inactive tekrar etkinleştirilebilir. Bir key'i kalıcı olarak kullanımdan kaldırmak için revoked kullanı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.

DurumcodeAnlamı
400validation_errorBir alan veya sorgu parametresi geçersiz
400invalid_model_accessmodels içindeki bir modele Workspace'in model politikası tarafından izin verilmiyor
400currency_retiredlimitCurrency değeri CNY; USD kullanın
401invalid_management_tokenToken eksik, hatalı biçimlendirilmiş veya iptal edilmiş
403organization_inactiveWorkspace aktif değil
404not_foundAPI key bu Workspace'te bulunmuyor
409api_key_revokedİptal edilen bir key yeniden etkinleştirilemez; yeni bir key oluşturun
429report_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"

Sonraki Adımlar

Bu sayfada