Yönetim

API Anahtarı Faturalandırmasını Al

Bir kullanıcı API anahtarı için toplu faturalandırma dökümlerini döndürür.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/billing

Genel Bakış

Modele, model üreticisine, sahneye ve tarihe göre gruplandırılmış toplam harcamayı, istek sayısını, faturalandırılabilir kullanımı ve maliyeti döndürür.

Notlar

  • Parasal alanlar yalnızca USD cinsindendir.

  • Çalışma alanı (workspace) yüklemeleri ve faturalar dahil değildir.

  • Sadece tarih içeren bir endDate, o günün başlangıcındaki 00:00 UTC saatini ifade eder. Tüm günü dahil etmek için bir sonraki tarihi veya bir RFC3339 zaman damgasını kullanın.

  • report_busy koduna sahip bir 429 hatası, rapor kuyruğunun dolu olduğu anlamına gelir. Retry-After saniye süresi geçtikten sonra tekrar deneyin.

Örnek

API anahtarı kullanımı ile aynı model, model satıcısı, sahne ve tarih filtrelerini destekler. Sayfalama olmaksızın toplamları döndürür.

İstek

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
  -H "Authorization: Bearer mt-your-management-token"

İstek / Yanıt

Bu sayfa, OpenAPI şemasını ve kopyalanabilir istek örneklerini sağlar. Yönetim isteklerini terminalinizden veya istemcinizden bir Yönetim Token'ı (Management Token) ile 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-sonnet-4-6"
    ],
    "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
  },
  "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
Liste/oluşturma/güncelleme yanıtlarıyla aynı alanları kullanan API anahtarı özeti.
summaryobject
Seçilen filtreler için toplu toplamlar.
breakdownsobject
Seçilen filtreler için toplu dökümler.
summary.total_requestsnumber
Toplam istek sayısı.
summary.total_costnumber
Görüntüleme için JSON sayısı olarak USD cinsinden toplam maliyet.
summary.total_cost_decimalstring
Ondalık dize olarak USD cinsinden tam toplam maliyet.
summary.total_prompt_tokensnumber
Toplam istem (prompt) token sayısı.
summary.total_completion_tokensnumber
Toplam tamamlama (completion) token sayısı.
summary.total_tokensnumber
Toplam token sayısı.
summary.usage_unit_breakdownarray
Kullanım birimine göre gruplandırılmış 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 satı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

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

Alt sınır, dahil. Zaman dilimi ile birlikte RFC3339 (örneğin 2026-03-28T00:00:00+08:00) veya 00:00 UTC anlamına gelen YYYY-MM-DD formatını kabul eder.

endDate?string

Üst sınır, dahil. Zaman dilimi ile birlikte RFC3339 (örneğin 2026-03-28T23:59:59+08:00) veya o günün başlangıcında 00:00 UTC anlamına gelen YYYY-MM-DD formatını kabul eder. Tüm günü dahil etmek için bir sonraki günün tarihini veya gün sonundaki bir RFC3339 zamanını geçin.

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json