الإدارة

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

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

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

نظرة عامة

إرجاع إجمالي الإنفاق، وعدد الطلبات، والاستخدام القابل للفوترة، والتكلفة مجمعة حسب النموذج، ومزود النموذج، والمشهد، والتاريخ.

ملاحظات

  • الحقول النقدية هي بالدولار الأمريكي (USD) فقط.

  • لا يتم تضمين عمليات شحن رصيد مساحة العمل (Workspace) والفواتير.

  • يعني endDate الذي يحتوي على تاريخ فقط الساعة 00:00 بالتوقيت العالمي المنسق (UTC) في بداية ذلك اليوم. لتضمين يوم كامل، استخدم التاريخ التالي أو وقت بتنسيق RFC3339.

  • رمز الخطأ 429 مع الكود report_busy يعني أن قائمة انتظار التقارير ممتلئة. أعد المحاولة بعد عدد الثواني المحدد في Retry-After.

مثال

يدعم نفس فلاتر النموذج، ومزود النموذج، والمشهد، والتاريخ المتاحة في استخدام مفتاح API. يُرجع الإجماليات بدون ترقيم صفحات.

الطلب

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"

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

توفر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من جهازك الطرفي (terminal) أو العميل باستخدام 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-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"
      }
    ]
  }
}

حقول هامة

api_keyobject
ملخص مفتاح API باستخدام نفس الحقول الموجودة في استجابات القائمة/الإنشاء/التحديث.
summaryobject
الإجماليات المجمعة للفلاتر المحددة.
breakdownsobject
التفاصيل المجمعة للفلاتر المحددة.
summary.total_requestsnumber
إجمالي عدد الطلبات.
summary.total_costnumber
إجمالي التكلفة بالدولار الأمريكي كرقم JSON للعرض.
summary.total_cost_decimalstring
إجمالي التكلفة الدقيق بالدولار الأمريكي كسلسلة نصية عشرية.
summary.total_prompt_tokensnumber
إجمالي رموز المطالبة (prompt tokens).
summary.total_completion_tokensnumber
إجمالي رموز الإكمال (completion tokens).
summary.total_tokensnumber
إجمالي الرموز (tokens).
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

الحد الأدنى، شامل. يقبل تنسيق RFC3339 مع المنطقة الزمنية (على سبيل المثال 2026-03-28T00:00:00+08:00) أو YYYY-MM-DD، والذي يعني 00:00 بالتوقيت العالمي المنسق (UTC).

endDate?string

الحد الأعلى، شامل. يقبل تنسيق RFC3339 مع المنطقة الزمنية (على سبيل المثال 2026-03-28T23:59:59+08:00) أو YYYY-MM-DD، والذي يعني 00:00 بالتوقيت العالمي المنسق (UTC) في بداية ذلك اليوم. لتضمين يوم كامل، مرر تاريخ اليوم التالي أو وقت RFC3339 في نهاية اليوم.

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json