/llm-credentialsVérifier une clé API de fournisseur et l'enregistrer (chiffrée).
Associer une clé LLM
Vérifie la clé auprès du fournisseur, puis l'enregistre chiffrée au repos. La clé n'est jamais renvoyée dans une réponse ; key_hint en affiche les quatre derniers caractères. Associer une clé pour un fournisseur qui en a déjà une remplace immédiatement l'ancienne : vous pouvez changer de clé sans interruption. Si le fournisseur refuse ensuite la clé (révoquée, crédit épuisé, limite de débit), l'appel ou le tour de chat échoue : il ne bascule jamais sur la clé Aethex. Les modèles Groq (groq:…), Cerebras (cerebras:…) et xAI (xai:…) ne peuvent être choisis sur un agent qu'après avoir associé la clé de ce fournisseur. Les modèles temps réel continuent d'utiliser la clé Aethex. Un point de terminaison custom prend aussi base_url et est vérifié avec GET <base_url>/models ; les agents le désignent par custom:<model>, pour les appels vocaux uniquement.
Corps de la requête
4providerstringrequisFournisseur de la clé :
openai,anthropic,openrouter,groq,cerebras,xai, oucustompour votre propre serveur compatible OpenAI.api_keystringrequisLa clé API du fournisseur. Vérifiée auprès du fournisseur avant d'être enregistrée ; jamais renvoyée.
labelstringoptionnelLibellé facultatif.
base_urlstringoptionnelObligatoire pour
custom, refusé pour tout autre fournisseur : la racine chat-completions de votre serveur, par exemplehttps://llm.example.com/v1. Les requêtes vont à<base_url>/chat/completions. HTTPS sur le port 443 vers un hôte public, sans identifiants, chaîne de requête ni fragment. Voir Votre propre LLM.
Erreurs
4Le fournisseur a refusé la clé, provider ne fait pas partie des valeurs acceptées, ou base_url est absent, mal formé ou ne se résout pas vers une adresse publique.
Vérifiez la clé dans la console de votre fournisseur et que provider lui correspond.
Une autre clé pour le même fournisseur a été associée au même moment.
Renvoyez la requête.
Limite d'association par compte dépassée (5/min).
Réessayez après le délai indiqué par Retry-After.
Le fournisseur, ou votre base_url, n'a pas pu être joint pour vérifier la clé, ou le limiteur de débit est hors ligne.
Réessayez dans un instant.
