الأساسيات

سرد النماذج

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

GET
/v1/models

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

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

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

categorystringquery

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

recommended_forstringquery

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

providerstringquery

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

tagstringquery

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

viewstringqueryالافتراضي: full

full تُرجع شكل القائمة الكامل الموصوف أدناه. compact تُرجع قائمة أصغر لاختيار النموذج: id و provider و category و capabilities وحدود الرموز (token limits) وملخص السعر و status و deliveryAvailability و supported_operations و request_endpoint، بالإضافة إلى view و count في المستوى الأعلى.

الاستجابة (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، قد تتضمن النتائج أيضاً حالة التوصية ووقت التحديث. اقرأ الاستجابة الحالية بدلاً من تثبيت الترتيب.

الأخطاء (Errors)

الحالةالرمزالسبب
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forقيمة الاستعلام غير مقبولة. تسرد الرسالة القيم الصالحة. يجب أن تتطابق category و recommended_for عند ضبط كليهما
401invalid_api_keyأرسلت مفتاح API غير صالح. قم بإزالة الترويسة لقراءة القائمة العامة
429rate_limit_exceededالكثير من الطلبات إلى الكتالوج العام. قم بتخزين الاستجابة مؤقتاً وأعد المحاولة بعد Retry-After

مثال

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

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

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"
  • "decision"
view?string

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

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

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

  • "compact"
  • "full"

الاستجابة

application/json

application/json

application/json

application/json

application/json