Yönetim API'si

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Genel Bakış

Management API, normal bir inference API anahtarı kullanmadan kuruluş bakiyesi toplamlarını almanızı, kuruluş API anahtarlarını yönetmenizi ve belirli bir anahtar için kullanım ve faturalama bilgilerini almanızı sağlar. Panodaki Ayarlar sayfasından bir yönetim tokenı kullanın:

Authorization: Bearer mt-your-management-token

Yönetim token’ları inference API anahtarlarından farklıdır. /v1/management/* için mt-..., /v1/responses gibi model inference endpoint’leri için sk-... kullanın.

Kullanılabilir uç noktalar

Uç nokta	Yöntem	Açıklama
`/v1/management/balance`	GET	Geçerli kuruluş bakiyesi toplamlarını getir
`/v1/management/api-keys`	GET	Geçerli kuruluştaki kullanıcı yönetimli API anahtarlarını listele
`/v1/management/api-keys`	POST	Yeni bir kullanıcı API anahtarı oluştur
`/v1/management/api-keys/{keyId}`	PATCH	Adı, kullanım limitini, izinli modelleri, son kullanım tarihini veya durumu güncelle
`/v1/management/api-keys/{keyId}/usage`	GET	Belirli bir anahtar için sayfalı kullanım detaylarını getir
`/v1/management/api-keys/{keyId}/billing`	GET	Belirli bir anahtar için toplulaştırılmış faturalama dökümünü getir

Usage Filtre Sözleşmesi

GET /v1/management/api-keys/{keyId}/usage aşağıdaki query parametrelerini destekler:

Parametre	Tür	Varsayılan / Sınırlar	Notlar
`page`	integer	varsayılan `1`, minimum `1`	1’den başlayan sayfa numarası
`limit`	integer	varsayılan `50`, minimum `1`, maksimum `100`	Sayfa boyutu
`model`	string	azami uzunluk `100`	İstenen model adı
`modelVendor`	string	azami uzunluk `100`	Herkese açık model sağlayıcısı
`scene`	enum	-	`chat`, `image`, `audio`, `video`, `embedding`, `rerank`, `translation`, `music`, `3d`, `realtime`
`startDate`	string	-	Dahil alt sınır; timezone’lu RFC3339 veya `YYYY-MM-DD` kabul eder
`endDate`	string	-	Dahil üst sınır; timezone’lu RFC3339 veya `YYYY-MM-DD` kabul eder

Hem startDate hem endDate varsa, startDate endDate’den küçük ya da eşit olmalıdır.

API Anahtarı Body Sözleşmesi

POST /v1/management/api-keys

Alan	Tür	Varsayılan / Sınırlar	Notlar
`name`	string	zorunlu, varsayılan `Default Key`, uzunluk `1-50`	Görünen ad, sunucu tarafında baştaki ve sondaki boşluklar kaldırılır
`limitAmount`	number \| null	minimum `0`, girdi üst sınırı `1000000`	`null` veya atlanırsa = limitsiz, `0` = sıfır kota. Pozitif değerler `100000` USD eşdeğerini aşamayacak şekilde depolama limiti olarak normalize edilir
`limitCurrency`	enum	varsayılan `USD`	Yalnızca USD. `CNY` gönderildiğinde `400 currency_retired` döner.
`models`	string[]	varsayılan `[]`	Opsiyonel model allowlist’i
`expiresAt`	string \| null	RFC3339 datetime	`null` son kullanma olmadığı anlamına gelir

PATCH /v1/management/api-keys/

Alan	Tür	Varsayılan / Sınırlar	Notlar
`status`	enum	-	`active`, `inactive`, `revoked`
`name`	string	uzunluk `1-50`	Güncellenmiş görünen ad
`limitAmount`	number \| null	minimum `0`, girdi üst sınırı `1000000`	`null` = limitsiz, `0` = sıfır kota. Pozitif değerler `100000` USD eşdeğerini aşamayacak şekilde normalize edilir
`limitCurrency`	enum	varsayılan `USD`	Yalnızca USD. `CNY` gönderildiğinde `400 currency_retired` döner.
`models`	string[]	-	Güncellenmiş model allowlist’i
`expiresAt`	string \| null	RFC3339 datetime	`null` son kullanmayı kaldırır

PATCH için en az bir alan verilmelidir.

Parasal alanlar

Yönetim API’sinin parasal istek ve yanıt alanları yalnızca USD’yi destekler.
limitCurrency varsayılan olarak USD kullanır; CNY gönderildiğinde 400 currency_retired döndürülür.

Raporlama Anlamı

model, çağıranın talep ettiği herkese açık modeli ifade eder.
modelVendor, gizli fiziksel route yerine herkese açık model sağlayıcısını ifade eder.
scene, endpoint veya görev türünden türetilen herkese açık istek sahnesidir.

Yanıtlar yalnızca herkese açık faturalama ve raporlama alanlarını gösterir. Provider execution ayrıntıları public yönetim sözleşmesinin parçası değildir.

/usage satır öğeleri, alttaki istek settlement edilmiş billing durumuna ulaştığında billing_transaction_id içerebilir. İstek düzeyinde mutabakat için request_id + billing_transaction_id kullanın.

Faturalama Sayfalama Notu

/usage sayfalanır. /billing şu anda toplulaştırılmış bir breakdown endpoint’idir ve page / limit tarzı sayfalama metadata’sı döndürmez. Satır düzeyinde kayıtlara ihtiyacınız varsa /usage kullanın.

Hızlı Örnek

Önce mevcut yönetim token’ı ile kuruluş bakiyesini kontrol edin:

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Ardından aynı yönetim token’ı için erişilebilir API anahtarlarını listeleyin:

curl "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Temel

Metin

Dosyalar ve toplu işler

Görseller

Ses ve gerçek zamanlı

Müzik

Video ve materyaller

Worlds

3D

Asenkron işler

Gemini yerel

Yönetim

Genel Bakış

Kullanılabilir uç noktalar

Usage Filtre Sözleşmesi

API Anahtarı Body Sözleşmesi

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Parasal alanlar

Raporlama Anlamı

Faturalama Sayfalama Notu

Hızlı Örnek

Sonraki Adımlar

​Genel Bakış

​Kullanılabilir uç noktalar

​Usage Filtre Sözleşmesi

​API Anahtarı Body Sözleşmesi

​POST /v1/management/api-keys

​PATCH /v1/management/api-keys/

​Parasal alanlar

​Raporlama Anlamı

​Faturalama Sayfalama Notu

​Hızlı Örnek

​Sonraki Adımlar

Genel Bakış

Kullanılabilir uç noktalar

Usage Filtre Sözleşmesi

API Anahtarı Body Sözleşmesi

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Parasal alanlar

Raporlama Anlamı

Faturalama Sayfalama Notu

Hızlı Örnek

Sonraki Adımlar