Langsung ke konten utama

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.

​
Ikhtisar

Management API memungkinkan Anda mengambil total saldo organisasi, mengelola API key organisasi, serta mengambil usage dan billing untuk key tertentu tanpa memakai inference API key biasa. Gunakan management token dari halaman Settings di Dashboard: 
Authorization: Bearer mt-your-management-token
Management token berbeda dari inference API key. Gunakan mt-... untuk /v1/management/*, dan gunakan sk-... untuk endpoint inferensi seperti /v1/responses.

​
Endpoint Tersedia

EndpointMethodDeskripsi
/v1/management/balanceGETAmbil total saldo organisasi saat ini
/v1/management/api-keysGETDaftar API key yang dikelola user di organisasi saat ini
/v1/management/api-keysPOSTBuat API key user baru
/v1/management/api-keys/{keyId}PATCHPerbarui nama, batas penggunaan, model yang diizinkan, masa berlaku, atau status
/v1/management/api-keys/{keyId}/usageGETAmbil detail usage berpaginasi untuk key tertentu
/v1/management/api-keys/{keyId}/billingGETAmbil breakdown billing teragregasi untuk key tertentu

​
Kontrak Filter Usage

GET /v1/management/api-keys/{keyId}/usage mendukung parameter query berikut:
ParameterTipeDefault / BatasCatatan
pageintegerdefault 1, min 1Nomor halaman mulai dari 1
limitintegerdefault 50, min 1, max 100Ukuran halaman
logicalModelstringpanjang maks 100Nama model logis yang diminta
modelVendorstringpanjang maks 100Vendor model publik
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform atau byok
startDatestring-Batas bawah inklusif; menerima RFC3339 dengan timezone atau YYYY-MM-DD
endDatestring-Batas atas inklusif; menerima RFC3339 dengan timezone atau YYYY-MM-DD
Jika startDate dan endDate sama-sama ada, startDate harus lebih kecil dari atau sama dengan endDate.

​
Kontrak Body API Key

​
POST /v1/management/api-keys

BidangTipeDefault / BatasCatatan
namestringwajib, default Default Key, panjang 1-50Nama tampilan, dipangkas di sisi server
limitAmountnumber | nullmin 0, max input 1000000null atau dihilangkan = tidak terbatas, 0 = kuota nol. Nilai positif dinormalisasi menjadi batas simpan yang tidak melebihi setara 100000 USD
limitCurrencyenumdefault USDHanya USD. Mengirim CNY menghasilkan 400 currency_retired.
modelsstring[]default []Daftar izin model logis opsional
expiresAtstring | nulldatetime RFC3339null berarti tidak kedaluwarsa

​
PATCH /v1/management/api-keys/

BidangTipeDefault / BatasCatatan
statusenum-active, inactive, suspended, revoked
namestringpanjang 1-50Nama tampilan yang diperbarui
limitAmountnumber | nullmin 0, max input 1000000null = tidak terbatas, 0 = kuota nol. Nilai positif dinormalisasi menjadi batas simpan yang tidak melebihi setara 100000 USD
limitCurrencyenumdefault USDHanya USD. Mengirim CNY menghasilkan 400 currency_retired.
modelsstring[]-Daftar izin model logis yang diperbarui
expiresAtstring | nulldatetime RFC3339null menghapus masa kedaluwarsa
Setidaknya satu field PATCH harus diberikan.

​
Kontrak Moneter

​
Semantik Pelaporan

  • logicalModel merujuk ke model logis publik yang diminta caller.
  • modelVendor merujuk ke vendor model publik, bukan rute fisik tersembunyi.
  • scene adalah scene request publik yang diturunkan dari endpoint atau jenis tugas.
  • accessChannel=platform berarti request ditagihkan lewat channel platform LemonData.
  • accessChannel=byok berarti request memakai kunci upstream provider milik Anda sendiri.
Respons hanya menampilkan field billing dan reporting publik. Detail routing internal dan metadata provider fisik tetap tersembunyi.
  • Item /usage dapat menyertakan billing_transaction_id setelah request dasar mencapai status billing yang telah diselesaikan. Gunakan request_id + billing_transaction_id untuk rekonsiliasi level request.

​
Catatan Paginasi Billing

/usage dipaginasi. /billing saat ini adalah endpoint breakdown teragregasi dan tidak mengembalikan metadata paginasi seperti page / limit. Jika Anda butuh record level baris, gunakan /usage.

​
Contoh Singkat

Mulailah dengan memeriksa saldo organisasi menggunakan management token saat ini: 
curl -X GET "https://api.lemondata.cc/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"
Lalu tampilkan API key yang tersedia untuk management token yang sama: 
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"
    }
  ]
}

​
Langkah Berikutnya