Yönetim

API Anahtarı Oluştur

Mevcut Workspace için bir API anahtarı oluşturun.

POSThttps://api.tokenlab.sh/v1/management/api-keys

Genel Bakış

Yönetim token'ı ile ilişkili Workspace içerisinde bir API anahtarı oluşturun. Tam gizli anahtar, yalnızca bu yanıtta bir kez gösterilir.

İstek Gövdesi

AlanTipVarsayılan / SınırlarNotlar
namestringisteğe bağlı, varsayılan Default Key, uzunluk 1-50Görünen ad, sunucu tarafında kırpılır
limitAmountnumber | string | null0–100000 USDnull sınırsız anlamına gelir; 0 harcamayı engeller. Ondalık dizeler 6 ondalık basamağa kadar destekler. Bir anahtar oluştururken bu alanı atlamak sınırsız olduğu anlamına gelir.
limitCurrencyenumvarsayılan USDSadece USD. CNY göndermek 400 currency_retired döndürür.
modelsstring[]varsayılan []İsteğe bağlı model izin listesi
deliveryPolicystring | nullauto, verified, official, nullnull, Workspace teslimat politikasını devralır.
expiresAtstring | nullRFC3339 tarih saatinull süre sonu olmadığı anlamına gelir

Notlar

  • Parasal alanlar yalnızca USD içindir. CNY girişleri kullanımdan kaldırılmıştır ve 400 currency_retired hatası döndürür.

  • models: [] anahtar düzeyinde hiçbir model kısıtlaması eklemez.

  • limitAmount: 0, geçerli ancak güncellenene kadar kota harcayamayan bir anahtar oluşturur.

Örnek

İstek

cURL
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "kling-v3.0"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

İstek / Yanıt

Bu sayfa, OpenAPI şemasını ve kopyalanabilir istek örneklerini sağlar. Yönetim isteklerini terminalinizden veya istemcinizden bir Management Token ile gönderin; doğrudan gönderme bu sayfada mevcut değildir.

Yanıt örneği

Yanıt

201 Created
{
  "id": "key_abc123def456",
  "name": "Backend Worker",
  "key": "sk-live-redacted",
  "key_prefix": "sk-live...",
  "status": "active",
  "limit_amount": 500,
  "limit_amount_decimal": "500",
  "used_amount": 0,
  "used_amount_decimal": "0",
  "models": [
    "veo3.1",
    "kling-v3.0"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": null,
  "created_at": "2026-07-08T03:00:00.000Z",
  "delivery_policy": null
}

Önemli alanlar

keystring
Tam gizli API anahtarı değeri. Sadece oluşturulma sırasında bir kez döndürülür.
idstring
Takip eden Management API çağrılarında kullanılan API anahtarı tanımlayıcısı.
namestring
API anahtarı için görünen ad.
key_prefixstring
Görüntüleme ve destek için gizli olmayan anahtar öneki.
statusstring
active, inactive, suspended veya revoked değerlerinden biri.
limit_amountnumber | null
Görüntüleme için JSON sayısı olarak USD cinsinden harcama sınırı. null sınırsız anlamına gelir.
limit_amount_decimalstring | null
Ondalık dize olarak USD cinsinden kesin harcama sınırı. null sınırsız anlamına gelir.
used_amountnumber
Görüntüleme için JSON sayısı olarak USD cinsinden birikmiş kullanım.
used_amount_decimalstring
Ondalık dize olarak USD cinsinden kesin birikmiş kullanım.
modelsstring[]
Anahtar bazlı model izin listesi. Boş dizi, ek bir anahtar düzeyinde model kısıtlaması olmadığı anlamına gelir.
delivery_policystring | null
auto, verified, official, null. null, Workspace teslimat politikasını devralır.
expires_atstring | null
Anahtarın süresinin dolduğu ISO zaman damgası veya süre sonu yoksa null.
last_used_atstring | null
En son kullanım için ISO zaman damgası veya kullanılmadıysa null.
created_atstring
ISO oluşturulma zaman damgası.

Yetkilendirme

ManagementTokenAuth
AuthorizationBearer <token>

Yönetim belirteci kimlik doğrulaması. Yönetim Belirteçlerini Dashboard > API > Management Tokens bölümünden oluşturun veya yönetin.

Konum: header

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json