Essentiel
Référence de l’API
Endpoints, authentification, en-têtes de réponse et erreurs
Aperçu
TokenLab prend en charge les endpoints compatibles avec OpenAI ainsi que les formats de requête Anthropic et Gemini. Les clients OpenAI existants peuvent utiliser /v1 ; choisissez un autre format uniquement lorsque votre application nécessite un comportement spécifique à cette API. POST /v1/responses est optionnel et dépend de la prise en charge par le modèle.
URL de base
https://api.tokenlab.shAuthentification
Les requêtes de modèle utilisent une clé API TokenLab. L’en-tête d’authentification standard est :
Authorization: Bearer sk-your-api-keyGET /v1/models, GET /v1/models/{model}, GET /v1/models/{model}/pricing et GET /v1/pricing sont publics et ne nécessitent aucune clé. Anthropic Messages accepte également x-api-key ; Gemini accepte x-goog-api-key ou ?key= ainsi que l’authentification Bearer. /v1/management/* nécessite un jeton de gestion (mt-...).
Obtenez votre clé API depuis la Console.
Politique de livraison
Les requêtes de génération acceptent X-TokenLab-Delivery-Policy: auto | verified | official. Un en-tête de requête remplace le paramètre de la clé API, qui remplace lui-même la valeur par défaut de l’Espace de travail.
Autoutilise TokenLab Verified lorsqu’il est disponible, puis Official si nécessaire. Vous payez pour l’option qui complète votre requête.TokenLab Verifiedest une livraison vérifiée par TokenLab. Le prix Verified s’applique.Officialfacture le prix Official, qui correspond au prix publié par le créateur du modèle.- Les sessions en temps réel utilisent la clé API ou le paramètre de l’Espace de travail et n’acceptent pas de remplacement par requête.
Un en-tête invalide renvoie 400. Si l’option demandée n’est pas disponible, TokenLab renvoie 503 delivery_tier_unavailable et un ID de requête. Lisez retryable : lorsque l’opération sélectionnée n’a pas de disponibilité, il est false. Ne répétez pas la même requête sans modification.
Les pages API avec un formulaire de requête acceptent votre clé API TokenLab et envoient des requêtes réelles. Ces requêtes utilisent le solde et les limites de votre compte. Vous pouvez également utiliser cURL, Postman ou un SDK.
Endpoints pris en charge
Chat & Génération de texte
| Endpoint | Méthode | Description |
|---|---|---|
/v1/chat/completions | POST | Complétions de chat compatibles OpenAI |
/v1/messages | POST | Messages compatibles Anthropic |
/v1/messages/count_tokens | POST | Compter les jetons d’entrée d’une requête Messages |
/v1/messages/batches | POST, GET | Créer et lister des lots de messages |
/v1/messages/batches/{message_batch_id} | GET, DELETE | Récupérer ou supprimer un lot de messages |
/v1/messages/batches/{message_batch_id}/results | GET | Lire les résultats |
/v1/messages/batches/{message_batch_id}/cancel | POST | Annuler un lot de messages |
/v1/responses | POST | API OpenAI Responses |
/v1/responses/{id} | GET, DELETE | Récupérer ou supprimer une réponse stockée |
/v1/responses/compact | POST | Compacter le contexte d’une conversation Responses |
/v1/translations | POST | Traduction texte-à-texte |
Embeddings & Rerank
| Endpoint | Méthode | Description |
|---|---|---|
/v1/embeddings | POST | Créer des embeddings de texte |
/v1/multimodal/embeddings | POST | Créer des embeddings avec un modèle multimodal |
/v1/rerank | POST | Réordonner des documents |
Décisions
| Endpoint | Méthode | Description |
|---|---|---|
/v1/systemone | POST | Évaluer des questions de décision typées |
Fichiers & Lots
| Endpoint | Méthode | Description |
|---|---|---|
/v1/files | POST, GET | Téléverser et lister des fichiers |
/v1/files/{file_id} | GET, DELETE | Récupérer ou supprimer un fichier |
/v1/files/{file_id}/content | GET | Télécharger le contenu d’un fichier |
/v1/batches | POST, GET | Créer et lister des lots |
/v1/batches/{batch_id} | GET | Récupérer un lot |
/v1/batches/{batch_id}/cancel | POST | Annuler un lot |
Images
| Endpoint | Méthode | Description |
|---|---|---|
/v1/images/generations | POST | Générer des images à partir de texte |
/v1/images/edits | POST | Éditer des images |
/v1/images/variations | POST | Créer des variations d’images |
/v1/images/generations/{id} | GET | Chemin de statut de compatibilité pour les réponses d’image basées sur des tâches |
Les modèles d’image peuvent renvoyer une image terminée ou une tâche asynchrone. Si la réponse inclut status: "pending" ou un ID de tâche, interrogez GET /v1/tasks/{id}.
Audio
| Endpoint | Méthode | Description |
|---|---|---|
/v1/audio/speech | POST | Synthèse vocale (TTS) |
/v1/audio/transcriptions | POST | Reconnaissance vocale (STT) |
/v1/audio/translations | POST | Traduire la parole en texte anglais |
Temps réel
| Endpoint | Méthode | Description |
|---|---|---|
/v1/realtime?model={model} | WS | Sessions WebSocket en temps réel |
Utilisez /v1/realtime pour les mises à niveau WebSocket. Un simple GET /v1/realtime renvoie les métadonnées de l’endpoint. Ce n’est pas la surface REST OpenAI Realtime ; les endpoints client-secret, Calls et les sessions bêta héritées ne sont pas disponibles.
Vidéo
| Endpoint | Méthode | Description |
|---|---|---|
/v1/videos/generations | POST | Créer une tâche de génération vidéo |
/v1/videos/generations/{id} | GET | Chemin de statut de compatibilité |
/v1/videos/assets | POST, GET | Créer et lister des ressources matérielles Seedance |
/api/v3/contents/generations/tasks | POST, GET | Tâches Seedance avec le format de requête Volcengine |
Interrogez GET /v1/tasks/{id} avec l’id de la tâche. /v1/videos/generations/{id} reste disponible pour les intégrations existantes.
Tâches asynchrones
| Endpoint | Méthode | Description |
|---|---|---|
/v1/tasks/{id} | GET | Statut pour toute tâche asynchrone |
/v1/tasks/{id} | DELETE | Annuler une tâche asynchrone |
Interrogez GET /v1/tasks/{id} pour chaque tâche asynchrone : images, vidéo, musique, 3D, Worlds et transcription audio asynchrone. Utilisez l’id ou le task_id de la réponse de création. Une réponse de création Worlds renvoie une poll_url sous /v1/worlds/generations/{id} ; interrogez /v1/tasks/{id} également à cet endroit. Les chemins de statut par modalité sur cette page sont des endpoints de compatibilité pour les intégrations existantes.
Musique
| Endpoint | Méthode | Description |
|---|---|---|
/v1/music/generations | POST | Créer une tâche de génération musicale |
/v1/music/generations/{id} | GET | Chemin de statut de compatibilité |
Génération 3D
| Endpoint | Méthode | Description |
|---|---|---|
/v1/3d/generations | POST | Créer une tâche de génération de modèle 3D |
/v1/3d/generations/{id} | GET | Chemin de statut de compatibilité |
Worlds
| Endpoint | Méthode | Description |
|---|---|---|
/v1/worlds/generations | POST | Créer une tâche de génération de monde |
/v1/worlds/list | POST | Lister les mondes |
/v1/worlds/{id} | GET, DELETE | Récupérer ou supprimer un monde |
/v1/worlds/media-assets/prepare-upload | POST | Préparer un téléversement de ressource média |
Modèles & Tarification
| Endpoint | Méthode | Description |
|---|---|---|
/v1/models | GET | Lister tous les modèles disponibles |
/v1/models/{model} | GET | Obtenir les infos d’un modèle spécifique |
/v1/models/{model}/pricing | GET | Obtenir les prix d’un modèle |
/v1/pricing | GET | Lister les prix des modèles |
Gemini (v1beta)
Prise en charge native du format API Google Gemini :
| Endpoint | Méthode | Description |
|---|---|---|
/v1beta/models | GET | Lister les modèles acceptant les requêtes Gemini |
/v1beta/models/{model} | GET | Obtenir un modèle |
/v1beta/models/{model}:generateContent | POST | Générer du contenu |
/v1beta/models/{model}:streamGenerateContent | POST | Générer du contenu en flux |
/v1beta/models/{model}:countTokens | POST | Compter les jetons |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | Fichiers Gemini et contenu mis en cache |
Les endpoints Gemini prennent en charge l’authentification par paramètre de requête ?key= en plus du jeton Bearer standard.
Gestion
/v1/management/* gère le solde, les clés API et les webhooks avec un jeton de gestion. Voir l’API de gestion.
Format de réponse
Chaque endpoint préserve son format API. Les exemples de succès et d’erreur ci-dessous utilisent le format Chat Completions.
Réponse de succès
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-5.6-terra",
"choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 20,
"total_tokens": 30
}
}En-têtes de réponse
Utilisez ces en-têtes lorsqu’ils sont présents.
| En-tête | Description |
|---|---|
X-Request-ID | Identifiant de requête pour le support et le débogage |
X-Routing-Time-MS | Non-streaming : durée totale en millisecondes jusqu’à la réponse de l’amont, y compris sa file d’attente et l’inférence. Streaming : toujours 0. Ne mesure ni le routage ni la file d’attente. |
X-Task-ID | Identifiant de tâche asynchrone public pour les réponses basées sur des tâches |
X-Billing-Transaction-ID | Identifiant de transaction de facturation après facturation finale |
Les rejets de requête officiels peuvent inclure upstream avec l’erreur signalée par le service et le nom du service public. Voir Gérer les erreurs API.
Réponse d’erreur
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}Limites de débit
Les limites dépendent du niveau de compte et s’appliquent par clé API. Une réponse 429 contient Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Voir Limites de débit pour les niveaux et comment réessayer.
Spécification OpenAPI
Spécification OpenAPI
Téléchargez la spécification complète OpenAPI 3.1