Documentation Index
Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt
Use this file to discover all available pages before exploring further.
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’daki Settings 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 Endpoint’ler
| Endpoint | Method | 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, min 1 | 1’den başlayan sayfa numarası |
limit | integer | varsayılan 50, min 1, max 100 | Sayfa boyutu |
logicalModel | string | max uzunluk 100 | İstenen mantıksal model adı |
modelVendor | string | max uzunluk 100 | Herkese açık model vendor’ı |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d |
accessChannel | enum | - | platform veya byok |
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 |
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 trim edilir |
limitAmount | number | null | min 0, input max 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 mantıksal 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, suspended, revoked |
name | string | uzunluk 1-50 | Güncellenmiş görünen ad |
limitAmount | number | null | min 0, input max 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ş mantıksal model allowlist’i |
expiresAt | string | null | RFC3339 datetime | null son kullanmayı kaldırır |
Parasal Sözleşme
Raporlama Anlamı
logicalModel, çağıranın talep ettiği herkese açık mantıksal modeli ifade eder.modelVendor, gizli fiziksel route yerine herkese açık model vendor’ını ifade eder.scene, endpoint veya görev türünden türetilen herkese açık istek sahnesidir.accessChannel=platform, isteğin LemonData’nın platform kanalından faturalandığı anlamına gelir.accessChannel=byok, isteğin kendi upstream provider anahtarınızı kullandığı anlamına gelir.
Yanıtlar yalnızca herkese açık faturalama ve raporlama alanlarını gösterir. Dahili routing ayrıntıları ve fiziksel provider metadata’sı gizli kalır.
/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.lemondata.cc/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"
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,
"used_amount": 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"
}
]
}
Sonraki Adımlar
