الأساسيات

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

الحصول على إمكانيات النموذج، والأسعار، وتنسيقات API

GET
/v1/models/{model}

معلمة المسار

modelstringpathمطلوب

معرّف النموذج، مثل gpt-5.6-terra أو claude-sonnet-4-6.

الاستجابة

idstring
معرّف النموذج.
objectstring
دائمًا model.
owned_bystring
مطور النموذج.
tokenlabobject

معلومات نموذج TokenLab، بما في ذلك الإمكانيات، والأسعار، ووحدات الفوترة، وحدود السياق، وتنسيقات API المقبولة، والعمليات، وحالة دورة الحياة.

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

  • capabilities: إمكانيات النصوص، والصور، والفيديو، والصوت، وغيرها من الإمكانيات.
  • pricing: السعر المؤكد (Verified). وتكون حقول الأسعار الخاصة به null عندما تكون قيمة deliveryAvailability.verified هي false؛ حيث تتم فوترة مثل هذا النموذج وفقًا للسعر الرسمي (Official).
  • official_pricing: السعر الرسمي (Official). وتتم فوترة الطلبات التي يقدمها Official وفقًا لهذا السعر.
  • max_input_tokens و max_output_tokens: حدود السياق والمخرجات من الـ tokens.
  • accepted_request_formats: تنسيقات API المدعومة.
  • supported_operations: عمليات مثل text-to-image أو image-to-video.
  • request_format_summary: لكل عملية، نقطة نهاية الطلب، والمعلمات المدعومة، والقيم والنطاقات المقبولة، والحدود. يُرجى قراءتها قبل إنشاء طلب non-chat.
  • lifecycle: التوفر، أو تاريخ الإصدار، أو تاريخ الإيقاف، أو النموذج البديل.

تتضمن بعض نماذج الوسائط أيضًا حالة التوصية ووقت التحديث. يمكن أن تتغير التوصيات حسب التوفر والأداء، لذلك لا تقم بتضمين ترتيبها بشكل ثابت (hard-code).

مثال

curl "https://api.tokenlab.sh/v1/models/gpt-5.6-terra"
{
  "id": "gpt-5.6-terra",
  "object": "model",
  "owned_by": "openai",
  "tokenlab": {
    "category": "chat",
    "capabilities": ["coding", "json-mode", "prompt-cache", "reasoning", "tool-use", "vision"],
    "accepted_request_formats": ["openai_chat_completions", "openai_responses"]
  }
}

لا يلزم وجود مفتاح API. يعيد النموذج غير المعروف أو غير المتاح الرمز 404 model_not_found. للاطلاع على أسعار النموذج فقط، استخدم الحصول على أسعار النموذج.

curl -X GET "https://example.com/v1/models/string"
{  "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,    "supported_operations": [      "string"    ],    "pricing_summary": {},    "pricing_provenance": {},    "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"      ],      "supported_parameters": [        "string"      ],      "feature_flags": {        "property1": true,        "property2": true      },      "output_formats": [        "string"      ],      "service_limits": {        "online_rpm": 0,        "concurrency": 0,        "offline_inference": true,        "offline_tpd": "string",        "prompt_max_characters": 0      },      "required_selectors": [        "string"      ],      "optional_selectors": [        "string"      ],      "resolutions": [        "string"      ],      "resolutions_label": "string",      "durations": [        "string"      ],      "durations_label": "string",      "aspect_ratios": [        "string"      ],      "aspect_ratios_label": "string",      "request_endpoint": "string",      "status_mode": "string",      "request_shape_mode": "string",      "recommended_request_summary": {},      "request_endpoint_by_operation": {        "property1": "string",        "property2": "string"      },      "operation_constraints": [        {          "operation": "string",          "request_endpoint": "string",          "request_shape_mode": "string",          "status_mode": "string",          "supported_parameters": [            "string"          ],          "required_selectors": [            "string"          ],          "optional_selectors": [            "string"          ],          "documented_inputs": [            "string"          ],          "allowed_resolutions": [            "string"          ],          "allowed_durations": [            "string"          ],          "allowed_aspect_ratios": [            "string"          ],          "notes": [            "string"          ],          "parameter_options": {            "property1": [              "string"            ],            "property2": [              "string"            ]          },          "parameter_value_constraints": {            "property1": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            },            "property2": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            }          },          "parameter_ranges": {            "property1": {              "minimum": 0,              "maximum": 0            },            "property2": {              "minimum": 0,              "maximum": 0            }          },          "compatibility_only_parameters": [            "string"          ],          "parameter_defaults": {            "property1": "string",            "property2": "string"          },          "parameter_notes": {            "property1": "string",            "property2": "string"          },          "input_limits": {            "property1": {              "minItems": 0,              "maxItems": 0            },            "property2": {              "minItems": 0,              "maxItems": 0            }          }        }      ]    },    "request_format_details": {      "public_operations": [        "string"      ],      "supported_parameters": [        "string"      ],      "feature_flags": {        "property1": true,        "property2": true      },      "output_formats": [        "string"      ],      "service_limits": {        "online_rpm": 0,        "concurrency": 0,        "offline_inference": true,        "offline_tpd": "string",        "prompt_max_characters": 0      },      "required_selectors": [        "string"      ],      "optional_selectors": [        "string"      ],      "resolutions": [        "string"      ],      "resolutions_label": "string",      "durations": [        "string"      ],      "durations_label": "string",      "aspect_ratios": [        "string"      ],      "aspect_ratios_label": "string",      "request_endpoint": "string",      "status_mode": "string",      "request_shape_mode": "string",      "recommended_request_summary": {},      "request_endpoint_by_operation": {        "property1": "string",        "property2": "string"      },      "operation_constraints": [        {          "operation": "string",          "request_endpoint": "string",          "request_shape_mode": "string",          "status_mode": "string",          "supported_parameters": [            "string"          ],          "required_selectors": [            "string"          ],          "optional_selectors": [            "string"          ],          "documented_inputs": [            "string"          ],          "allowed_resolutions": [            "string"          ],          "allowed_durations": [            "string"          ],          "allowed_aspect_ratios": [            "string"          ],          "notes": [            "string"          ],          "parameter_options": {            "property1": [              "string"            ],            "property2": [              "string"            ]          },          "parameter_value_constraints": {            "property1": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            },            "property2": {              "enum": [                "string"              ],              "enumCaseInsensitive": true,              "maxItems": 0,              "maxInteger": 0,              "when": {                "parameter": "string",                "equals": "string"              }            }          },          "parameter_ranges": {            "property1": {              "minimum": 0,              "maximum": 0            },            "property2": {              "minimum": 0,              "maximum": 0            }          },          "compatibility_only_parameters": [            "string"          ],          "parameter_defaults": {            "property1": "string",            "property2": "string"          },          "parameter_notes": {            "property1": "string",            "property2": "string"          },          "input_limits": {            "property1": {              "minItems": 0,              "maxItems": 0            },            "property2": {              "minItems": 0,              "maxItems": 0            }          }        }      ],      "documented_inputs": [        "string"      ],      "documented_outputs": [        "string"      ],      "fallback_status_endpoints": [        "string"      ],      "notes": [        "string"      ],      "recommended_request": {}    },    "accepted_request_formats": [      "openai_chat_completions"    ]  }}

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

model*string

معرف النموذج

الاستجابة

application/json

application/json

application/json