TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

الأساسيات

سرد النماذج

سرد النماذج المتاحة حالياً على TokenLab

GET
/v1/models

كتالوج النماذج متاح للعامة ولا يتطلب مفتاح API. يتضمن كل عنصر ملخصاً للقدرات الحالية، والأسعار، وتنسيقات API. يمكنك استرداد نموذج واحد عندما تحتاج إلى تفاصيل كاملة.

عند تقديم مفتاح API، يقوم TokenLab بالتحقق منه وتصفية الكتالوج بناءً على أذونات النموذج وسياسة التسليم الفعالة الخاصة به. المفتاح الذي تم تعيينه كـ verified يسرد النماذج ذات التوريد المعتمد من TokenLab؛ بينما يسرد official النماذج ذات التوريد الرسمي. قم بتحديث محدد النماذج الخاص بك عند تغيير المفتاح أو سياسة التسليم. الأولوية في الطلب تكون لتجاوز التسليم المدعوم (supported delivery override) على الإعدادات الافتراضية للمفتاح ومساحة العمل.

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

categorystringquery

التصفية حسب chat، image، video، audio، tts، stt، music، 3d، embedding، rerank، أو translation.

recommended_forstringquery

إرجاع التوصيات الحالية لمهمة مثل image، video، music، 3d، tts، stt، embedding، rerank، أو translation.

providerstringquery

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

tagstringquery

التصفية حسب وسم مثل chat، image، video، embedding، أو translation.

الاستجابة (Response)

objectstring
دائماً list.
dataarray
النماذج مع id، و owned_by، وملخص tokenlab.

تشمل حقول القائمة الشائعة تحت tokenlab ما يلي:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: دعم verified و official المكون، عند توفره. الحقل المفقود يعني غير معروف؛ الدعم لا يضمن التوفر في الوقت الفعلي.
  • tokenlab.pricing: سعر Verified. تكون حقول الأسعار فيه null عندما تكون قيمة tokenlab.deliveryAvailability.verified هي false؛ ويُحتسب سعر هذا النموذج وفق سعر Official.
  • tokenlab.official_pricing: سعر Official. تُحتسب الطلبات التي ينفذها Official وفق هذا السعر.
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens و tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle، و tokenlab.commercial، و tokenlab.badges
  • tokenlab.request_format_summary
  • tokenlab.agent_preferences عند استخدام recommended_for

عند استخدام recommended_for، قد تتضمن النتائج أيضاً حالة التوصية ووقت التحديث. اقرأ الاستجابة الحالية بدلاً من تثبيت الترتيب.

مثال

curl "https://api.tokenlab.sh/v1/models?category=video"
{
  "object": "list",
  "data": [
    {
      "id": "veo3.1",
      "object": "model",
      "owned_by": "google",
      "tokenlab": {
        "category": "video",
        "capabilities": ["text-to-video", "image-to-video"]
      }
    }
  ]
}

راجع الحصول على نموذج للحصول على التفاصيل الكاملة.

curl -X GET "https://example.com/v1/models"
{  "object": "list",  "data": [    {      "id": "string",      "object": "model",      "created": 0,      "owned_by": "string",      "tokenlab": {        "aliases": [          "string"        ],        "deliveryAvailability": {          "verified": true,          "official": true,          "operations": {            "property1": {              "verified": true,              "official": true            },            "property2": {              "verified": true,              "official": true            }          }        },        "pricing": {          "input_per_1m": "string",          "output_per_1m": "string",          "per_request": "string",          "is_lock_price": true,          "currency": "USD"        },        "official_pricing": {          "input_per_1m": "string",          "output_per_1m": "string",          "per_request": "string",          "is_lock_price": true,          "currency": "USD"        },        "capabilities": [          "string"        ],        "providers": [          "string"        ],        "max_input_tokens": 0,        "max_output_tokens": 0,        "category": "string",        "pricing_unit": "string",        "cache_pricing": {},        "official_cache_pricing": {},        "has_complex_pricing": true,        "pricing_summary": {},        "agent_preferences": {},        "lifecycle": {          "stage": "active",          "reason": "string",          "replacement_model": "string",          "released_at": "2019-08-24T14:15:22Z",          "deprecated_at": "2019-08-24T14:15:22Z",          "retired_at": "2019-08-24T14:15:22Z",          "sunset_at": "2019-08-24T14:15:22Z",          "latest": true,          "latest_source": "auto",          "latest_window_days": 0        },        "commercial": {          "user_charge_policy": "paid",          "free_reason": "platform",          "free_until": "2019-08-24T14:15:22Z"        },        "badges": [          {            "key": "free",            "tone": "green",            "priority": 0,            "tooltip": {              "key": "string",              "values": {                "property1": "string",                "property2": "string"              }            }          }        ],        "request_format_summary": {          "public_operations": [            "string"          ],          "request_endpoint": "string",          "request_endpoint_by_operation": {            "property1": "string",            "property2": "string"          }        }      }    }  ]}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

provider?string

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

tag?string

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

category?string

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

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

  • "chat"
  • "embedding"
  • "translation"
  • "image"
  • "video"
  • "audio"
  • "tts"
  • "stt"
  • "rerank"
  • "3d"
  • "music"
  • "decision"
recommended_for?string

فرز النماذج المدعومة غير المتعلقة بالمحادثة لفئة مهمة وتضمين أدلة التوصية.

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

  • "image"
  • "video"
  • "music"
  • "3d"
  • "tts"
  • "stt"
  • "embedding"
  • "rerank"
  • "translation"
view?string

اختر حقول اختيار النموذج المدمجة أو شكل القائمة الكامل المتوافق مع OpenAI.

الافتراضي"full"

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

  • "compact"
  • "full"

الاستجابة

application/json

application/json

application/json

application/json

application/json

مرجع API

السابق

الحصول على نموذج

التالي