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

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

model
string
مطلوب
معرّف النموذج المراد استرجاعه (على سبيل المثال، gpt-5.4 أو claude-sonnet-4-6).

الاستجابة

id
string
معرّف النموذج. ويتضمن أيضًا lifecycle وcommercial وbadges لحالة الإيقاف/التقاعد وسياسة الرسوم والشارات.
object
string
دائمًا model.
created
integer
طابع زمني للإنشاء.
owned_by
string
مزود النموذج.
tokenlab
object
بيانات وصفية عامة خاصة بـ TokenLab. قد تتضمن مسار التفاصيل category و pricing_unit و capability_flags و supported_operations و pricing_provenance و request_format_summary و request_format_details الكامل و agent_preferences على مستوى السيناريو للقطات التوصية غير chat.
curl "https://api.tokenlab.sh/v1/models/gpt-5.4" \
  -H "Authorization: Bearer sk-your-api-key"
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

model = client.models.retrieve("gpt-5.4")
print(f"Model: {model.id}, Provider: {model.owned_by}")
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.tokenlab.sh/v1'
});

const model = await client.models.retrieve('gpt-5.4');
console.log(`Model: ${model.id}, Provider: ${model.owned_by}`);
package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.tokenlab.sh/v1/models/gpt-5.4", nil)
    req.Header.Set("Authorization", "Bearer sk-your-api-key")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()

    var model map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&model)
    fmt.Printf("Model: %s, Provider: %s\n", model["id"], model["owned_by"])
}
<?php
$ch = curl_init('https://api.tokenlab.sh/v1/models/gpt-5.4');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk-your-api-key'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$model = json_decode($response, true);
echo "Model: {$model['id']}, Provider: {$model['owned_by']}\n";
{
  "id": "gpt-5.4",
  "object": "model",
  "created": 1706000000,
  "owned_by": "openai"
}

معالجة الأخطاء

إذا لم يكن النموذج موجودًا، فستتلقى خطأ 404:
{
  "error": {
    "message": "Model 'invalid-model' not found",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}

بيانات التوصية للنماذج غير chat

بالنسبة للنماذج غير chat، تُرجع صفحة التفاصيل أيضًا tokenlab.agent_preferences.<scene>. استخدمها لفحص:
  • preferred_rank
  • success_rate_24h
  • sample_count_24h
  • status
  • updated_at
تلخص الاستجابة العامة مصدر التوصية عبر basis.source ولا تكشف معرّفات التوجيه.

بيانات التفاصيل العامة

بالمقارنة مع GET /v1/models، يمكن لصفحة التفاصيل أن تعيد أيضًا:
  • tokenlab.capability_flags
  • tokenlab.supported_operations
  • tokenlab.pricing_provenance
  • tokenlab.request_format_summary
  • tokenlab.request_format_details

حذف النماذج

DELETE /v1/models/{model} غير مدعوم. نماذج TokenLab كتالوج عام مشترك وليست موارد نماذج fine-tuned يملكها المستخدم.