الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
نظرة عامة

GET /v1/models مهيأ للاكتشاف. أما البيانات الوصفية الخاصة بالتفاصيل فقط، مثل capability_flags و pricing_provenance و public_contract الكامل، فتوجد في GET /v1/models/{model}.

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

​
category
string
فلتر اختياري للفئة العامة. يدعم chat و image و video و audio و tts و stt و music و 3d و embedding و rerank و translation.
​
recommended_for
string
سيناريو اختياري للتوصية خارج chat. يدعم image و video و music و 3d و tts و stt و embedding و rerank و translation.
​
provider
string
فلتر اختياري حسب المزود، مثل openai أو anthropic أو google أو deepseek.
​
tag
string
فلتر اختياري حسب وسم النموذج، مثل chat أو image أو video أو embedding أو translation.
عندما تكون recommended_for موجودة، يرتب /v1/models النماذج غير chat وفق أحدث لقطة مخزنة مؤقتًا لمعدل النجاح خلال 24 ساعة. تظل النماذج ذات status = "insufficient_samples" مرئية، لكنها تظهر بعد النماذج ذات النقاط.

​
الاستجابة

​
object
string
دائمًا list.
​
data
array
مصفوفة من كائنات النماذج.يحتوي كل نموذج على:
  • id (string): معرّف النموذج
  • object (string): model
  • created (integer): طابع زمني للإنشاء
  • owned_by (string): مزود النموذج
  • lemondata.category (string): الفئة العامة للنموذج
  • lemondata.pricing_unit (string or null): وحدة التسعير العامة عند توفرها
  • lemondata.capability_flags (object or null): ملخص عام للقدرات
  • lemondata.supported_operations (array or null): العمليات العامة غير chat التي يدعمها النموذج
  • lemondata.pricing_provenance (object or null): بيانات وصفية عامة لمصدر التسعير
  • lemondata.public_contract_summary (object or null): ملخص اكتشاف خفيف غير chat يحتوي فقط على public_operations و request_endpoint
  • lemondata.agent_preferences (object): يُعاد فقط عندما تكون recommended_for موجودة
curl "https://api.tokenlab.sh/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1706000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1706000000,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.5-flash",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google"
    }
  ]
}

​
التصفية حسب المزود

# الحصول على كل نماذج OpenAI
openai_models = [m for m in models.data if m.owned_by == "openai"]

# الحصول على كل نماذج Anthropic
anthropic_models = [m for m in models.data if m.owned_by == "anthropic"]

​
فئات النماذج

المزودأمثلة على النماذج
openaigpt-5.4, gpt-5.4-mini, gpt-5-mini, gpt-4o, dall-e-3
anthropicclaude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
googlegemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro
deepseekdeepseek-r1, deepseek-v3-2
xaigrok-4.1
moonshotkimi-k2.5
minimaxminimax-m2.1
metallama-3.3-70b, llama-3.1-405b

​
مثال توصية الوكيل

Response
{
  "object": "list",
  "data": [
    {
      "id": "gemini-2.5-flash-image",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google",
      "lemondata": {
        "category": "image",
        "pricing_unit": "per_request",
        "agent_preferences": {
          "image": {
            "preferred_rank": 1,
            "success_rate_24h": 0.98,
            "sample_count_24h": 423,
            "status": "ready",
            "updated_at": "2026-03-28T12:00:00.000Z",
            "basis": {
              "channel_id": null,
              "physical_model": null
            }
          }
        }
      }
    }
  ]
}