الأساسيات
سرد النماذج
سرد النماذج المتاحة حالياً على TokenLab
كتالوج النماذج عام ولا يتطلب مفتاح API. يتضمن كل عنصر ملخصاً للقدرات الحالية، والأسعار، وتنسيقات API. يمكنك استرداد نموذج واحد عندما تحتاج إلى تفاصيل كاملة.
عند تقديم مفتاح API، يقوم TokenLab بالتحقق منه وتصفية الكتالوج بناءً على أذونات النماذج الخاصة به وسياسة التسليم الفعالة. المفتاح الذي تم ضبطه على verified يسرد النماذج ذات التوريد المعتمد من TokenLab؛ بينما يسرد official النماذج ذات التوريد الرسمي. قم بتحديث محدد النماذج الخاص بك عند تغيير المفتاح أو سياسة التسليم. الأولوية في التجاوز المدعوم للتسليم في الطلب تكون أعلى من إعدادات المفتاح ومساحة العمل الافتراضية.
معلمات الاستعلام (Query Parameters)
التصفية حسب chat أو image أو video أو audio أو tts أو stt أو music أو 3d أو embedding أو rerank أو decision أو translation.
إرجاع التوصيات الحالية لمهمة مثل image أو video أو music أو 3d أو tts أو stt أو embedding أو rerank أو decision أو translation.
التصفية حسب صانع النموذج، مثل openai أو anthropic أو google أو deepseek.
التصفية حسب وسم القدرة مثل reasoning أو tool-use أو vision أو text-to-image. القيم الموجودة في tokenlab.capabilities الخاصة بالنموذج هي وسوم صالحة. للتصفية حسب نوع النموذج، استخدم category.
fullfull تُرجع شكل القائمة الكامل الموصوف أدناه. compact تُرجع قائمة أصغر لاختيار النموذج: id و provider و category و capabilities وحدود الرموز (token limits) وملخص السعر و status و deliveryAvailability و supported_operations و request_endpoint، بالإضافة إلى view و count في المستوى الأعلى.
الاستجابة (Response)
list.id و owned_by وملخص tokenlab.تشمل حقول القائمة الشائعة تحت tokenlab ما يلي:
tokenlab.aliasestokenlab.capabilitiestokenlab.deliveryAvailability: دعمverifiedوofficialالمكون، عند توفره. الحقل المفقود يعني غير معروف؛ الدعم لا يضمن التوفر في الوقت الفعلي.tokenlab.pricing: السعر المعتمد (Verified). تكون حقول السعر الخاصة بهnullعندما تكونtokenlab.deliveryAvailability.verifiedهيfalse؛ تتم محاسبة مثل هذا النموذج بالسعر الرسمي (Official).tokenlab.official_pricing: السعر الرسمي (Official). الطلبات التي يتم تسليمها عبر Official تتم محاسبتها بهذا السعر.tokenlab.pricing_unittokenlab.max_input_tokensوtokenlab.max_output_tokenstokenlab.categorytokenlab.lifecycleوtokenlab.commercialوtokenlab.badgestokenlab.request_format_summarytokenlab.agent_preferencesعند استخدامrecommended_for
عند استخدام recommended_for، قد تتضمن النتائج أيضاً حالة التوصية ووقت التحديث. اقرأ الاستجابة الحالية بدلاً من تثبيت الترتيب.
الأخطاء (Errors)
| الحالة | الرمز | السبب |
|---|---|---|
400 | invalid_view, invalid_provider, invalid_category, invalid_recommended_for | قيمة الاستعلام غير مقبولة. تسرد الرسالة القيم الصالحة. يجب أن تتطابق category و recommended_for عند ضبط كليهما |
401 | invalid_api_key | أرسلت مفتاح API غير صالح. قم بإزالة الترويسة لقراءة القائمة العامة |
429 | rate_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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات الاستعلام
التصفية حسب مزود النموذج العام، على سبيل المثال openai أو anthropic أو google أو minimax.
التصفية حسب وسم القدرة مثل reasoning أو tool-use أو vision أو text-to-image. القيم الموجودة في tokenlab.capabilities الخاصة بالنموذج هي وسوم صالحة. للتصفية حسب نوع النموذج، استخدم category.
التصفية حسب فئة النموذج.
القيم المتاحة
- "chat"
- "embedding"
- "translation"
- "image"
- "video"
- "audio"
- "tts"
- "stt"
- "rerank"
- "3d"
- "music"
- "decision"
فرز النماذج المدعومة غير المتعلقة بالمحادثة لفئة مهمة وتضمين أدلة التوصية.
القيم المتاحة
- "image"
- "video"
- "music"
- "3d"
- "tts"
- "stt"
- "embedding"
- "rerank"
- "translation"
- "decision"
اختر حقول اختيار النموذج المدمجة أو شكل القائمة الكامل المتوافق مع OpenAI.
"full"القيم المتاحة
- "compact"
- "full"
الاستجابة
application/json
application/json
application/json
application/json
application/json