Ikhtisar
API Manajemen memungkinkan Anda mengelola API key organisasi dan mengambil penggunaan serta penagihan per key tanpa memakai inference API key biasa.
Anda bisa menerbitkan dan merotasi token manajemen dari halaman Settings di Dashboard.
Authorization: Bearer mt-your-management-token
Token manajemen berbeda dari inference API key. Gunakan mt-... untuk /v1/management/*, dan gunakan sk-... untuk endpoint inferensi seperti /v1/responses.
Endpoint yang tersedia
| Endpoint | Method | Deskripsi |
|---|
/v1/management/api-keys | GET | Menampilkan daftar API key pengguna di organisasi saat ini |
/v1/management/api-keys | POST | Membuat API key pengguna baru |
/v1/management/api-keys/{keyId} | PATCH | Memperbarui nama, batas penggunaan, model yang diizinkan, kedaluwarsa, atau status |
/v1/management/api-keys/{keyId}/usage | GET | Mengambil detail penggunaan yang dipaginasi untuk key tertentu |
/v1/management/api-keys/{keyId}/billing | GET | Mengambil rincian penagihan teragregasi untuk key tertentu |
Kontrak filter penggunaan
GET /v1/management/api-keys/{keyId}/usage mendukung parameter query berikut.
| Parameter | Tipe | Default / batas | Deskripsi |
|---|
page | integer | default 1, minimum 1 | Nomor halaman mulai dari 1 |
limit | integer | default 50, minimum 1, maksimum 100 | Ukuran halaman |
logicalModel | string | panjang maksimum 100 | Nama model logis yang diminta |
modelVendor | string | panjang maksimum 100 | Vendor model publik |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d |
accessChannel | enum | - | platform atau byok |
startDate | string | - | Batas bawah inklusif; menerima RFC3339 dengan timezone atau YYYY-MM-DD |
endDate | string | - | Batas atas inklusif; menerima RFC3339 dengan timezone atau YYYY-MM-DD |
startDate dan endDate dikirim bersamaan, startDate harus lebih awal atau sama dengan endDate.
Kontrak body API key
POST /v1/management/api-keys
| Field | Tipe | Default / batas | Deskripsi |
|---|
name | string | wajib, default Default Key, panjang 1-50 | Nama tampilan; spasi di awal dan akhir akan dirapikan server |
limitAmount | number | null | minimum 0, maksimum 100000 | null atau dihilangkan = tanpa batas, 0 = kuota nol, nilai positif = batas belanja USD |
limitCurrency | enum | default USD | Opsional: USD atau CNY. Jika diatur ke CNY, limitAmount diperlakukan sebagai RMB dan dikonversi ke USD di server sebelum disimpan |
models | string[] | default [] | Allowlist model logis opsional |
expiresAt | string | null | datetime RFC3339 | null berarti tanpa kedaluwarsa |
PATCH /v1/management/api-keys/
| Field | Tipe | Default / batas | Deskripsi |
|---|
status | enum | - | active, inactive, revoked |
name | string | panjang 1-50 | Nama tampilan yang diperbarui |
limitAmount | number | null | minimum 0, maksimum 100000 | null = tanpa batas, 0 = kuota nol |
limitCurrency | enum | default USD | Opsional: USD atau CNY. Jika diatur ke CNY, limitAmount diperlakukan sebagai RMB dan dikonversi ke USD di server sebelum disimpan |
models | string[] | - | Allowlist model logis yang diperbarui |
expiresAt | string | null | datetime RFC3339 | null menghapus tanggal kedaluwarsa |
Kontrak mata uang
- Secara default,
limitAmount pada request ditafsirkan sebagai USD. Setel limitCurrency: "CNY" untuk mengirim batas dalam RMB; server akan mengonversinya ke USD dengan kurs saat ini sebelum disimpan.
- Field moneter pada respons mempertahankan nilai USD asli dan menambahkan pasangan tampilan RMB dengan sufiks
_cny.
exchange_rate dikembalikan bersama metadata API key dan merupakan kurs USD→CNY yang digunakan untuk setiap nilai *_cny dalam respons tersebut.
Semantik pelaporan
logicalModel mengacu pada model logis publik yang diminta oleh pemanggil.modelVendor mengacu pada vendor model publik, bukan rute fisik yang tersembunyi.scene adalah scene permintaan publik yang diturunkan dari endpoint atau jenis task.accessChannel=platform berarti permintaan ditagihkan melalui kanal platform LemonData.accessChannel=byok berarti permintaan menggunakan key penyedia upstream milik Anda sendiri.
Respons hanya mengekspos field penagihan dan pelaporan yang bersifat publik. Detail routing internal dan metadata penyedia fisik tetap disembunyikan.
/usage mendukung pagination. /billing saat ini merupakan endpoint agregat dan tidak mengembalikan metadata pagination bergaya page / limit. Jika Anda membutuhkan catatan rinci per baris, gunakan /usage.
Contoh cepat
Mulailah dengan melihat daftar API key yang tersedia untuk token manajemen saat ini.
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"
}
]
}
Langkah berikutnya
