Accessing the API

Notes de Cours : Accès à l'API Anthropic (Claude)

**I. Architecture et Sécurité de l'Accès**

• Sécurité Critique : Ne jamais accéder à l'API Anthropic directement depuis une application cliente (web ou mobile).
• Rôle du Serveur : Toutes les requêtes doivent passer par un serveur développé par le développeur (backend).
• Clé API : Une clé API secrète est obligatoire pour toute requête. Elle doit rester cachée sur le serveur.

**II. Cycle de Requête à l'API**

• Étape 1 (Client → Serveur) : L'utilisateur soumet un message au serveur du développeur.
• Étape 2 (Serveur → API) : Le serveur envoie la requête à l'API Anthropic.
• Méthodes : Utilisation d'un SDK (Python, TypeScript, JavaScript, Go, Ruby) ou d'une requête HTTP simple.
• Données Requises :
• Clé API.
• Nom du modèle à utiliser.
• Liste des messages (incluant le texte de l'utilisateur).
• Valeur max tokens (limite la longueur de la réponse).

**III. Processus de Génération de Texte (Interne à Claude)**

Le processus de génération se décompose en quatre étapes principales :

• Tokenisation : Le texte d'entrée est décomposé en unités appelées tokens (mots, parties de mots, espaces).
• Embedding : Chaque token est converti en un embedding (une longue liste de nombres représentant la définition numérique du mot).
• Contextualisation : Chaque embedding est ajusté en fonction des embeddings environnants. Ce processus affine le sens du mot en fonction du contexte de la phrase.
• Génération :
• Les embeddings traités sont passés à une couche de sortie qui produit des probabilités pour chaque mot possible suivant.
• Le modèle sélectionne le mot suivant en utilisant un mélange de probabilité et de hasard (pour des réponses naturelles et variées).
• Le mot sélectionné est ajouté à la liste des embeddings, et le processus se répète.

**IV. Arrêt de la Génération et Réponse**

• Critères d'Arrêt : La génération s'arrête lorsque :
• Le nombre de tokens générés atteint la limite max tokens fournie.
• Le modèle génère un token spécial de fin de séquence (signal naturel de fin).
• Réponse de l'API : L'API renvoie au serveur une réponse contenant :
• Le texte généré.
• L'utilisation (nombre de tokens d'entrée + nombre de tokens générés).
• La raison d'arrêt (ex. : fin naturelle ou dépassement de limite).
• Finalisation : Le serveur transmet le texte généré à l'application cliente pour affichage.

Takeaways

• La sécurité est critique : l'API Anthropic ne doit jamais être appelée directement depuis une application cliente ; toutes les requêtes doivent passer par un serveur backend pour protéger la clé API.
• Une requête à l'API nécessite obligatoirement une clé API, le nom du modèle, la liste des messages et une valeur pour max tokens.
• Le processus de génération de texte interne se décompose en quatre étapes : Tokenisation → Embedding → Contextualisation → Génération probabiliste.
• La génération s'arrête soit lorsque le nombre de tokens générés atteint la limite max tokens, soit lorsque le modèle produit un token spécial de fin de séquence.