TokenLab

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.sh

Authentification

Les requêtes de modèle utilisent une clé API TokenLab. L’en-tête d’authentification standard est :

Authorization: Bearer sk-your-api-key

GET /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.

  • Auto utilise TokenLab Verified lorsqu’il est disponible, puis Official si nécessaire. Vous payez pour l’option qui complète votre requête.
  • TokenLab Verified est une livraison vérifiée par TokenLab. Le prix Verified s’applique.
  • Official facture 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

EndpointMéthodeDescription
/v1/chat/completionsPOSTComplétions de chat compatibles OpenAI
/v1/messagesPOSTMessages compatibles Anthropic
/v1/messages/count_tokensPOSTCompter les jetons d’entrée d’une requête Messages
/v1/messages/batchesPOST, GETCréer et lister des lots de messages
/v1/messages/batches/{message_batch_id}GET, DELETERécupérer ou supprimer un lot de messages
/v1/messages/batches/{message_batch_id}/resultsGETLire les résultats
/v1/messages/batches/{message_batch_id}/cancelPOSTAnnuler un lot de messages
/v1/responsesPOSTAPI OpenAI Responses
/v1/responses/{id}GET, DELETERécupérer ou supprimer une réponse stockée
/v1/responses/compactPOSTCompacter le contexte d’une conversation Responses
/v1/translationsPOSTTraduction texte-à-texte

Embeddings & Rerank

EndpointMéthodeDescription
/v1/embeddingsPOSTCréer des embeddings de texte
/v1/multimodal/embeddingsPOSTCréer des embeddings avec un modèle multimodal
/v1/rerankPOSTRéordonner des documents

Décisions

EndpointMéthodeDescription
/v1/systemonePOSTÉvaluer des questions de décision typées

Fichiers & Lots

EndpointMéthodeDescription
/v1/filesPOST, GETTéléverser et lister des fichiers
/v1/files/{file_id}GET, DELETERécupérer ou supprimer un fichier
/v1/files/{file_id}/contentGETTélécharger le contenu d’un fichier
/v1/batchesPOST, GETCréer et lister des lots
/v1/batches/{batch_id}GETRécupérer un lot
/v1/batches/{batch_id}/cancelPOSTAnnuler un lot

Images

EndpointMéthodeDescription
/v1/images/generationsPOSTGénérer des images à partir de texte
/v1/images/editsPOSTÉditer des images
/v1/images/variationsPOSTCréer des variations d’images
/v1/images/generations/{id}GETChemin 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

EndpointMéthodeDescription
/v1/audio/speechPOSTSynthèse vocale (TTS)
/v1/audio/transcriptionsPOSTReconnaissance vocale (STT)
/v1/audio/translationsPOSTTraduire la parole en texte anglais

Temps réel

EndpointMéthodeDescription
/v1/realtime?model={model}WSSessions 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

EndpointMéthodeDescription
/v1/videos/generationsPOSTCréer une tâche de génération vidéo
/v1/videos/generations/{id}GETChemin de statut de compatibilité
/v1/videos/assetsPOST, GETCréer et lister des ressources matérielles Seedance
/api/v3/contents/generations/tasksPOST, GETTâ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

EndpointMéthodeDescription
/v1/tasks/{id}GETStatut pour toute tâche asynchrone
/v1/tasks/{id}DELETEAnnuler 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

EndpointMéthodeDescription
/v1/music/generationsPOSTCréer une tâche de génération musicale
/v1/music/generations/{id}GETChemin de statut de compatibilité

Génération 3D

EndpointMéthodeDescription
/v1/3d/generationsPOSTCréer une tâche de génération de modèle 3D
/v1/3d/generations/{id}GETChemin de statut de compatibilité

Worlds

EndpointMéthodeDescription
/v1/worlds/generationsPOSTCréer une tâche de génération de monde
/v1/worlds/listPOSTLister les mondes
/v1/worlds/{id}GET, DELETERécupérer ou supprimer un monde
/v1/worlds/media-assets/prepare-uploadPOSTPréparer un téléversement de ressource média

Modèles & Tarification

EndpointMéthodeDescription
/v1/modelsGETLister tous les modèles disponibles
/v1/models/{model}GETObtenir les infos d’un modèle spécifique
/v1/models/{model}/pricingGETObtenir les prix d’un modèle
/v1/pricingGETLister les prix des modèles

Gemini (v1beta)

Prise en charge native du format API Google Gemini :

EndpointMéthodeDescription
/v1beta/modelsGETLister les modèles acceptant les requêtes Gemini
/v1beta/models/{model}GETObtenir un modèle
/v1beta/models/{model}:generateContentPOSTGénérer du contenu
/v1beta/models/{model}:streamGenerateContentPOSTGénérer du contenu en flux
/v1beta/models/{model}:countTokensPOSTCompter les jetons
/v1beta/files, /v1beta/cachedContentsPOST, GET, DELETEFichiers 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êteDescription
X-Request-IDIdentifiant de requête pour le support et le débogage
X-Routing-Time-MSNon-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-IDIdentifiant de tâche asynchrone public pour les réponses basées sur des tâches
X-Billing-Transaction-IDIdentifiant 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

Sur cette page