Créer et gérer les clés API Tokios

Chaque requête adressée à api.tokios.com doit être authentifiée à l’aide d’une clé API Tokios transmise sous forme de jeton Bearer. Vous créez ces clés dans l’onglet Keys de la console ; elles commencent par sk-tok- et peuvent être associées à des modèles spécifiques. La création de ces clés est gratuite et ne requiert aucune carte de crédit.

Créer une clé

Ouvrez l’onglet Keys dans la console.
Saisissez un display name (par exemple production-app ou local-dev).
Vous pouvez éventuellement définir des model patterns : il s’agit de motifs séparés par des virgules qui limitent les modèles accessibles via la clé (par exemple gemma*, gpt-4*). Laissez-le vide (*) pour autoriser l’accès à tous vos modèles.
Cliquez sur Create key, puis sur copy the key immediately ; cette étape n’apparaît qu’une seule fois.

La clé s’affiche uniquement au moment de sa création. Enregistrez-la immédiatement dans un gestionnaire de mots de passe ou un coffre-fort de secrets. En cas de perte, il convient de la révoquer et d’en créer une nouvelle.

Vous pouvez disposer de jusqu’à 50 clés actives. Chaque ligne de clé propose des actions pour modifier, rotater, disable et delete la clé concernée. Pour accorder à un collègue ou un ami l’accès sans avoir à gérer vous-même la clé API, utilisez Share Key (situé à côté de Create key dans l’onglet Clés). Cet outil génère une nouvelle clé dédiée pour cette personne et lui envoie par courriel un lien unique permettant de la consulter ; la clé elle-même n’apparaît jamais dans le message, et vous ne la voyez ni ne la copiez jamais. Dans la fenêtre de dialogue Partager une clé par courriel :

Saisissez l’adresse électronique du destinataire.

Il s’agit de la personne qui recevra la clé. Elle obtiendra un lien unique pour la consulter, mais pas le texte de la clé.

Définissez la portée du modèle.

Choisissez les modèles que cette clé partagée pourra appeler ; les règles de filtrage sont identiques à celles d’une clé classique, ce qui permet de limiter l’accès à un seul déploiement.

Vous pouvez éventuellement ajouter une phrase de passe et fixer une date d’expiration.

Une phrase de passe (à communiquer séparément au destinataire) constitue un second facteur de sécurité pour l’accès à la clé. Expiry sert à définir la date d’expiration de la clé ; sinon, laissez-la sur No expiry.

Choisissez enfin le niveau de visibilité de l’utilisation, puis envoyez le message.

Laissez Let them check this key’s usage activé afin que le destinataire puisse consulter l’historique d’utilisation de la clé partagée (vous pourrez désactiver cette option ultérieurement). Si votre espace de travail utilise l’enregistrement des requêtes et que vous souhaitez que le destinataire accède aux requêtes envoyées via cette clé, cochez également Let them read their stored prompts there too ; cette option est désactivée par défaut car toute personne détenant la clé pourrait alors lire ces requêtes. Ensuite, cliquez sur Send invite.

Comme il s’agit d’une clé entièrement dédiée, vous pouvez la révoquer à tout moment afin de supprimer l’accès du destinataire sans impacter les autres utilisateurs. C’est la méthode la plus rapide pour appliquer le principe d’attribution individuelle des clés décrit dans Clés API pour les modèles locaux.

Si votre espace de travail a activé l’enregistrement des requêtes, les requêtes envoyées via la clé partagée seront également conservées, et le destinataire verra un message d’information à ce sujet sur sa page d’utilisation. Il ne pourra lire ces requêtes que si vous avez activé l’option précédente ou si vous le permettez ultérieurement dans les paramètres de la clé. N’oubliez pas d’en informer le destinataire avant de lui transmettre la clé.

Utilisez votre clé API

Transmettez la clé en tant que jeton Bearer et définissez l’URL de base en fonction de votre client :

Style OpenAI (Codex, SDK OpenAI) : https://api.tokios.com/v1
Style Anthropic (Claude Code) : https://api.tokios.com

curl https://api.tokios.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tok-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gemma-tunnel", "messages": [{"role": "user", "content": "Hello"}]}'

SDK OpenAI (Python) :

from openai import OpenAI

client = OpenAI(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com/v1",
)
response = client.chat.completions.create(
    model="gemma-tunnel",
    messages=[{"role": "user", "content": "Hello"}],
)

SDK Anthropic (Python) — l’interface Anthropic ne prévoit pas d’/v1 dans l’URL de base :

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-tok-YOUR_KEY",
    base_url="https://api.tokios.com",
)
message = client.messages.create(
    model="gemma-tunnel",
    max_tokens=256,
    messages=[{"role": "user", "content": "Hello"}],
)

Sécurité des clés API

Ne jamais intégrer les clés dans le contrôle de version. Évitez de les placer dans les fichiers .env soumis au dépôt ou dans des chaînes de caractères codées en dur.
Privilégiez l’utilisation de variables d’environnement et lisez-les lors de l’exécution du programme.
Effectuez des rotations régulières : créez une nouvelle clé, mettez à jour vos services puis supprimez l’ancienne.
Utilisez des clés distinctes pour chaque environnement afin de pouvoir les révoquer sans impacter les autres.
Limitez l’accès des clés aux modèles requis en définissant des motifs de modèles spécifiques.
Sachez ce qui est stocké. Par défaut, Tokios ne conserve aucun corps de requête ou de réponse. Lorsque l’enregistrement des requêtes est activé, les administrateurs de l’espace de travail peuvent consulter les invites envoyées avec toute clé API dans l’espace pendant 7 jours.

Révoquez une clé

Dans l’onglet Keys, repérez la clé et disable ou delete celle-ci. Une clé révoquée cesse immédiatement d’authentifier les requêtes — toute demande utilisant cette clé sera rejetée.

Premiers pas

Modèles

Concepts

Référence

Créer et gérer les clés API Tokios

Créer une clé

Utilisez votre clé API

Sécurité des clés API

Révoquez une clé

​Créer une clé

​Partagez une clé par courriel

​Utilisez votre clé API

​Sécurité des clés API

​Révoquez une clé

Créer une clé

Partagez une clé par courriel

Utilisez votre clé API

Sécurité des clés API

Révoquez une clé