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

Chaque requête vers api.tokios.com s’authentifie avec une clé API Tokios envoyée comme Bearer token. Vous créez des clés dans l’onglet Keys de la console ; elles commencent par sk-tok- et peuvent être limitées à des modèles spécifiques. Les clés sont gratuites et ne nécessitent 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).
Éventuellement, définissez des model patterns — des globs séparés par des virgules qui limitent les modèles accessibles par la clé (par exemple gemma*, gpt-4*). Laissez * pour autoriser tous vos modèles.
Cliquez sur Create key, puis copy the key immediately — elle n’est affichée qu’une seule fois.

Une clé n’est affichée qu’une seule fois, à la création. Stockez-la immédiatement dans un gestionnaire de mots de passe ou un coffre de secrets. Si vous la perdez, révoquez-la et créez-en une nouvelle.

Vous pouvez détenir jusqu’à 50 clés actives. Chaque ligne de clé propose des actions pour la edit, rotate, disable et delete. Pour donner accès à un collègue ou un ami sans manipuler le secret vous-même, utilisez Share Key (à côté de Create key dans l’onglet Keys). Cela crée une nouvelle clé dédiée pour cette personne et lui envoie par e-mail un lien à usage unique pour la révéler — la clé elle-même n’est jamais dans l’e-mail, et vous ne la voyez ni ne la copiez jamais. Dans le dialogue Share a key by email :

Enter the recipient email

La personne qui doit recevoir la clé. Elle reçoit un lien de révélation à usage unique, pas le texte de la clé.

Set the model scope

Choisissez quel(s) modèle(s) cette clé partagée peut appeler — la même limitation par motif de modèle qu’une clé normale, donc une clé partagée peut être limitée à exactement un déploiement.

Optionally add a passphrase and expiry

Une passphrase (partagez-la avec le destinataire séparément) ajoute un second facteur au lien de révélation. Expiry définit quand la clé cesse de fonctionner — ou laissez sur No expiry.

Choose usage visibility, then send

Laissez Let them check this key’s usage activé pour permettre au destinataire de voir l’utilisation de la clé partagée (vous pouvez désactiver cela par clé plus tard). Si votre espace de travail utilise request logging et que vous voulez que le destinataire lise les prompts envoyés avec cette clé, cochez aussi Let them read their stored prompts there too — c’est désactivé par défaut car toute personne détenant la clé pourrait alors lire ces prompts. Ensuite cliquez sur Send invite.

Comme une clé partagée est sa propre clé dédiée, vous pouvez la révoquer à tout moment pour couper l’accès de cette personne sans affecter les autres. C’est le moyen le plus rapide de mettre en place l’attribution de clés par personne décrite dans API keys for local models.

Si votre espace de travail a activé request logging, les prompts envoyés avec une clé partagée sont aussi stockés, et le destinataire voit un avis l’indiquant sur sa page d’utilisation. Il ne peut lire ces prompts que si vous cochez l’option de prompt ci-dessus ou l’autorisez plus tard dans les paramètres de la clé. Informez-le avant de partager la clé.

Utiliser votre clé

Envoyez la clé comme Bearer token, et définissez l’URL de base pour correspondre à votre client :

OpenAI style (Codex, SDK OpenAI) : https://api.tokios.com/v1
Anthropic style (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) — la surface Anthropic n’a pas de /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

Ne jamais commiter les clés dans le contrôle de sources. Gardez-les hors des fichiers .env suivis et des chaînes codées en dur.
Utilisez des variables d’environnement et lisez-les à l’exécution.
Tournez périodiquement — créez une clé de remplacement, mettez à jour vos services, puis supprimez l’ancienne.
Utilisez des clés distinctes par environnement pour pouvoir en révoquer une sans perturber les autres.
Limitez avec des motifs de modèles pour qu’une clé ne puisse atteindre que les modèles dont elle a besoin.
Sachez ce qui est stocké. Par défaut, Tokios ne conserve aucun corps de requête ni de réponse. Avec request logging activé, les administrateurs de l’espace de travail peuvent lire les prompts envoyés avec n’importe quelle clé dans l’espace pendant 7 jours.
Utilisez un jeton d’automatisation pour les scripts qui gèrent des clés. Une clé appelle vos modèles ; elle ne peut jamais créer, faire tourner ou révoquer d’autres clés. Un programme qui doit faire cela utilise un jeton d’automatisation à portée limitée et expirant à la place.

Révoquer une clé

Dans l’onglet Keys, trouvez la clé et disable ou delete-la. Une clé révoquée cesse immédiatement d’authentifier — toute requête l’utilisant est rejetée.

Premiers pas

Modèles

Concepts

Référence

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

Créer une clé

Utiliser votre clé

Sécurité des clés

Révoquer une clé

​Créer une clé

​Share a key by email

​Utiliser votre clé

​Sécurité des clés

​Révoquer une clé

Créer une clé

Share a key by email

Utiliser votre clé

Sécurité des clés

Révoquer une clé