الأساسيات

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

الحصول على معلومات التسعير الخاصة بالنماذج

GET
/v1/pricing

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

نظرة عامة

إرجاع أسعار النماذج العامة الحالية. يوضح نموذج الاستجابة أدناه الشكل العام للبيانات؛ الأسعار قابلة للتغيير، لذا يرجى قراءة الاستجابة المباشرة.

للحصول على مستويات الأسعار لنموذج واحد، استخدم الحصول على تسعير النموذج.

معاملات الاستعلام (Query Parameters)

providerstringquery

عامل تصفية اختياري لمُصنّع النموذج مثل openai أو anthropic أو google. إرجاع قيمة غير معروفة يؤدي إلى 400 invalid_provider.

tagstringquery

عامل تصفية اختياري لوسم القدرات مثل reasoning أو tool-use أو vision أو text-to-image. القيم الموجودة في capabilities الخاصة بالنموذج هي وسوم صالحة. الوسم الذي لا يمتلكه أي نموذج يُرجع مصفوفة data فارغة.

الاستجابة

objectstring

دائماً pricing.

updated_atstring

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

currencystring

دائماً USD.

dataarray

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

الطلب

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

الاستجابة

Response
{
  "object": "pricing",
  "updated_at": "2026-11-01T06:30:51.988Z",
  "currency": "USD",
  "data": [
    {
      "model": "gpt-5.5",
      "provider": "openai",
      "is_lock_price": false,
      "capabilities": ["coding", "json-mode", "prompt-cache", "reasoning", "tool-use", "vision"],
      "aliases": ["gpt-5-5"],
      "deliveryAvailability": { "verified": true, "official": true },
      "input_per_1m_tokens": "3.5",
      "output_per_1m_tokens": "21",
      "official_input_per_1m_tokens": "5",
      "official_output_per_1m_tokens": "30",
      "has_complex_pricing": true,
      "supported_operations": []
    },
    {
      "model": "allam-2-7b",
      "provider": "sdaia",
      "is_lock_price": false,
      "capabilities": [],
      "aliases": [],
      "deliveryAvailability": { "verified": false, "official": true },
      "official_input_per_1m_tokens": "0.05",
      "official_output_per_1m_tokens": "0.08",
      "has_complex_pricing": false,
      "supported_operations": []
    }
  ]
}

تعتبر input_per_1m_tokens و output_per_1m_tokens و lock_price_per_request أسعاراً مُتحققاً منها (Verified). يتم حذفها عندما تكون deliveryAvailability.verified هي false؛ حيث تتم محاسبة هذا النموذج بسعره الرسمي (official_input_per_1m_tokens أو official_output_per_1m_tokens أو official_lock_price_per_request). قد تتضمن إدخالات التسعير المعقدة أيضاً has_complex_pricing و supported_operations و pricing_summary.

الواجهات ذات الصلة

الحصول على تسعير النموذج تُرجع أسعار نموذج واحد. تظل تفاصيل النموذج هي المصدر لحقول الطلب والعمليات المدعومة.

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

provider?string

الفلترة حسب صانع النموذج، على سبيل المثال openai أو anthropic أو google أو deepseek.

tag?string

الفلترة حسب علامة القدرة مثل reasoning أو tool-use أو vision أو text-to-image. القيم الموجودة في capabilities الخاصة بالنموذج هي علامات صالحة.

الاستجابة

application/json

application/json

application/json