Connexion d'AionUi

Difficulté 🧩 Moyenne　|　Format d'interface Compatible OpenAI　|　base_url https://byesu.com/v1

Infos de connexion

Adresse APIhttps://byesu.com/v1

Clé APIsk-xxxxxxxxCréer dans la console →

Modèlegpt-5.5

Format API OpenAI compatible · noms de modèles selon la console

AionUi est une application de bureau Cowork gratuite, locale et open source, dotée d'une interface graphique et d'une WebUI distante, capable d'exécuter simultanément plusieurs agents IA tels que Gemini CLI, Claude Code, Codex, etc. En la configurant avec les modèles de Byesu API, vous pouvez faire collaborer des modèles comme gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high au sein d'une même interface.

Avant de commencer

Rendez-vous d'abord dans Console → Jetons pour créer un jeton d'API (de la forme sk-xxxx).

Lors de la création, veillez à choisir le bon groupe : le groupe détermine quels modèles vous pouvez appeler et selon quelle tarification ils sont facturés. Vous ne savez pas lequel choisir ? Consultez Choisir un groupe.

Étape 1 : Télécharger et installer AionUi

Rendez-vous sur la page GitHub Releases et téléchargez le paquet d'installation correspondant à votre système :

• Adresse de téléchargement : https://github.com/iOfficeAI/AionUi/releases
• Sous Windows, choisissez .exe ; sous macOS, .dmg ; sous Linux, .AppImage.

Une fois téléchargé, double-cliquez pour installer puis ouvrez AionUi.

Étape 2 : Ajouter les modèles de Byesu API

AionUi utilise une configuration de modèle unifiée pour se connecter aux services compatibles OpenAI ; Byesu API entre dans cette catégorie.

1. Ouvrez AionUi et accédez à la page Paramètres (Settings).
2. Basculez vers l'onglet Configuration des modèles (Model Configuration).
3. Cliquez sur Ajouter un modèle (Add Model).
4. Pour le type de fournisseur, sélectionnez NewAPI (ou Compatible OpenAI / Custom).
5. Renseignez selon le tableau ci-dessous :

Champ	Contenu à renseigner
Adresse de l'API (API Address / base_url)	https://byesu.com/v1
Clé d'API (API Key)	Votre jeton sk-xxxx
Modèle (Model)	Voir les recommandations ci-dessous
Protocole de requête (Request Protocol)	Choisissez OpenAI (compatible) ; si une erreur de protocole ou de format apparaît après l'ajout d'un modèle claude / gemini, basculez manuellement vers le protocole correspondant au modèle

La base_url doit se terminer par /v1

Le format compatible OpenAI doit obligatoirement être https://byesu.com/v1 : n'oubliez pas le /v1, et n'ajoutez pas non plus de barre oblique supplémentaire ni /chat/completions à la fin.

Une fois la clé renseignée, sélectionnez le modèle à utiliser dans la liste déroulante des modèles ; si la liste est vide, vous pouvez saisir manuellement le nom du modèle. Modèles courants :

Usage	Nom du modèle
Conversation générale / rédaction	gpt-5.5
Codage / raisonnement à contexte long	claude-opus-4-8
Multimodal / contexte très étendu	gemini-3.1-pro-high

Enregistrez la configuration.

Étape 3 : (Facultatif) Configurer l'agent Claude Code

Au sein d'AionUi, chaque agent IA peut être configuré indépendamment. Parmi eux, l'agent Claude Code utilise l'interface native d'Anthropic, dont la base_url diffère du format compatible OpenAI : elle est sans /v1 :

Paramètres de l'agent Claude Code

Base URL:  https://byesu.com
API Key:   sk-xxxx
Model:     claude-opus-4-8

Variables d'environnement équivalentes

ANTHROPIC_BASE_URL=https://byesu.com
ANTHROPIC_AUTH_TOKEN=sk-xxxx
ANTHROPIC_MODEL=claude-opus-4-8

Il en va de même pour les autres agents comme Gemini CLI, Codex, etc. : il suffit de renseigner dans leur configuration respective la base_url correspondante (https://byesu.com/v1 pour le format compatible OpenAI), la clé et le modèle.

Étape 4 : Lancer et vérifier

Revenez à l'interface de discussion, sélectionnez en haut, dans le choix du modèle, celui que vous venez de configurer (par exemple gpt-5.5), puis envoyez « Bonjour, présente-toi en une phrase ».

Si vous recevez une réponse normale, c'est que la connexion a réussi. Si vous avez utilisé l'agent Claude Code, vous pouvez lui demander de lire un fichier ou d'exécuter une tâche simple pour confirmer que l'agent fonctionne correctement.

Bloqué ?

• 401 / jeton invalide : vérifiez que la clé d'API a été collée intégralement, sans espace superflu ; assurez-vous d'utiliser le sk-xxxx créé dans la console Byesu. Voir les détails dans Erreurs courantes #auth.
• Erreur « aucun canal disponible » / modèle inexistant : il s'agit le plus souvent d'un mauvais groupe sélectionné pour le jeton, ou d'un nom de modèle non pris en charge par le groupe actuel. Changez de groupe ou de nom de modèle ; consultez Choisir un groupe et Erreurs courantes #no-channel.
• Solde insuffisant : si le crédit de votre compte est épuisé, les requêtes seront refusées ; rechargez d'abord votre compte ou changez de groupe. Voir Erreurs courantes #balance.
• Impossible de se connecter / 404 : vérifiez que vous avez bien renseigné https://byesu.com/v1 pour le format compatible OpenAI, et https://byesu.com (sans /v1) pour l'agent Claude Code.

Pour plus de dépannage, voir Erreurs courantes.