API anahtarı kullanımını getir

Bir kullanıcı API anahtarı için sayfalanmış kullanım ayrıntılarını döndürür.

Genel bakış

Bu endpoint, fiziksel yönlendirme metadatasını açığa çıkarmadan API anahtarı düzeyinde kullanım ayrıntılarını döndürür.

Sorgu parametreleri

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
`model`	string	maksimum uzunluk `100`	İstenen 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`, `realtime`
`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.

Notlar

Parasal alanlar yalnızca USD’yi destekler.
Yanıt sayfalanmıştır.
Yanıt yalnızca herkese açık faturalama ve raporlama alanlarını içerir.
Her usage kaydı, alttaki istek mutabakatı tamamlandıktan sonra billing_transaction_id da içerebilir. İstek düzeyinde mutabakat için bunu request_id ile birlikte kullanın.
Dahili yönlendirme ve fiziksel kanal metadatası kasıtlı olarak gizlenir.

Örnek

İstek

cURL

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

Bu sayfa OpenAPI şemasını ve kopyalanabilir istek örneklerini sunar. Yönetim isteklerini Management Token kullanarak terminalinizden veya istemcinizden gönderin; bu sayfadan doğrudan gönderim yapılamaz.

Yanıt örneği

Yanıt

200 OK

{
  "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.6-luna",
      "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",
    "delivery_policy": null
  },
  "items": [
    {
      "request_id": "req_abc123",
      "billing_transaction_id": "billtxn_abc123",
      "model": "gpt-5.6-luna",
      "logical_model": "gpt-5.6-luna",
      "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",
      "requested_policy": null,
      "resolved_tier": null,
      "charged_price_basis": null
    }
  ],
  "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.6-luna",
        "logical_model": "gpt-5.6-luna",
        "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.6-luna",
        "logical_model": "gpt-5.6-luna",
        "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"
      }
    ]
  }
}

Önemli alanlar

api_keyobject

Listeleme, oluşturma ve güncelleme yanıtlarıyla aynı alanları kullanan API anahtarı özeti.

itemsarray

Sayfalanmış kullanım satırları.

paginationobject

page, limit, total ve totalPages değerlerini içeren sayfalama meta verileri.

summaryobject

Seçilen filtreler için toplu toplamlar.

breakdownsobject

Seçilen filtreler için toplu dökümler.

items[].request_idstring | null

Destek ve mutabakat için genel istek tanımlayıcısı.

items[].billing_transaction_idstring | null

Kullanılabilir olduğunda mutabakatı tamamlanmış faturalama işlem kimliği.

items[].modelstring

İstenen genel model adı.

items[].logical_modelstring

Raporlama için mantıksal genel model.

items[].model_vendorstring | null

Genel model sağlayıcısı.

items[].scenestring | null

Genel istek sahnesi.

items[].usage_unitstring

per_token gibi faturalama kullanım birimi.

items[].usage_quantitynumber

Görüntüleme için JSON sayısı olarak kullanım miktarı.

items[].usage_quantity_decimalstring

Ondalık dize olarak kesin kullanım miktarı.

items[].prompt_tokensnumber

İstem token sayısı.

items[].completion_tokensnumber

Tamamlama token sayısı.

items[].total_tokensnumber

Toplam token sayısı.

items[].cache_read_tokensnumber

Önbellek okuma token sayısı.

items[].cache_write_tokensnumber

Toplam önbellek yazma token sayısı.

items[].cache_write_tokens_5mnumber

Beş dakikalık önbellek yazma token sayısı.

items[].cache_write_tokens_1hnumber

Bir saatlik önbellek yazma token sayısı.

items[].costnumber

Görüntüleme için JSON sayısı olarak USD maliyeti.

items[].cost_decimalstring

Ondalık dize olarak kesin USD maliyeti.

items[].requested_policystring | null

auto, verified, official, null. Kaydedilmişse istenen teslim politikası.

items[].resolved_tierstring | null

verified, official, null. Kaydedilmişse kullanılan teslim düzeyi.

items[].charged_price_basisobject | null

Kaydedilmişse uygulanan fiyat ve faturalandırılabilir miktar.

items[].created_atstring

Kullanım satırının ISO zaman damgası.

summary.total_requestsnumber

Toplam istek sayısı.

summary.total_costnumber

Görüntüleme için JSON sayısı olarak toplam USD maliyeti.

summary.total_cost_decimalstring

Ondalık dize olarak kesin toplam USD maliyeti.

summary.total_prompt_tokensnumber

Toplam istem token sayısı.

summary.total_completion_tokensnumber

Toplam tamamlama token sayısı.

summary.total_tokensnumber

Toplam token sayısı.

summary.usage_unit_breakdownarray

Kullanım birimine göre gruplanmış kullanım miktarı.

breakdowns.by_modelarray

İstenen genel modele göre döküm.

breakdowns.by_logical_modelarray

Mantıksal genel modele göre döküm.

breakdowns.by_model_vendorarray

Genel model sağlayıcısına göre döküm.

breakdowns.by_scenearray

Genel istek sahnesine göre döküm.

breakdowns.daily_costarray

Günlük maliyet eğilimi.

Yetkilendirme

ManagementTokenAuth

AuthorizationBearer <token>

Yönetim belirteci kimlik doğrulaması. Yönetim Belirteçlerini Dashboard > API > Management Tokens bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

keyId*string

Sorgu parametreleri

page?integer

1'den başlayan sayfa numarası. Varsayılan 1'dir.

Aralık1 <= value

varsayılan1

limit?integer

Sayfa boyutu. Varsayılan 50, maksimum 100'dür.

Aralık1 <= value <= 100

varsayılan50

model?string

İstenen model adına göre filtrele. Maksimum uzunluk 100.

Uzunluklength <= 100

modelVendor?string

Genel model sağlayıcısına göre filtrele. Maksimum uzunluk 100.

Uzunluklength <= 100

scene?string

Genel istek sahnesine göre filtrele.

Geçerli değerler

"chat"
"image"
"audio"
"video"
"embedding"
"rerank"
"translation"
"music"
"3d"
"realtime"
"systemone"

startDate?string

Kapsayıcı tarih filtresi. Saat dilimi içeren RFC3339 (örneğin 2026-03-28T00:00:00+08:00) veya YYYY-AA-GG formatını kabul eder.

endDate?string

Kapsayıcı tarih filtresi. Saat dilimi içeren RFC3339 (örneğin 2026-03-28T00:00:00+08:00) veya YYYY-AA-GG formatını kabul eder.

API anahtarı kullanımını getir

Genel bakış

Sorgu parametreleri

Notlar

Örnek

İstek / Yanıt

Yanıt örneği

Önemli alanlar

Yetkilendirme

Yol parametreleri

Sorgu parametreleri

Yanıt

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

API anahtarı kullanımını getir

Genel bakışCopy Anchor Link

Sorgu parametreleriCopy Anchor Link

NotlarCopy Anchor Link

ÖrnekCopy Anchor Link

İstek / YanıtCopy Anchor Link

Yanıt örneğiCopy Anchor Link

Önemli alanlarCopy Anchor Link

YetkilendirmeCopy Anchor Link

Yol parametreleriCopy Anchor Link

Sorgu parametreleriCopy Anchor Link

YanıtCopy Anchor Link

200application/json

400application/json

401application/json

403application/json

404application/json

Genel bakış

Sorgu parametreleri

Notlar

Örnek

İstek / Yanıt

Yanıt örneği

Önemli alanlar

Yetkilendirme

Yol parametreleri

Sorgu parametreleri

Yanıt

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`