Pourquoi une clé API ?
La fonctionnalité d'import de devis par IA dans Domus utilise les modèles de langage d'OpenAI (GPT-4o) ou d'Anthropic (Claude). Ces services sont des APIs cloud : Domus envoie le contenu de votre devis au modèle, qui en extrait les lignes de postes et les renvoie structurées.
Pour utiliser ces services, vous avez besoin d'un compte chez le fournisseur et d'une clé API — un identifiant secret qui permet à Domus d'authentifier les requêtes en votre nom. Vous êtes facturé directement par le fournisseur selon votre consommation.
Coût réel : Un devis de 2 pages coûte environ 0,01 à 0,03 euro à traiter (selon le modèle). Pour un usage courant (5 à 20 devis par projet), comptez moins d'1 euro au total. OpenAI et Anthropic offrent des crédits gratuits à l'inscription.
Si vous ne souhaitez pas configurer de clé API, Domus reste entièrement fonctionnel — vous pouvez saisir vos articles manuellement. L'IA est un complément, pas un prérequis.
Créer une clé API OpenAI
Suivez ces étapes depuis un navigateur web :
Rendez-vous sur platform.openai.com et créez un compte (ou connectez-vous si vous en avez déjà un).
Dans le menu de gauche, cliquez sur API keys (ou passez par votre avatar en haut à droite → View API keys).
Cliquez sur Create new secret key. Donnez-lui un nom explicite (par exemple "Domus — import devis"). La clé s'affiche une seule fois — copiez-la immédiatement.
Si votre compte est vide, ajoutez des crédits via Billing → Add to credit balance. 5 euros suffisent largement pour des mois d'utilisation normale.
Important : OpenAI affiche la clé secrète une seule fois. Si vous fermez la fenêtre sans l'avoir copiée, vous devrez en créer une nouvelle. Stockez-la immédiatement dans Domus ou dans un gestionnaire de mots de passe.
Créer une clé API Anthropic
La démarche est similaire pour Anthropic (Claude) :
Rendez-vous sur console.anthropic.com et créez un compte.
Dans le menu latéral, cliquez sur API Keys.
Cliquez sur Create Key. Nommez-la (ex : "Domus") et copiez-la immédiatement.
Via Plans & Billing, ajoutez des crédits si nécessaire. Anthropic propose également des crédits d'essai à l'inscription.
OpenAI ou Anthropic ? Pour l'import de devis, les deux fonctionnent très bien. Claude (Anthropic) est parfois plus précis sur les documents longs ou complexes. GPT-4o (OpenAI) est légèrement plus rapide. Testez les deux et gardez celui qui correspond le mieux à vos devis.
Configurer la clé dans Domus
Une fois votre clé copiée :
Dans Domus, allez dans le menu principal → Préférences (raccourci : ⌘, sur macOS, Ctrl+, sur Windows/Linux).
Dans les Préférences, cliquez sur l'onglet Intelligence artificielle.
Choisissez OpenAI ou Anthropic selon la clé que vous avez créée.
Collez votre clé dans le champ dédié et cliquez sur Enregistrer. Domus effectue un test de connexion et vous confirme que la clé est valide.
Ouvrez un projet, allez dans un poste de dépenses et cliquez sur Importer un devis. Sélectionnez un PDF ou CSV — l'extraction démarre automatiquement.
Bonnes pratiques de sécurité
Une clé API donne accès à vos crédits chez le fournisseur. Traitez-la comme un mot de passe bancaire :
- Ne la partagez jamais : ne l'envoyez pas par email, SMS, ou dans une capture d'écran. Ne la collez pas dans un document partagé.
- Définissez une limite de dépenses : sur OpenAI, configurez un plafond mensuel via Billing → Usage limits. Cela évite toute mauvaise surprise en cas de compromission.
- Révoquez les clés inutilisées : si vous avez créé plusieurs clés lors de tests, supprimez celles que vous n'utilisez plus.
- Stockez-la dans un gestionnaire de mots de passe : Bitwarden, 1Password, le trousseau macOS — pas dans un fichier texte en clair sur votre bureau.
- En cas de compromission : révoquez immédiatement la clé dans le dashboard du fournisseur, créez-en une nouvelle et mettez à jour Domus.
Comment Domus stocke votre clé : La clé est enregistrée dans la base de données locale SQLite de Domus, sur votre machine uniquement. Elle n'est jamais envoyée à nos serveurs et ne quitte votre ordinateur que pour les requêtes vers l'API du fournisseur choisi.
Résoudre les erreurs courantes
| Message d'erreur | Cause probable | Solution |
|---|---|---|
| Invalid API key | Clé mal copiée (espace en début ou fin) | Recopiez la clé en sélectionnant précisément depuis le dashboard |
| Quota exceeded | Crédits épuisés sur le compte | Rechargez le solde sur platform.openai.com ou console.anthropic.com |
| Rate limit reached | Trop de requêtes en peu de temps | Attendez quelques secondes et réessayez — normal sur les plans gratuits |
| Connection timeout | Pas de connexion internet, ou API temporairement indisponible | Vérifiez votre connexion ; consultez status.openai.com ou status.anthropic.com |
| Model not found | Le modèle sélectionné n'est pas disponible sur votre plan | Dans les Préférences IA de Domus, sélectionnez un modèle standard (gpt-4o ou claude-3-5-sonnet) |
Prêt à importer vos devis en un clic ?
Configurez votre clé API et laissez Domus faire le travail d'extraction — gratuitement.
Télécharger Domus gratuitementWhy an API key?
The AI quote import feature in Domus uses the language models of OpenAI (GPT-4o) or Anthropic (Claude). These are cloud APIs: Domus sends the content of your quote to the model, which extracts the line items and returns them in a structured format.
To use these services, you need an account with the provider and an API key — a secret identifier that allows Domus to authenticate requests on your behalf. You are billed directly by the provider based on your usage.
Real cost: A 2-page quote costs approximately €0.01 to €0.03 to process (depending on the model). For typical use (5 to 20 quotes per project), expect less than €1 in total. OpenAI and Anthropic offer free credits on sign-up.
If you prefer not to configure an API key, Domus remains fully functional — you can enter your line items manually. AI is a complement, not a requirement.
Creating an OpenAI API key
Follow these steps from a web browser:
Go to platform.openai.com and create an account (or sign in if you already have one).
In the left-hand menu, click API keys (or go via your avatar top right → View API keys).
Click Create new secret key. Give it a descriptive name (for example “Domus — quote import”). The key is displayed only once — copy it immediately.
If your account is empty, add credits via Billing → Add to credit balance. €5 is more than enough for months of normal use.
Important: OpenAI displays the secret key only once. If you close the window without copying it, you’ll need to create a new one. Save it immediately in Domus or in a password manager.
Creating an Anthropic API key
The process is similar for Anthropic (Claude):
Go to console.anthropic.com and create an account.
In the side menu, click API Keys.
Click Create Key. Name it (e.g. “Domus”) and copy it immediately.
Via Plans & Billing, add credits if needed. Anthropic also offers trial credits on sign-up.
OpenAI or Anthropic? For quote import, both work very well. Claude (Anthropic) is sometimes more accurate on long or complex documents. GPT-4o (OpenAI) is slightly faster. Try both and keep the one that works best with your quotes.
Configuring the key in Domus
Once you have copied your key:
In Domus, go to the main menu → Preferences (shortcut: ⌘, on macOS, Ctrl+, on Windows/Linux).
In Preferences, click the Artificial Intelligence tab.
Choose OpenAI or Anthropic depending on which key you created.
Paste your key into the dedicated field and click Save. Domus runs a connection test and confirms that the key is valid.
Open a project, go to an expense category and click Import a quote. Select a PDF or CSV — extraction starts automatically.
Security best practices
An API key grants access to your credits with the provider. Treat it like a banking password:
- Never share it: don’t send it by email, SMS or in a screenshot. Don’t paste it into a shared document.
- Set a spending limit: on OpenAI, configure a monthly cap via Billing → Usage limits. This prevents nasty surprises in the event of compromise.
- Revoke unused keys: if you created several keys during testing, delete the ones you no longer use.
- Store it in a password manager: Bitwarden, 1Password, macOS Keychain — not in a plain text file on your desktop.
- If compromised: immediately revoke the key in the provider’s dashboard, create a new one and update Domus.
How Domus stores your key: The key is stored in Domus’s local SQLite database, on your machine only. It is never sent to our servers and only leaves your computer for API requests to your chosen provider.
Troubleshooting common errors
| Error message | Likely cause | Solution |
|---|---|---|
| Invalid API key | Key incorrectly copied (leading or trailing space) | Re-copy the key carefully from the dashboard |
| Quota exceeded | Credits exhausted on the account | Top up the balance on platform.openai.com or console.anthropic.com |
| Rate limit reached | Too many requests in a short time | Wait a few seconds and try again — normal on free plans |
| Connection timeout | No internet connection, or API temporarily unavailable | Check your connection; consult status.openai.com or status.anthropic.com |
| Model not found | Selected model not available on your plan | In Domus AI Preferences, select a standard model (gpt-4o or claude-3-5-sonnet) |
Ready to import your quotes in one click?
Configure your API key and let Domus handle the extraction — for free.
Download Domus for free