AingDesk × AI Code With

Utiliser AI Code With dans AingDesk : configuration d'API tierce / relais

Cette page explique comment connecter une API tierce dans AingDesk, un assistant de bureau open source, afin d’utiliser localement des modèles et des bases de connaissances avec un fournisseur personnalisé.

Téléchargez et installez d’abord AingDesk, puis ajoutez un fournisseur personnalisé dans l’application. Saisissez la clé uniquement dans le client, jamais sur cette page.

Référence rapide du fournisseur personnalisé4 paramètres
Nom du fournisseur
AI Code With
URL de l'API
https://api.aicodewith.ai/v1
API Key
sk-xxxxxxxx
ID du modèle
claude-sonnet-4-6

Configuration rapide

Enregistrez cette clé pour les terminaux suivants

Cet outil stocke la clé dans ses propres paramètres. Après vous être connecté, copiez la clé et collez-la dans le champ Clé API des étapes ci-dessous.

Clé API
sk-***

Les visiteurs déconnectés ne voient qu'un espace réservé. Connectez-vous et nous remplirons votre clé. Sign in · Obtenir une clé dans la console

Copier ne fait que placer la commande dans le presse-papiers. Vous devez encore l'exécuter dans un terminal, ou coller la clé dans les paramètres de l'outil. Comment obtenir une clé API

Dans AingDesk, ajoutez un fournisseur de modèle : renseignez "Supplier name", "API URL" et "API key", puis choisissez un modèle. Environ 3 minutes.

AingDesk est un client de bureau (son interface est en chinois ; les libellés ci-dessous sont donnés en anglais). Ouvrez la page d'accueil ou la barre latérale "Third-party model API", ajoutez un fournisseur de modèle, renseignez "Supplier name", "API URL" et "API key", puis synchronisez les modèles et envoyez un message de test.

  1. Choisissez "Use third-party models"

    La première fois que vous ouvrez AingDesk, une page d'accueil apparaît. Cliquez sur "Use third-party models" dans le cadre rouge ; vous devriez arriver sur "Third-party API settings". Si la page d'accueil est déjà fermée, utilisez plutôt la barre latérale "Third-party model API". Si vous ne parvenez pas à y accéder, consultez #errors. Ensuite : cliquez sur "Add model supplier".

    On first launch of AingDesk, click 「使用第三方模型」 on the welcome page. The sidebar 「第三方模型API」 is another way in.
  2. Cliquez sur "Add model supplier"

    En bas de la fenêtre "Third-party API settings", cliquez sur "Add model supplier" (ne cliquez pas sur les tuiles intégrées telles que SiliconFlow). Le formulaire "Add model supplier" devrait s'ouvrir. Si vous ne voyez pas le bouton, fermez la fenêtre et rouvrez les paramètres d'API tierce. Si cela échoue encore, consultez #errors. Ensuite : remplissez les trois champs et cliquez sur "Confirm".

    At the bottom of 「第三方API配置」, click 「添加模型服务商」. The built-in supplier on the right (硅基流动) is not this page's path.
  3. Remplissez "Supplier name", "API URL" et "API key"

    Dans la boîte de dialogue "Add model supplier", renseignez "Supplier name" (AI Code With convient), "API URL" https://api.aicodewith.ai/v1 (le texte d'aide demande un point de terminaison compatible OpenAI), et "API key", puis cliquez sur "Confirm". Après succès, vous devriez arriver sur le fournisseur enregistré et il devrait commencer à récupérer /models. Si "Confirm" reste bloqué ou si la liste est vide, consultez #errors. Ensuite : vérifiez la liste des modèles ou cliquez manuellement sur "Add model".

    Copie rapide

    Nom du fournisseur

    AI Code With

    URL de l'API

    https://api.aicodewith.ai/v1

    Fill 供应商名称, 接口地址 https://api.aicodewith.ai/v1, and 密钥, then click 「确认」. Paste the AI Code With key into the 密钥 field.
  4. Synchronisez les modèles ou "Add model"

    Après l'enregistrement, la liste se remplit automatiquement depuis /models par défaut. Les ID dans la capture d'écran tels que chatgpt-4o-latest sont un catalogue de relais, pas le Model ID de cette page. Activez les modèles dont vous avez besoin ; si l'ID de cette page est manquant, cliquez sur "Add model", collez le Model ID, définissez vous-même l'alias du modèle et réglez la capacité du modèle sur LLM. Si la liste est vide ou si vous ne trouvez pas l'ID, consultez #errors. Ensuite : revenez au chat et envoyez un message de test.

    Copier un ID de modèle

    Après l’enregistrement, AingDesk remplit la liste via 「默认从/models获取所有模型」. Copiez un Model ID ci-dessous ; s’il manque, cliquez sur 「添加模型」, collez-le, avec 模型功能 défini sur LLM.

    Choisissez une famille, puis copiez un Model ID. 接口地址 reste identique pour chaque modèle.

    Sélectionné

    Fournisseur
    Claude
    ID du modèle
    claude-sonnet-5-5

    Le catalogue complet se trouve dans la documentation et la page de tarifs AI Code With. Des noms comme chatgpt-4o-latest dans les captures d’écran montrent seulement la synchronisation automatique ; utilisez un ID de cette page.

    Voir la liste complète des modèles
    IDs in the list such as chatgpt-4o-latest are a relay catalog, not Model IDs from this page. When you enable a model or click 「添加模型」, paste an ID copied here.
  5. Utilisez "Select model" et envoyez un test

    Revenez au chat, cliquez sur "Select model" dans la barre supérieure, choisissez le modèle que vous venez d'ajouter et envoyez un message de test. La capture d'écran s'arrête sans modèle sélectionné et sans réponse encore. Succès = une vraie réponse, puis faites correspondre l'heure et le modèle dans les enregistrements d'utilisation d'AI Code With. Ne considérez pas "Check" comme connecté. S'il n'y a pas de réponse, consultez #errors.

    Return to chat. The top bar still shows 「请选择模型」 (the screenshot has not sent a message). Click 「请选择模型」, pick the model you just added, and send a test. Success = a real reply + a usage record. Do not treat 「检查」 as success.

