TokenLab

Essentiel

Lister les modèles

Lister les modèles actuellement disponibles sur TokenLab

GET
/v1/models

Le catalogue de modèles est public et ne nécessite pas de clé API. Chaque élément inclut un résumé des capacités actuelles, des prix et des formats API. Récupérez un modèle spécifique lorsque vous avez besoin de détails complets.

Lorsque vous fournissez une clé API, TokenLab la valide et filtre le catalogue en fonction de ses autorisations de modèle et de sa politique de livraison effective. Une clé définie sur verified liste les modèles avec une offre TokenLab Verified ; official liste les modèles avec une offre Official. Actualisez votre sélecteur de modèle lorsque la clé ou la politique de livraison change. La priorité de livraison prise en charge par la requête prévaut sur les paramètres par défaut de la clé et de l'espace de travail.

Paramètres de requête

categorystringquery

Filtrer par chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision ou translation.

recommended_forstringquery

Retourner les recommandations actuelles pour une tâche telle que image, video, music, 3d, tts, stt, embedding, rerank, decision ou translation.

providerstringquery

Filtrer par créateur de modèle, tel que openai, anthropic, google ou deepseek.

tagstringquery

Filtrer par tag de capacité tel que reasoning, tool-use, vision ou text-to-image. Les valeurs présentes dans tokenlab.capabilities d'un modèle sont des tags valides. Pour filtrer par type de modèle, utilisez category.

viewstringquerypar défaut: full

full renvoie la liste complète décrite ci-dessous. compact renvoie une liste plus courte pour la sélection de modèles : id, provider, category, capabilities, limites de jetons, résumé des prix, status, deliveryAvailability, supported_operations et request_endpoint, ainsi que view et count au niveau racine.

Réponse

objectstring
Toujours list.
dataarray
Modèles avec id, owned_by et un résumé tokenlab.

Les champs de liste courants sous tokenlab incluent :

  • tokenlab.aliases
  • tokenlab.capabilities
  • tokenlab.deliveryAvailability : support configuré pour verified et official, lorsqu'il est fourni. Un champ manquant signifie inconnu ; le support ne garantit pas la disponibilité en temps réel.
  • tokenlab.pricing : le prix Verified. Ses champs de prix sont null lorsque tokenlab.deliveryAvailability.verified est false ; un tel modèle est facturé au prix Official.
  • tokenlab.official_pricing : le prix Official. Les requêtes livrées par Official sont facturées à ce prix.
  • tokenlab.pricing_unit
  • tokenlab.max_input_tokens et tokenlab.max_output_tokens
  • tokenlab.category
  • tokenlab.lifecycle, tokenlab.commercial et tokenlab.badges
  • tokenlab.request_format_summary
  • tokenlab.agent_preferences lorsque recommended_for est utilisé

Lorsque recommended_for est utilisé, les résultats peuvent également inclure le statut de recommandation et une heure de mise à jour. Lisez la réponse actuelle au lieu de figer l'ordre.

Erreurs

StatutCodeCause
400invalid_view, invalid_provider, invalid_category, invalid_recommended_forUne valeur de requête n'est pas acceptée. Le message liste les valeurs valides. category et recommended_for doivent correspondre lorsqu'ils sont tous deux définis
401invalid_api_keyVous avez envoyé une clé API non valide. Supprimez l'en-tête pour lire la liste publique
429rate_limit_exceededTrop de requêtes vers le catalogue public. Mettez la réponse en cache et réessayez après Retry-After

Exemple

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

Voir Obtenir un modèle pour plus de détails.

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

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de requête

provider?string

Filtrer par fournisseur de modèle public, par exemple openai, anthropic, google ou minimax.

tag?string

Filtrez par une balise de capacité telle que reasoning, tool-use, vision ou text-to-image. Les valeurs dans tokenlab.capabilities d'un modèle sont des balises valides. Pour filtrer par type de modèle, utilisez category.

category?string

Filtrer par catégorie de modèle.

Valeurs possibles

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

Trier les modèles non-chat pris en charge pour une catégorie de tâche et inclure les preuves de recommandation.

Valeurs possibles

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

Choisir les champs de sélection de modèle compacts ou la forme de liste complète compatible OpenAI.

par défaut"full"

Valeurs possibles

  • "compact"
  • "full"

Réponse

application/json

application/json

application/json

application/json

application/json