Genel bakış
Yönetim API’si, standart bir inference API key kullanmadan kuruluş API anahtarlarını yönetmenizi ve anahtar bazında kullanım ile faturalamayı almanızı sağlar.
Yönetim belirtecini Dashboard içindeki Settings sayfasından oluşturabilir ve döndürebilirsiniz.
Authorization: Bearer mt-your-management-token
Yönetim belirteçleri inference API key’lerden farklıdır. /v1/management/* için mt-..., /v1/responses gibi inference endpointleri için sk-... kullanın.
Kullanılabilir endpointler
| Endpoint | Method | Açıklama |
|---|
/v1/management/api-keys | GET | Geçerli kuruluştaki kullanıcı API anahtarlarını listeler |
/v1/management/api-keys | POST | Yeni bir kullanıcı API anahtarı oluşturur |
/v1/management/api-keys/{keyId} | PATCH | Adı, kullanım limitini, izinli modelleri, son kullanma tarihini veya durumu günceller |
/v1/management/api-keys/{keyId}/usage | GET | Belirli bir anahtar için sayfalanmış kullanım ayrıntılarını getirir |
/v1/management/api-keys/{keyId}/billing | GET | Belirli bir anahtar için toplulaştırılmış faturalama kırılımlarını getirir |
Kullanım filtre sözleşmesi
GET /v1/management/api-keys/{keyId}/usage aşağıdaki sorgu parametrelerini destekler.
| Parametre | Tür | Varsayılan / sınırlar | Açıklama |
|---|
page | integer | varsayılan 1, minimum 1 | 1’den başlayan sayfa numarası |
limit | integer | varsayılan 50, minimum 1, maksimum 100 | Sayfa boyutu |
logicalModel | string | maksimum uzunluk 100 | İstenen mantıksal model adı |
modelVendor | string | maksimum uzunluk 100 | Herkese açık model sağlayıcısı |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d |
accessChannel | enum | - | platform veya byok |
startDate | string | - | Dahil alt sınır; zaman dilimli RFC3339 veya YYYY-MM-DD kabul eder |
endDate | string | - | Dahil üst sınır; zaman dilimli RFC3339 veya YYYY-MM-DD kabul eder |
startDate ve endDate birlikte gönderilirse startDate, endDate değerinden erken veya eşit olmalıdır.
API anahtarı gövde sözleşmesi
POST /v1/management/api-keys
| Alan | Tür | Varsayılan / sınırlar | Açıklama |
|---|
name | string | zorunlu, varsayılan Default Key, uzunluk 1-50 | Görünen ad; baştaki ve sondaki boşluklar sunucu tarafında temizlenir |
limitAmount | number | null | minimum 0, maksimum 100000 | null veya gönderilmezse = sınırsız, 0 = sıfır kota, pozitif değer = USD harcama sınırı |
limitCurrency | enum | varsayılan USD | İsteğe bağlı: USD veya CNY. CNY gönderilirse limitAmount RMB olarak yorumlanır ve kaydetmeden önce sunucu tarafında USD’ye dönüştürülür |
models | string[] | varsayılan [] | İsteğe bağlı mantıksal model izin listesi |
expiresAt | string | null | RFC3339 datetime | null son kullanma tarihi olmadığı anlamına gelir |
PATCH /v1/management/api-keys/
| Alan | Tür | Varsayılan / sınırlar | Açıklama |
|---|
status | enum | - | active, inactive, revoked |
name | string | uzunluk 1-50 | Güncellenmiş görünen ad |
limitAmount | number | null | minimum 0, maksimum 100000 | null = sınırsız, 0 = sıfır kota |
limitCurrency | enum | varsayılan USD | İsteğe bağlı: USD veya CNY. CNY gönderilirse limitAmount RMB olarak yorumlanır ve kaydetmeden önce sunucu tarafında USD’ye dönüştürülür |
models | string[] | - | Güncellenmiş mantıksal model izin listesi |
expiresAt | string | null | RFC3339 datetime | null son kullanma tarihini temizler |
Para birimi sözleşmesi
- Varsayılan olarak istek tarafındaki
limitAmount USD kabul edilir. limitCurrency: "CNY" ayarlanırsa RMB limiti gönderebilirsiniz; sunucu bunu kaydetmeden önce mevcut kurla USD’ye çevirir.
- Yanıttaki parasal alanlar özgün USD alanını korur ve
_cny son ekiyle RMB eşdeğerini ekler.
exchange_rate, API anahtarı metadatasıyla birlikte döner ve bu yanıttaki her *_cny değeri için kullanılan USD→CNY kurudur.
Raporlama anlamı
logicalModel, çağıranın talep ettiği herkese açık mantıksal modeli ifade eder.modelVendor, gizli fiziksel rota 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.accessChannel=platform, isteğin LemonData platform kanalı üzerinden faturalandığı anlamına gelir.accessChannel=byok, isteğin sizin upstream sağlayıcı anahtarınızı kullandığı anlamına gelir.
Yanıtlar yalnızca herkese açık faturalama ve raporlama alanlarını gösterir. Dahili yönlendirme ayrıntıları ve fiziksel sağlayıcı metadatası gizli kalır.
Billing sayfalama notu
/usage sayfalanır. /billing şu anda toplulaştırılmış bir endpointtir ve page / limit tarzı sayfalama metadatası döndürmez. Satır düzeyinde kayıtlar gerekiyorsa /usage kullanın.
Hızlı örnek
Önce geçerli yönetim belirteci için erişilebilir API anahtarlarını listeleyin.
curl "https://api.lemondata.cc/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_cny": 3600.0,
"used_amount": 148.25,
"used_amount_cny": 1067.4,
"exchange_rate": 7.2,
"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"
}
]
}
Sonraki adımlar