Comment AingDesk se connecte-t-il à AI Code With ?

AingDesk communique avec un point de terminaison compatible OpenAI via un fournisseur personnalisé. Se connecter à AI Code With revient à ajouter un fournisseur de modèles, renseigner 接口地址 et 密钥, puis choisir un modèle :

Choisir 「使用第三方模型」
Le premier lancement affiche une page d’accueil. Cliquez sur 「使用第三方模型」 pour ouvrir 「第三方API配置」. Si la page d’accueil n’est plus là, utilisez la barre latérale 「第三方模型API」.
Cliquez sur 「添加模型服务商」
En bas de 「第三方API配置」, cliquez sur 「添加模型服务商」 (pas les tuiles intégrées 硅基流动). Le formulaire 「添加模型服务商」 devrait s’ouvrir.
Renseignez 「供应商名称」, 「接口地址」 et 「密钥」
供应商名称 peut être AI Code With. Définissez 接口地址 sur https://api.aicodewith.ai/v1 (texte d’aide : 需要兼容openAI格式的接口). Collez la clé AI Code With dans 密钥, puis cliquez sur 「确认」. N’ajoutez pas /chat/completions.
Synchronisez les modèles ou cliquez sur 「添加模型」
Après l’enregistrement, la liste se remplit via 「默认从/models获取所有模型」. Des noms comme chatgpt-4o-latest sont un catalogue de relais, pas des Model IDs de cette page. Si l’ID de cette page manque, cliquez sur 「添加模型」, collez-le et définissez 模型功能 sur LLM.
Utilisez 「请选择模型」 et envoyez un test
Revenez au chat, cliquez sur 「请选择模型」, choisissez le modèle que vous venez d’ajouter et envoyez un message de test. Réussite = une vraie réponse, puis faites correspondre les enregistrements d’utilisation. Ne considérez pas 「检查」 comme connecté.

