ima : modèles personnalisés, clé API, URL de base et dépannage
Configurez une clé API, une URL de base et un identifiant de modèle dans ima. Vérifiez les réponses, résolvez les erreurs et distinguez le modèle de chat de l’API de la base de connaissances.
Ce guide connecte ima à une API externe de modèle de chat. Utilisez une version disposant de l’ajout de modèles personnalisés ; les menus peuvent varier entre ordinateur et mobile. La clé API et l’URL de base doivent provenir du même fournisseur. Copiez l’identifiant exact dans son catalogue actuel ; les anciens modèles des captures servent d’exemples. Ne saisissez pas une URL complète /chat/completions et ne répétez pas /v1. Commencez avec les longueurs par défaut et une question courte. Enregistrer la configuration ne confirme pas la réussite d’un appel API.
ima : modèles personnalisés, clé API, URL de base et dépannage
Étape 1 : ouvrir le sélecteur de modèles
En bas de l’interface de conversation d’ima copilot, repérez le bouton « DS rapide », encadré en rouge dans l’image 1, puis appuyez dessus pour ouvrir le menu de sélection des modèles.
Interface mobile d’ima. Sous la zone de saisie, le bouton « DS rapide »…
Étape 2 : accéder à « Ajouter un modèle personnalisé »
Dans le menu des modèles, repérez le bouton « Ajouter un modèle personnalisé », puis appuyez dessus pour ouvrir la page de configuration d’un modèle personnalisé.
Écran mobile d’ajout d’un modèle personnalisé. Sous les modèles prédéfin…
Étape 3 : choisir le fournisseur du modèle, notamment « Personnalisé »
Sur la page d’ajout, ouvrez la liste « Fournisseur du modèle », illustrée par l’image 4. Vous pouvez choisir un fournisseur prédéfini, tel que DeepSeek, Kimi ou Zhipu. Pour connecter un service tiers ou auto-hébergé, choisissez « + Personnalisé ». Cette option est sélectionnée par défaut et vous pouvez donc ignorer cette étape.
Liste déroulante des fournisseurs lors de l’ajout d’un modèle personnali…
Étape 4 : renseigner les informations essentielles du modèle
La page de configuration demande trois informations essentielles, encadrées en rouge dans l’image 5 :
- Adresse de l’interface : saisissez l’adresse API du modèle, par exemple
https://api.llm-token.cn/v1, en la remplaçant si nécessaire par l’adresse réelle du service à connecter. - API Key : saisissez l’API Key du modèle, sous une forme telle que
sk-xxxxxx..., obtenue auprès du fournisseur. - Nom du modèle : saisissez son nom, par exemple
gpt-5.5ouclaude-sonnet-4-6. Il doit correspondre exactement au nom pris en charge par l’interface.
Vous pouvez conserver la valeur par défaut pour les réglages avancés de longueur d’entrée et de sortie.
Écran de configuration d’un modèle personnalisé dans ima. Les champs obl…
Étape 5 : enregistrer le modèle personnalisé
Une fois les champs renseignés, appuyez sur le bouton « Enregistrer » en haut à droite, signalé par le doigt dans l’image 5. Le modèle est automatiquement ajouté à la liste des modèles personnalisés. Dans l’image 6, le nouveau modèle claude-opus-4-8 a bien été ajouté et peut être sélectionné.
Utilisation ultérieure : changer de modèle personnalisé
Revenez au menu de sélection au moyen du bouton « DS rapide » de l’étape 1. Le modèle ajouté apparaît dans la liste « Modèles personnalisés ». Appuyez dessus pour l’utiliser~
Menu mobile de sélection des modèles. La section des modèles personnalis…
Échec des requêtes du modèle personnalisé
| Symptôme | Premier contrôle |
|---|---|
| Erreur d’authentification ou 401 | Clé complète, valide et émise par le fournisseur de cette URL. |
| Modèle introuvable ou accès refusé | Identifiant exact dans le catalogue actuel et droits de cette clé. |
| 404 ou interface introuvable | URL de base, chemin complet de requête et doublon /v1/v1. |
| Configuration enregistrée, mais envoi impossible | Sélection de la nouvelle configuration, solde, état du service et réseau. |
| Questions courtes acceptées, contenu long refusé | Limites d’entrée/sortie, budget de contexte et limites du fournisseur. |
Pour contacter le support, indiquez l’heure, l’identifiant du modèle, l’erreur complète et l’identifiant de requête si disponible. Masquez la clé API.
Modèle de chat et API de la base de connaissances ima
Cette configuration permet à ima d’appeler un modèle de chat externe. Pour qu’un agent externe lise ou écrive dans une base ima, vérifiez séparément les interfaces officielles, l’authentification et les autorisations. Enregistrer un modèle de chat ne configure pas cet accès.
Vérifier les identifiants et les tarifs
Copiez l’identifiant exact dans le catalogue actuel du fournisseur. Vérifiez séparément les prix d’entrée, de sortie et de cache ; les anciennes captures ne confirment ni disponibilité ni tarifs actuels.
Modèles et facturation actuels
L’entrée, la sortie et l’entrée en cache peuvent avoir des tarifs différents. Pour les images, vidéos ou modèles facturés à la requête, vérifiez l’unité de facturation. Consultez les identifiants et tarifs sur la page des prix ; les montants débités figurent dans les relevés de facturation.
Guide de configuration de Cursor
Pour les versions de Cursor proposant une configuration personnalisée de l’OpenAI Key et de la Base URL.
Configurer les modèles de génération d’images dans l’interface Web
Un guide destiné aux débutants qui préfèrent utiliser l’interface Web sans manipuler les paramètres de l’API.