Authentification

Créer une clé

Les clés API sont émises depuis un espace de travail sur console.artfical.com, sur la page des clés API. Créer une clé à cet endroit est le seul moyen d'en obtenir une ; il n'existe aucun moyen de générer ou de renouveler une clé via l'API elle-même, et c'est volontaire : la création d'une clé est une action sensible et peu fréquente, et la placer derrière la session authentifiée de la console la met hors de portée de tout ce qui ne dispose que d'un accès au niveau de l'API.

Une clé ressemble à ceci, toujours avec le même préfixe :

tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

La valeur complète de la clé n'est affichée qu'une seule fois, au moment de sa création. Ensuite, la console n'affiche plus qu'une forme tronquée à des fins d'identification (les premiers caractères et les derniers, le milieu étant masqué). Si vous perdez la valeur complète, il n'existe aucun moyen de la récupérer ; la seule option est de révoquer cette clé et d'en créer une nouvelle. Traitez une clé comme vous traiteriez un mot de passe de base de données : stockez-la dans une variable d'environnement ou un gestionnaire de secrets, jamais dans le code source, et jamais dans une application côté client où le navigateur d'un utilisateur final pourrait la lire.

Envoyer la clé dans une requête

Chaque requête vers /v1/chat/completions et /v1/models doit inclure la clé dans un en-tête Authorization standard, selon le schéma Bearer :

Authorization: Bearer tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

C'est exactement la même forme d'en-tête que celle utilisée par l'API d'OpenAI elle-même, ce qui explique pourquoi pointer un client existant basé sur le SDK openai vers tAI se résume généralement à une modification d'une seule ligne : définissez base_url sur https://api.artfical.com/v1 et api_key sur votre clé tAI, et le code de requête du SDK lui-même n'a pas besoin de changer.

# Python, avec le paquet officiel openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.artfical.com/v1",
    api_key="tai-sk-...",
)

response = client.chat.completions.create(
    model="tai-4.1",
    messages=[{"role": "user", "content": "Merhaba"}],
)
print(response.choices[0].message.content)

Une requête dépourvue de l'en-tête, ou l'envoyant sous une forme incorrecte (absence du préfixe Bearer , valeur vide, clé qui ne s'analyse pas correctement), est rejetée de la même façon qu'une clé franchement invalide : une réponse 401 avec un type authentication_error. Voir Erreurs pour la structure exacte de la réponse.

Espaces de travail et portée

Une clé appartient à exactement un espace de travail et ne peut être utilisée que pour effectuer des requêtes pour le compte de cet espace de travail. Il n'existe pas de notion de clé s'étendant sur plusieurs espaces de travail, ni de moyen d'accorder à une seule clé un accès partiel à certains modèles ou à un certain palier de limite de débit ; chaque clé d'un espace de travail dispose du même accès à tous les modèles listés sur la page Modèles. Si vous devez séparer l'usage ou la facturation entre deux projets différents, la solution consiste à créer deux espaces de travail avec leurs propres clés, et non à partager une seule clé entre eux.

L'usage effectué avec une clé donnée, nombre de requêtes, nombre de tokens et coût estimé, est attribué à cette clé et visible sur la page Usage de la console, restreinte à l'espace de travail auquel appartient la clé. Cela sert uniquement à votre propre visibilité ; cela n'affecte en rien le traitement d'une requête.

Expiration

Une clé peut éventuellement être créée avec une date d'expiration (dans 7, 30 ou 90 jours, ou jamais, au choix lors de la création de la clé). Une fois sa date d'expiration dépassée, toute requête effectuée avec cette clé est rejetée avec le même 401 authentication_error qu'une clé invalide, indiscernable de l'extérieur. Si des requêtes utilisant une clé qui fonctionnait jusqu'alors se mettent soudainement à échouer avec un 401, une clé expirée est la première chose à vérifier, sur la page des clés API, avant de supposer qu'autre chose s'est cassé.

Il n'existe pas de renouvellement automatique. Une clé approchant de sa date d'expiration doit être remplacée par une clé nouvellement créée ; la console ne prolonge pas la durée de vie d'une clé existante sur place.

Révoquer une clé

Une clé peut être révoquée à tout moment depuis la page des clés API, de manière immédiate et irréversible. Une clé révoquée se comporte exactement comme une clé expirée du point de vue de l'API : toute requête ultérieure effectuée avec elle reçoit un 401. La révocation est la bonne réponse à une clé compromise ; il n'existe aucun moyen de renouveler la valeur secrète d'une clé sur place, seulement de révoquer l'ancienne et d'en créer une nouvelle pour la remplacer.

Ce qu'une clé ne donne pas à elle seule

Détenir une clé API valide suffit pour effectuer des requêtes de complétion de chat et lister les modèles. Cela ne donne accès à rien dans l'interface de la console elle-même, ni aux paramètres de l'espace de travail, aux informations de facturation, ou à l'activité des autres membres ; ces éléments sont protégés par la connexion à session propre de la console, entièrement distincte des clés API. Une clé API compromise est un problème réel, car elle permet à quelqu'un d'effectuer des requêtes (et de générer l'usage associé) pour le compte de votre espace de travail, mais elle n'expose pas à elle seule votre compte de console ni ne permet à quelqu'un de se connecter à votre place.