Référence de l’API

AperçuCopy Anchor Link

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 baseCopy Anchor Link

https://api.tokenlab.sh

AuthentificationCopy Anchor Link

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} 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 livraisonCopy Anchor Link

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 (Workspace).

• 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 est facturé au prix Official, c’est-à-dire le prix public du 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 chaîne de requête (query-string).

Un en-tête invalide renvoie 400. Si l’option demandée n’est pas disponible, TokenLab renvoie 503 delivery_tier_unavailable ainsi qu’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.

Endpoints pris en chargeCopy Anchor Link

Chat & Génération de texteCopy Anchor Link

Embeddings & RerankCopy Anchor Link

ImagesCopy Anchor Link

AudioCopy Anchor Link

Temps réelCopy Anchor Link

VidéoCopy Anchor Link

Tâches asynchronesCopy Anchor Link

MusiqueCopy Anchor Link

Génération 3DCopy Anchor Link

ModèlesCopy Anchor Link

Gemini (v1beta)Copy Anchor Link

Prise en charge native du format API Google Gemini :

Format de réponseCopy Anchor Link

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èsCopy Anchor Link

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

Identifiants de requêteCopy Anchor Link

Les rejets de requête officiels peuvent inclure upstream avec l’erreur signalée par le service et le nom du service public. Les détails de livraison privés et les identifiants ne font pas partie du contrat de réponse public. Voir Gérer les erreurs API. Utilisez les en-têtes publics ci-dessous lorsqu’ils sont présents.

Réponse d’erreurCopy Anchor Link

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Limites de débit (Rate Limits)Copy Anchor Link

Les limites de débit sont basées sur les rôles et configurables par les administrateurs. Valeurs par défaut :

Lorsque les limites de débit sont dépassées, l’API renvoie un code d’état 429 avec un en-tête Retry-After indiquant la durée d’attente.

Spécification OpenAPICopy Anchor Link