aethexDocs

Référence API

Clés LLM

Associez votre propre clé API de fournisseur LLM. Chaque agent dont le llm_model désigne un modèle de ce fournisseur utilise alors votre clé, pour les appels comme pour le chat texte. Les agents sur le modèle par défaut de la plateforme (aethex-default ou un llm_model vide) et les modèles temps réel continuent d'utiliser la clé Aethex. Le modèle lui-même se choisit sur l'agent (PATCH /agents/{id}, llm_model). Pour faire tourner les appels sur votre propre serveur compatible OpenAI, associez-le avec le fournisseur custom : voir Votre propre LLM.

URL de base
https://api.aethexai.com/api/v1
Endpoints
4
Portées
llm_credentials:readllm_credentials:write
POST/llm-credentials

Vé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

4
  • providerstringrequis

    Fournisseur de la clé : openai, anthropic, openrouter, groq, cerebras, xai, ou custom pour votre propre serveur compatible OpenAI.

  • api_keystringrequis

    La clé API du fournisseur. Vérifiée auprès du fournisseur avant d'être enregistrée ; jamais renvoyée.

  • labelstringoptionnel

    Libellé facultatif.

  • base_urlstringoptionnel

    Obligatoire pour custom, refusé pour tout autre fournisseur : la racine chat-completions de votre serveur, par exemple https://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

4
422Entité non traitable

Le 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.

409Conflit

Une autre clé pour le même fournisseur a été associée au même moment.

Renvoyez la requête.

429Trop de requêtes

Limite d'association par compte dépassée (5/min).

Réessayez après le délai indiqué par Retry-After.

503Service indisponible

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.

GET/llm-credentials

Lister les clés associées à votre compte, les plus récentes d'abord.

Lister les clés LLM

Renvoie les clés actives et libérées, les plus récentes d'abord. Les clés elles-mêmes ne sont jamais incluses ; chaque entrée affiche key_hint, les quatre derniers caractères de la clé, et base_url pour un point de terminaison custom.

Chemin & Requête

2
  • limitintegeroptionnel

    Nombre maximal de résultats (1 à 200, 50 par défaut).

  • offsetintegeroptionnel

    Nombre de résultats à ignorer (0 par défaut).

GET/llm-credentials/:id

Obtenir une clé associée.

Obtenir une clé LLM

Renvoie le fournisseur, le libellé, le key_hint, le base_url (pour un point de terminaison custom) et le statut d'une clé. La clé elle-même n'est jamais renvoyée.

Chemin & Requête

1
  • idstringrequis

    ID de la clé LLM.

Erreurs

1
404Introuvable

Aucune clé avec cet ID n'existe sur votre compte.

Vérifiez l'ID avec GET /llm-credentials.

DELETE/llm-credentials/:id

Cesser d'utiliser une clé et la supprimer.

Libérer une clé LLM

Libère la clé et l'efface. Renvoie 204 que la clé ait été active ou non. Les agents sur des modèles OpenAI, Anthropic ou OpenRouter repassent sur la clé Aethex dès leur prochain appel ou tour de chat. Une clé Groq, Cerebras, xAI ou custom ne peut pas être libérée tant qu'un agent l'utilise encore.

Chemin & Requête

1
  • idstringrequis

    ID de la clé LLM.

Erreurs

1
409Conflit

Des agents utilisent encore des modèles qui ne fonctionnent qu'avec votre propre clé : Groq, Cerebras, xAI ou custom:.

Changez d'abord le llm_model de ces agents. L'erreur les nomme.