Lihat penggunaan API key

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5-mini",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "model_vendor": "OpenAI",
      "scene": "chat",
      "usage_unit": "per_token",
      "usage_quantity": 1500,
      "usage_quantity_decimal": "1500",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "total_tokens": 1500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "cache_write_tokens_5m": 0,
      "cache_write_tokens_1h": 0,
      "cost": 0.0012,
      "cost_decimal": "0.0012",
      "created_at": "2026-07-08T03:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

Ikhtisar

Endpoint ini mengembalikan detail penggunaan per API key tanpa menampilkan detail routing penyedia.

Parameter kueri

Parameter	Tipe	Default / batas	Deskripsi
`page`	integer	bawaan `1`, minimum `1`	Nomor halaman mulai dari 1
`limit`	integer	bawaan `50`, minimum `1`, maksimum `100`	Ukuran halaman
`model`	string	panjang maksimum `100`	Nama model yang diminta
`modelVendor`	string	panjang maksimum `100`	Vendor model publik
`scene`	enum	-	`chat`, `image`, `audio`, `video`, `embedding`, `rerank`, `translation`, `music`, `3d`, `realtime`
`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`

Jika startDate dan endDate dikirim bersamaan, startDate harus lebih awal atau sama dengan endDate.

Catatan

Kolom moneter hanya mendukung USD. Input CNY telah dihentikan dan mengembalikan 400 currency_retired.
Respons ini dipaginasi.
Respons hanya mencakup field penagihan dan pelaporan yang bersifat publik.
Setiap item usage juga dapat menyertakan billing_transaction_id setelah request dasarnya mencapai status settlement selesai. Gunakan nilai ini bersama request_id untuk rekonsiliasi per request.
Detail routing penyedia tidak ditampilkan.

Contoh

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

Request / Respons

Gunakan panel OpenAPI interaktif di atas untuk melihat schema dan field respons yang tepat.

Contoh respons

{
  "api_key": {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "active",
    "limit_amount": 500,
    "limit_amount_decimal": "500",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5-mini",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z"
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5-mini",
      "logical_model": "gpt-5-mini",
      "model_vendor": "OpenAI",
      "scene": "chat",
      "usage_unit": "per_token",
      "usage_quantity": 1500,
      "usage_quantity_decimal": "1500",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "total_tokens": 1500,
      "cache_read_tokens": 0,
      "cache_write_tokens": 0,
      "cache_write_tokens_5m": 0,
      "cache_write_tokens_1h": 0,
      "cost": 0.0012,
      "cost_decimal": "0.0012",
      "created_at": "2026-07-08T03:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "summary": {
    "total_requests": 1,
    "total_cost": 0.0012,
    "total_cost_decimal": "0.0012",
    "total_prompt_tokens": 1000,
    "total_completion_tokens": 500,
    "total_tokens": 1500,
    "usage_unit_breakdown": [
      {
        "usage_unit": "per_token",
        "usage_quantity": 1500
      }
    ]
  },
  "breakdowns": {
    "by_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_logical_model": [
      {
        "model": "gpt-5-mini",
        "logical_model": "gpt-5-mini",
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012",
        "usage_quantity": 1500,
        "usage_quantity_decimal": "1500"
      }
    ],
    "by_model_vendor": [
      {
        "model_vendor": "OpenAI",
        "requests": 1,
        "cost": 0.0012
      }
    ],
    "by_scene": [
      {
        "scene": "chat",
        "requests": 1,
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ],
    "daily_cost": [
      {
        "date": "2026-07-08T00:00:00.000Z",
        "cost": 0.0012,
        "cost_decimal": "0.0012"
      }
    ]
  }
}

Kolom penting

object

Ringkasan kunci API dengan bidang yang sama seperti respons daftar, pembuatan, dan pembaruan.

array

Baris penggunaan berpaginasi.

object

Metadata paginasi dengan page, limit, total, dan totalPages.

object

Total agregat untuk filter yang dipilih.

object

Rincian agregat untuk filter yang dipilih.

string | null

ID permintaan publik untuk dukungan dan rekonsiliasi.

string | null

ID transaksi penagihan yang telah diselesaikan jika tersedia.

string

Nama model publik yang diminta.

string

Model publik logis yang digunakan untuk pelaporan.

string | null

Vendor model publik.

string | null

Skenario permintaan publik.

string

Satuan penggunaan penagihan, seperti per_token.

number

Kuantitas penggunaan sebagai angka JSON untuk tampilan.

string

Kuantitas penggunaan yang tepat sebagai string desimal.

number

Jumlah token prompt.

number

Jumlah token penyelesaian.

number

Jumlah total token.

number

Jumlah token baca cache.

number

Jumlah total token tulis cache.

number

Jumlah token tulis cache lima menit.

number

Jumlah token tulis cache satu jam.

number

Biaya dalam USD sebagai angka JSON untuk tampilan.

string

Biaya yang tepat dalam USD sebagai string desimal.

string

Stempel waktu ISO baris penggunaan.

number

Total permintaan.

number

Total biaya dalam USD sebagai angka JSON untuk tampilan.

string

Total biaya yang tepat dalam USD sebagai string desimal.

number

Total token prompt.

number

Total token penyelesaian.

number

Total token.

array

Kuantitas penggunaan yang dikelompokkan menurut satuan penggunaan.

array

Rincian berdasarkan model publik yang diminta.

array

Rincian berdasarkan model publik logis.

array

Rincian berdasarkan vendor model publik.

array

Rincian berdasarkan skenario permintaan publik.

array

Tren biaya harian.

Inti

Teks

Berkas & batch

Gambar

Audio & realtime

Musik

Video & materi

Worlds

3D

Pekerjaan asinkron

Gemini native

Manajemen

Lihat penggunaan API key

Ikhtisar

Parameter kueri

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting

​Ikhtisar

​Parameter kueri

​Catatan

​Contoh

​Request / Respons

​Contoh respons

​Kolom penting

Ikhtisar

Parameter kueri

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting