Documentation

Clés API

Fonctionnement

Metamorfon fonctionne avec vos propres clés API (modèle « bring your own key », BYOK). Vous créez des clés auprès des fournisseurs de modèles que vous utilisez ; la facturation des appels (tokens, quotas, abonnements) relève exclusivement de ces fournisseurs et de votre compte chez eux. Metamorfon affiche des indicateurs d’usage (tokens, coûts estimés) dans l’interface pour vous aider à suivre la consommation, mais ne facture pas les appels aux API des fournisseurs.

Où saisir vos clés ?

Ouvrez le panneau latéral droit, puis la section « Clés API ». Pour chaque fournisseur, vous pouvez coller la clé, la masquer ou l’afficher, et utiliser la validation pour vérifier qu’elle est acceptée et que des modèles sont disponibles pour votre compte. Après validation, l’application peut synchroniser la liste des modèles disponibles côté fournisseur.

Stockage et confidentialité

Vos clés sont enregistrées localement sur votre appareil (navigateur ou application desktop, selon votre installation). Elles ne sont pas envoyées à un serveur Metamorfon sur Internet. Elles servent uniquement à permettre à l’application d’appeler les API officielles des fournisseurs que vous avez configurés. Pour la validation et la liste des modèles, l’application s’appuie sur un serveur backend local (FastAPI, voir ci‑dessous).

Bonnes pratiques : ne partagez jamais une clé en clair (capture d’écran, forum, ticket de support). Révoquez une clé compromise sur le site du fournisseur et créez-en une nouvelle. Limitez les droits de la clé lorsque le fournisseur le propose.

Backend local et validation

