الإدارة

الحصول على فوترة مفتاح API

تعيد تفصيلات فوترة مجمعة لمفتاح API خاص بالمستخدم.

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

نظرة عامة

تعيد نقطة النهاية هذه تجميعات فوترة قائمة على الاستهلاك لمفتاح API المحدد، بما في ذلك التكلفة الإجمالية وإجمالي الطلبات والاستخدام حسب وحدة الفوترة، وتفصيلات by_model وby_logical_model وby_model_vendor وby_scene، إضافة إلى اتجاه التكلفة اليومي.

ملاحظات

  • تدعم حقول المبالغ المالية الدولار الأمريكي فقط.

  • يتم استبعاد عمليات الشحن والفواتير والسجلات المالية الأخرى على مستوى المؤسسة.

مثال

يدعم مرشحات النموذج والمورّد والمشهد والتاريخ نفسها في استخدام مفتاح API. يعيد المجاميع دون ترقيم صفحات.

الطلب

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

الطلب / الاستجابة

توفّر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام Management Token؛ لا يتوفر الإرسال المباشر من هذه الصفحة.

الاستجابة

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
  },
  "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"
      }
    ]
  }
}

الحقول المهمة

api_keyobject
ملخص مفتاح API باستخدام الحقول نفسها الموجودة في استجابات القائمة والإنشاء والتحديث.
summaryobject
إجماليات مجمعة للفلاتر المحددة.
breakdownsobject
تفصيلات مجمعة للفلاتر المحددة.
summary.total_requestsnumber
إجمالي عدد الطلبات.
summary.total_costnumber
إجمالي التكلفة بالدولار الأمريكي كرقم JSON للعرض.
summary.total_cost_decimalstring
إجمالي التكلفة الدقيقة بالدولار الأمريكي كسلسلة عشرية.
summary.total_prompt_tokensnumber
إجمالي رموز المطالبة.
summary.total_completion_tokensnumber
إجمالي رموز الإكمال.
summary.total_tokensnumber
إجمالي الرموز.
summary.usage_unit_breakdownarray
كمية الاستخدام مجمعة حسب وحدة الاستخدام.
breakdowns.by_modelarray
تفصيل حسب النموذج العام المطلوب.
breakdowns.by_logical_modelarray
تفصيل حسب النموذج العام المنطقي.
breakdowns.by_model_vendorarray
تفصيل حسب مورّد النموذج العام.
breakdowns.by_scenearray
تفصيل حسب مشهد الطلب العام.
breakdowns.daily_costarray
اتجاه التكلفة اليومي.

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.

الموضع: header

معاملات المسار

keyId*string

معاملات الاستعلام

model?string

التصفية حسب اسم النموذج المطلوب. الحد الأقصى للطول 100.

الطولlength <= 100
modelVendor?string

التصفية حسب مزود النموذج العام. الحد الأقصى للطول 100.

الطولlength <= 100
scene?string

التصفية حسب مشهد الطلب العام.

القيم المتاحة

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string
endDate?string

الاستجابة

application/json

application/json

application/json

application/json

application/json