الأساسيات

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

الحصول على أسعار نموذج محدد، مع فئات الأسعار التابعة لها

GET
/v1/models/{model}/pricing

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

معامل المسار

modelstringpathمطلوب

معرّف النموذج، مثل gpt-5.6-terra.

الاستجابة

modelstring
معرّف النموذج.
pricing_unitstring
وحدة الفوترة، مثل per_token.
deliveryAvailabilityobject

ما إذا كان النموذج يحتوي على توريد verified وofficial، ونفس الشيء لكل عملية.

scalar_pricingobject

السعر المعتمد (Verified) بالدولار الأمريكي (USD): input_per_1m وoutput_per_1m وper_request وis_lock_price. تكون حقول الأسعار null عندما تكون قيمة deliveryAvailability.verified هي false؛ وتتم فوترة مثل هذا النموذج بسعر Official.

official_scalar_pricingobject

السعر الرسمي (Official) بنفس الهيكل. تتم فوترة الطلبات التي يقدمها Official بهذا السعر.

has_complex_pricingboolean

تكون true عندما يعتمد السعر على أكثر من معدل، مثل حجم الإدخال، أو الدقة، أو المدة. راجع pricing_details وpricing_summary في هذه الحالة.

pricing_summaryobject | null

أدنى وأعلى سعر للنموذج.

pricing_detailsobject | null

فئات الأسعار: يُدرج كل مدخل الشروط التي ينطبق عليها وأسعاره.

supported_operationsstring[]
العمليات التي تغطيها الأسعار.

يُرجع النموذج غير المعروف أو غير المتاح 404 model_not_found.

الطلب

cURL
curl "https://api.tokenlab.sh/v1/models/text-embedding-3-small/pricing"

الاستجابة

Response
{
  "model": "text-embedding-3-small",
  "pricing_unit": "per_token",
  "has_complex_pricing": false,
  "supported_operations": ["embedding"],
  "deliveryAvailability": { "verified": false, "official": true },
  "scalar_pricing": {
    "input_per_1m": null,
    "output_per_1m": null,
    "per_request": null,
    "is_lock_price": false,
    "currency": "USD"
  },
  "official_scalar_pricing": {
    "input_per_1m": "0.02",
    "output_per_1m": "0",
    "per_request": null,
    "is_lock_price": false,
    "currency": "USD"
  }
}

يوضح هذا المثال شكل الاستجابة. الأسعار قابلة للتغيير؛ يُرجى مراجعة الاستجابة المباشرة.

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

model*string

معرف النموذج

الاستجابة

application/json

application/json

application/json