La validation des clés et la récupération des modèles passent par un serveur local (par défaut http://127.0.0.1:8000). L’application tente de le démarrer automatiquement. Si la validation échoue ou si le statut du serveur reste indisponible : attendez quelques secondes, utilisez « Réessayer » dans la section clés, vérifiez qu’aucun autre programme n’occupe le port 8000, et assurez-vous que le backend peut être lancé (voir la documentation ou les journaux indiqués dans l’application en cas de problème persistant).

Fournisseurs pris en charge et liens utiles

Messages d’erreur fréquents

• Clé invalide, expirée ou aucun modèle disponible — Vérifiez la clé sur le site du fournisseur, le bon compte ou projet, et qu’un modèle compatible est bien activé pour votre abonnement ou région.
• Quota ou limite de débit — Consultez le tableau de bord du fournisseur (facturation, limites, statut du service).
• Backend local injoignable — Vérifiez que le serveur local répond, que le port est libre, puis réessayez la validation.

Bonnes pratiques de sécurité

• Ne partagez jamais une clé API en clair.
• N’exposez pas vos clés dans des captures d’écran, sur des forums ou dans des tickets de support.
• Si une clé est compromise, révoquez-la immédiatement sur le site du fournisseur et générez-en une nouvelle.
• Lorsque c’est possible, utilisez des clés aux droits limités (permissions restreintes).

Utilisateurs avancés (variables d’environnement)

Si vous exécutez le backend vous-même ou une configuration personnalisée, des variables d’environnement du type OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc. peuvent compléter ou remplacer la saisie dans l’interface selon votre déploiement. En usage standard depuis l’application graphique, la section Clés API des paramètres suffit.

Démarrage rapide

1. Installez et lancez Metamorfon sur un système pris en charge (Windows ou macOS).
2. Attendez que le backend local soit actif (voir Backend local ci‑dessous). L’application le démarre en général pour vous ; l’état est indiqué dans l’interface.
3. Ouvrez Paramètres → Clés API, ajoutez au moins une clé pour un fournisseur que vous utilisez, puis validez la clé et synchronisez les modèles pour mettre à jour la liste.
4. Créez une nouvelle session, choisissez votre stratégie de dialogue et vos modèles, saisissez votre prompt et lancez le premier tour.
5. Utilisez l’export lorsque vous souhaitez une copie portable de la session (Markdown, Word ou instantané JSON — voir Sessions, export et import).

Compte & Abonnement

Gérer votre abonnement
Pour gérer votre abonnement, mettre à jour votre moyen de paiement ou télécharger vos factures, ouvrez l’application et accédez à : Compte (panneau en bas à gauche) → Mon compte → Gérer l’abonnement

Cette action ouvre le portail de facturation Stripe dans votre navigateur, depuis lequel vous pouvez effectuer toutes les opérations liées à votre abonnement. 

Annuler votre abonnement
Pour annuler, suivez le même chemin : Compte → Mon compte → Gérer l’abonnement → Annuler le plan
L’annulation prend effet à la fin de la période de facturation en cours — vous conservez un accès complet jusqu’à cette date.
Si vous annulez pendant la période d’essai gratuit de 14 jours, aucun prélèvement n’est effectué.

Changer de plan
Vous pouvez passer du plan mensuel au plan annuel (ou inversement) à tout moment depuis le portail Stripe. Les modifications prennent effet au prochain cycle de facturation.

Backend local

Metamorfon s’appuie sur un serveur FastAPI local (par défaut à l’adresse http://127.0.0.1:8000) pour des opérations telles que la validation des clés API, la liste des modèles disponibles et l’orchestration des appels pendant l’usage. L’application tente de démarrer ce serveur automatiquement.

Si la validation ou la synchronisation des modèles échoue :

• Attendez quelques secondes et utilisez « Réessayer » dans la zone des clés API.
• Vérifiez qu’aucun autre programme n’utilise le port 8000 sur votre machine.
• Assurez-vous que votre pare-feu ou votre logiciel de sécurité ne bloque pas le trafic local vers cette adresse.
• Si le problème continue, utilisez les chemins de journaux ou diagnostics affichés dans l’application, ou suivez votre procédure interne pour lancer le backend manuellement (configurations avancées).

Ce backend est local ; il ne correspond pas à l’envoi de données vers le site web de Metamorfon.

Confidentialité et flux des données

Les clés API sont stockées sur votre appareil. Elles ne sont pas envoyées aux serveurs Metamorfon sur Internet. Elles permettent à l’application d’appeler les API officielles des fournisseurs que vous avez choisis, conformément à leurs conditions.

Les prompts, complétions et contenus associés sont traités selon la configuration de votre session (modèles, accès web, etc.). En usage standard avec des modèles cloud, ce contenu est envoyé aux fournisseurs de LLM que vous avez sélectionnés — pas à Metamorfon en tant que processeur central de vos conversations. Pour une formulation juridique précise (conservation, sous-traitants, régions), renvoyez à votre politique de confidentialité et gardez cette section alignée sur celle-ci.

Les exports peuvent contenir l’intégralité du texte de la session ; traitez les fichiers partagés comme tout document sensible (voir Sessions, export et import).

Sessions, export & import

L’export permet d’extraire le dialogue de l’application sous plusieurs formats, par exemple Markdown (léger, lisible dans tout éditeur), Word ou un instantané JSON de l’état de la session.

L’import (lorsqu’il est disponible) restaure une session à partir d’un instantané JSON afin de reprendre avec les mêmes paramètres et le même historique, selon la compatibilité des versions.

Avant de partager un export : supprimez ou anonymisez les informations sensibles ; les fichiers exportés ne le sont pas automatiquement.

Métriques & coûts

L’interface affiche des indicateurs d’usage tels que des tokens et des coûts estimés pour suivre la consommation pendant une session. Ces valeurs servent à suivre l’usage dans l’application ; elles peuvent ne pas coïncider ligne à ligne avec la facture du fournisseur (arrondis, paliers tarifaires, tokens mis en cache ou règles de facturation propres à chaque fournisseur).

La facturation des appels API est entre vous et chaque fournisseur de LLM via votre compte (BYOK). Metamorfon ne vous facture pas l’usage des API des fournisseurs.

Paramètres importants (aperçu)

• Température (par modèle) : Ajuste le comportement du modèle afin de privilégier soit la créativité, soit la rigueur ; des valeurs plus basses tendent à être plus stables, des valeurs plus hautes plus variées.
• Accès web (lorsqu’il est disponible) : Autorise la session à s’appuyer sur des sources web en direct lorsque c’est pris en charge. Cela peut influencer la latence, le coût et les données qui quittent votre machine (les requêtes peuvent transiter par l’infrastructure du fournisseur avec recherche web). À activer seulement en cas de besoin.
• Modèles par défaut (ex. pour la synthèse ou la résumé) : Définissez des valeurs par défaut cohérentes dans Paramètres pour éviter de tout reconfigurer à chaque session.
• Stratégies de dialogue et modes de débat : Ils définissent l’enchaînement des tours et l’intensité du questionnement entre modèles. Des textes d’aide dans l’application complètent ces réglages ; le site présente ces notions plus en détail.

Dépannage

Prérequis système et environnement

• Système d’exploitation : Versions Windows et macOS proposées sur le site.
• Réseau : Nécessaire pour les API LLM cloud et les fonctions web optionnelles ; le backend local utilise localhost.
• Réseaux d’entreprise : Si les appels API échouent uniquement sur le Wi‑Fi du bureau, demandez à l’IT une vérification de l’inspection TLS, du proxy ou des règles de sortie vers les domaines des fournisseurs.