Flux : AingDesk → fournisseur personnalisé (供应商名称 + 接口地址 /v1 + 密钥) → AI Code With API. Tout se fait dans l’interface graphique. Aucun fichier à modifier.

Questions fréquentes

Nouveau sur AingDesk ?

AingDesk est un assistant IA de bureau open source pour Windows et macOS.

Page de téléchargement d’AingDesk

Téléchargez l’installateur pour votre OS depuis la page de téléchargement d’AingDesk. Après l’installation, ouvrez AingDesk et lancez la configuration d’un modèle tiers depuis la page d’accueil ou la barre latérale.

Ouvrir la page de téléchargement d’AingDesk

Intel Mac n’est plus pris en charge ; Docker :7071 est le serveur, pas le chemin par défaut de cette page. Les instructions d’installation complètes se trouvent sur le site AingDesk ; ce site n’héberge pas l’installateur.

Dépannage des erreurs courantes

Les problèmes les plus fréquents se répartissent en 4 catégories.

Liste de modèles vide / Confirmer se bloque

Symptôme : 「确认」 se bloque, ou après l’enregistrement 「默认从/models获取所有模型」 reste vide.

Cause : AingDesk fait un GET sur {baseUrl}/models avec 接口地址 tel quel et n’ajoute pas automatiquement /v1. Un /v1 manquant, l’ajout de /chat/completions, une mauvaise clé ou un catalogue amont vide produisent tous une liste vide. Confirmer peut se bloquer pendant la récupération du catalogue complet (#105).

  • Définissez 接口地址 uniquement sur https://api.aicodewith.ai/v1 — n’ajoutez pas /chat/completions
  • Si la liste est vide, cliquez sur 「添加模型」 et collez un Model ID de cette page
  • Définissez 模型功能 sur LLM

Sélecteur de chat sans le nouveau modèle / seulement Ollama

Symptôme : Après l’ajout du fournisseur, 「请选择模型」 ne l’affiche pas, ou seul Ollama apparaît.

Cause : L’interrupteur du fournisseur est désactivé ; la liste ne s’actualise pas après l’ajout d’un modèle (#50) ; les modèles importés avec title==="" sont filtrés ; d’autres fournisseurs saturent le sélecteur (#92).

  • Activez ce fournisseur et désactivez les autres
  • Fermez et rouvrez 「第三方模型API」 pour actualiser la liste
  • Si nécessaire, renseignez 模型ID et 模型别名 à la main

L’envoi échoue alors que 「检查」 indique un succès

Symptôme : Sur le panneau du fournisseur enregistré, 「检查」 indique que la configuration est correcte, mais l’envoi renvoie 401, aucune réponse ou une interruption inattendue.

Cause : 「检查」 et 「保存API」 n’apparaissent que sur un panneau de fournisseur déjà enregistré. 「检查」 est un stub : il ne contacte pas le réseau et renvoie toujours un succès. La vraie vérification est une réponse dans le chat plus les enregistrements d’utilisation AI Code With.

  • Recollez la clé AI Code With ; ne considérez jamais 检查成功 comme 接入成功
  • Confirmez que 接口地址 inclut /v1
  • Envoyez un message de test, puis faites correspondre l’appel par heure et par modèle dans les enregistrements d’utilisation

La liste synchronisée est un catalogue de relais / modèle introuvable

Symptôme : Après l’enregistrement, vous voyez une longue liste, mais le Model ID de cette page manque, ou l’envoi indique que le modèle n’existe pas.

Cause : /models renvoie le catalogue amont, pas les IDs de cette clé. Les interrupteurs ne retirent pas les modèles du chat (#92) ; vous devez les supprimer. La capture 4 illustre cela : des noms comme chatgpt-4o-latest sont un catalogue de relais.

  • Cliquez sur 「添加模型」 et collez un Model ID de cette page
  • N’ajoutez pas /chat/completions à 接口地址
  • Confirmez que la clé peut accéder à ce modèle

Besoin du guide complet ?

Chaque paramètre de configuration, la liste complète des modèles et d’autres dépannages se trouvent dans la documentation AI Code With.

Ouvrir la documentation AI Code With

Sources

Liens connexes