Yönetim
Yönetim API'si
Yönetim tokenıyla kuruluş bakiyesini, API anahtarlarını ve key düzeyinde kullanım/faturalandırmayı yönetin.
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.
Dashboard → API → Management Tokens bölümünden bir yönetim tokenı oluşturun:
Authorization: Bearer mt-your-management-tokenYö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 | isteğe bağlı, 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 | string | null | 0–100000 USD | null sınırsız anlamına gelir; 0 harcamayı engeller. Ondalık dizeler en fazla 6 ondalık basamak destekler. Anahtar oluştururken bu alanı atlamak sınırsız anlamına gelir. |
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 |
deliveryPolicy | string | null | auto, verified, official, null | null, çalışma alanının teslim politikasını devralır. |
expiresAt | string | null | RFC3339 datetime | null son kullanma olmadığı anlamına gelir |
PATCH /v1/management/api-keys/{keyId}
| 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 | string | null | 0–100000 USD | null sınırsız anlamına gelir; 0 harcamayı engeller. Ondalık dizeler en fazla 6 ondalık basamak destekler. |
limitCurrency | enum | varsayılan USD | Yalnızca USD. CNY gönderildiğinde 400 currency_retired döner. Belirtilirse limitAmount da gereklidir. |
models | string[] | - | Güncellenmiş model allowlist'i |
deliveryPolicy | string | null | auto, verified, official, null | null, çalışma alanının teslim politikasını devralır. |
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.
limitCurrencyvarsayılan olarakUSDkullanır;CNYgönderildiğinde400 currency_retireddö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.
/usagesatır öğeleri, alttaki istek settlement edilmiş billing durumuna ulaştığındabilling_transaction_idiçerebilir. İstek düzeyinde mutabakat içinrequest_id+billing_transaction_idkullanı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:
İstek
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:
İstek
curl "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token"Yanıt
{
"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",
"delivery_policy": null
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1
}
}