Temel

Modelleri Listele

TokenLab üzerinde halihazırda mevcut olan modelleri listeler

GET
/v1/models

Model kataloğu herkese açıktır ve API anahtarı gerektirmez. Her öğe; mevcut yeteneklerin, fiyatların ve API formatlarının bir özetini içerir. Tam detaylara ihtiyaç duyduğunuzda tek bir modeli getirin.

Bir API anahtarı sağladığınızda, TokenLab bunu doğrular ve kataloğu anahtarın model izinlerine ve geçerli teslimat politikasına göre filtreler. verified olarak ayarlanmış bir anahtar, TokenLab Verified tedarikine sahip modelleri; official ise Official tedarikine sahip modelleri listeler. Anahtar veya teslimat politikası değiştiğinde model seçicinizi yenileyin. İsteğin desteklenen teslimat geçersiz kılma ayarı (override), anahtar ve çalışma alanı varsayılanlarına göre önceliklidir.

Sorgu Parametreleri

categorystringquery

chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision veya translation değerlerine göre filtreleyin.

recommended_forstringquery

image, video, music, 3d, tts, stt, embedding, rerank, decision veya translation gibi bir görev için güncel önerileri döndürün.

providerstringquery

openai, anthropic, google veya deepseek gibi model üreticisine göre filtreleyin.

tagstringquery

reasoning, tool-use, vision veya text-to-image gibi bir yetenek etiketine göre filtreleyin. Bir modelin tokenlab.capabilities alanındaki değerler geçerli etiketlerdir. Model türüne göre filtrelemek için category kullanın.

viewstringqueryvarsayılan: full

full, aşağıda açıklanan tam liste yapısını döndürür. compact, model seçimi için daha küçük bir liste döndürür: id, provider, category, capabilities, token limitleri, fiyat özeti, status, deliveryAvailability, supported_operations, request_endpoint ve en üst düzeyde view ile count.

Yanıt

objectstring
Her zaman list değerini alır.
dataarray
id, owned_by ve bir tokenlab özeti içeren modeller.

tokenlab altındaki yaygın liste alanları şunlardır:

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability: sağlandığında yapılandırılmış verified ve official desteği. Eksik bir alan bilinmediği anlamına gelir; destek, gerçek zamanlı kullanılabilirliği garanti etmez.
  • tokenlab.pricing: Verified fiyatı. tokenlab.deliveryAvailability.verified değeri false olduğunda fiyat alanları null olur; böyle bir model Official fiyatı üzerinden faturalandırılır.
  • tokenlab.official_pricing: Official fiyatı. Official teslimatlı istekler bu fiyat üzerinden faturalandırılır.
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens ve tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle, tokenlab.commercial ve tokenlab.badges
  • tokenlab.request_format_summary
  • recommended_for kullanıldığında tokenlab.agent_preferences

recommended_for kullanıldığında, sonuçlar öneri durumunu ve güncelleme zamanını da içerebilir. Sıralamayı sabitlemek yerine güncel yanıtı okuyun.

Hatalar

DurumKodNeden
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forBir sorgu değeri kabul edilmiyor. Mesaj, geçerli değerleri listeler. Her ikisi de ayarlandığında category ve recommended_for eşleşmelidir
401invalid_api_keyGeçersiz bir API anahtarı gönderdiniz. Herkese açık listeyi okumak için başlığı kaldırın
429rate_limit_exceededHalka açık kataloğa çok fazla istek gönderildi. Yanıtı önbelleğe alın ve Retry-After süresinden sonra tekrar deneyin

Örnek

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"]
      }
    }
  ]
}

Tam detaylar için Bir Model Al bölümüne bakın.

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"          }        }      }    }  ]}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Sorgu parametreleri

provider?string

openai, anthropic, google veya minimax gibi genel model sağlayıcısına göre filtrele.

tag?string

reasoning, tool-use, vision veya text-to-image gibi bir yetenek etiketiyle filtreleyin. Bir modelin tokenlab.capabilities içindeki değerler geçerli etiketlerdir. Model türüne göre filtrelemek için category kullanın.

category?string

Model kategorisine göre filtrele.

Geçerli değerler

  • "chat"
  • "embedding"
  • "translation"
  • "image"
  • "video"
  • "audio"
  • "tts"
  • "stt"
  • "rerank"
  • "3d"
  • "music"
  • "decision"
recommended_for?string

Bir görev kategorisi için desteklenen sohbet dışı modelleri sırala ve öneri kanıtlarını dahil et.

Geçerli değerler

  • "image"
  • "video"
  • "music"
  • "3d"
  • "tts"
  • "stt"
  • "embedding"
  • "rerank"
  • "translation"
  • "decision"
view?string

Kompakt model seçim alanlarını veya tam OpenAI uyumlu liste şeklini seçin.

varsayılan"full"

Geçerli değerler

  • "compact"
  • "full"

Yanıt

application/json

application/json

application/json

application/json

application/json