الأساسيات

الحصول على الأسعار

الحصول على معلومات الأسعار للنماذج

GET
/v1/pricing

هذه نقطة نهاية عامة ولا تتطلب مفتاح API.

نظرة عامة

استخدم هذا الـ endpoint لعرض سطح الأسعار العام الحالي للنماذج النشطة.

للاطلاع على تفاصيل التسعير الكاملة لنموذج واحد، بما في ذلك التسعير المنظم ومصدر البيانات، فضّل الحصول على تسعير النموذج.

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

providerstringquery

فلتر اختياري حسب المزود، مثل openai أو anthropic أو google.

tagstringquery

فلتر اختياري حسب وسم النموذج، مثل chat أو image أو video أو embedding أو translation.

الاستجابة

objectstring

دائمًا pricing.

updated_atstring

طابع زمني بصيغة ISO لوقت نشر الأسعار العامة الحالية.

currencystring

دائمًا USD.

dataarray

مصفوفة من إدخالات التسعير. يتضمن كل عنصر model و provider و is_lock_price و capabilities و aliases وحقول الملخص العام للتسعير، سواء كانت قيمًا scalar أو بنية منظمة، كما تعيدها الواجهة التفاعلية أعلاه.

الطلب

curl "https://api.tokenlab.sh/v1/pricing?provider=openai&tag=chat"

الاستجابة

Response
{
  "object": "pricing",
  "updated_at": "2026-04-20T00:00:00.000Z",
  "currency": "USD",
  "data": [
    {
      "model": "gpt-4o",
      "provider": "openai",
      "is_lock_price": false,
      "input_per_1m_tokens": "2.50",
      "output_per_1m_tokens": "10.00",
      "capabilities": ["chat"],
      "aliases": ["gpt-4o-latest"]
    }
  ]
}

استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على مخطط الاستجابة الدقيق. قد تكشف إدخالات التسعير العامة أيضًا lock_price_per_request و has_complex_pricing و supported_operations و pricing_summary و pricing_provenance.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

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

provider?string

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

tag?string

التصفية حسب علامة النموذج.

الاستجابة

application/json

application/json

application/json

application/json