Essentiel
Lister les modèles
Lister les modèles actuellement disponibles sur TokenLab
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
Filtrer par chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, decision ou translation.
Retourner les recommandations actuelles pour une tâche telle que image, video, music, 3d, tts, stt, embedding, rerank, decision ou translation.
Filtrer par créateur de modèle, tel que openai, anthropic, google ou deepseek.
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.
fullfull 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
list.id, owned_by et un résumé tokenlab.Les champs de liste courants sous tokenlab incluent :
tokenlab.aliasestokenlab.capabilitiestokenlab.deliveryAvailability: support configuré pourverifiedetofficial, 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 sontnulllorsquetokenlab.deliveryAvailability.verifiedestfalse; 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_unittokenlab.max_input_tokensettokenlab.max_output_tokenstokenlab.categorytokenlab.lifecycle,tokenlab.commercialettokenlab.badgestokenlab.request_format_summarytokenlab.agent_preferenceslorsquerecommended_forest 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
| Statut | Code | Cause |
|---|---|---|
400 | invalid_view, invalid_provider, invalid_category, invalid_recommended_for | Une 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 |
401 | invalid_api_key | Vous avez envoyé une clé API non valide. Supprimez l'en-tête pour lire la liste publique |
429 | rate_limit_exceeded | Trop 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 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
Filtrer par fournisseur de modèle public, par exemple openai, anthropic, google ou minimax.
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.
Filtrer par catégorie de modèle.
Valeurs possibles
- "chat"
- "embedding"
- "translation"
- "image"
- "video"
- "audio"
- "tts"
- "stt"
- "rerank"
- "3d"
- "music"
- "decision"
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"
Choisir les champs de sélection de modèle compacts ou la forme de liste complète compatible OpenAI.
"full"Valeurs possibles
- "compact"
- "full"
Réponse
application/json
application/json
application/json
application/json
application/json