---
url: 'https://dxpr.com/fr/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
title: 'Dépannage IA | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T10:59:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: 'Trouvez la cause quand un bouton IA manque, est grisé ou renvoie une erreur. La plupart des problèmes viennent de l’un de trois endroits : la clé DXPR, les interrupteurs de la page AI de DXPR Builder, ou vos crédits DXPR.'
tags:
  - 'Een probleem oplossen'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T10:59:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'Dépannage IA'
      description: 'Trouvez la cause quand un bouton IA manque, est grisé ou renvoie une erreur. La plupart des problèmes viennent de l’un de trois endroits : la clé DXPR, les interrupteurs de la page AI de DXPR Builder, ou vos crédits DXPR.'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T10:59:22+0000'
      dateModified: '2026-10-24T10:59:22+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/fr/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      articleSection: 'Een probleem oplossen'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/fr/hc/documentation/learn-dxpr-builder/ai/troubleshooting'
      description: 'Trouvez la cause quand un bouton IA manque, est grisé ou renvoie une erreur. La plupart des problèmes viennent de l’un de trois endroits : la clé DXPR, les interrupteurs de la page AI de DXPR Builder, ou vos crédits DXPR.'
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: Accueil
            item: 'https://dxpr.com/fr'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: fr
---
[Help Center](/fr/hc)/[Documentation](/fr/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Een probleem oplossen](/hc/documentation/learn-dxpr-builder/troubleshooting) # Dépannage IA.

 Learn DXPR BuilderManage the siteEen probleem oplossen

   ## In this guide

 Related guides

- [Activer l’IA dans DXPR Builder](/fr/hc/documentation/learn-dxpr-builder/ai/setup)

Trouvez la cause quand un bouton IA manque, est grisé ou renvoie une erreur. La plupart des problèmes viennent de l’un de trois endroits : la clé DXPR, les interrupteurs de la page **AI** de DXPR Builder, ou vos crédits DXPR.

## Les boutons IA sont grisés

- **Pointer un bouton IA affiche « AI features are unavailable: no AI provider is configured. »** DXPR n’est pas configuré comme fournisseur IA, ou sa clé est vide. Accédez à **Configuration** > **AI** > **AI Infrastructure** > **AI Platform Providers** > **DXPR AI Provider** (`/admin/config/ai/providers/dxpr`), choisissez votre clé sous **DXPR API Key** et cliquez sur **Save configuration**.
- **Le message dit « AI features require the AI module. »** Le module AI n’est pas installé. Exécutez `composer require drupal/ai_provider_dxpr`, puis `drush en ai_provider_dxpr`.

## Un bouton IA manque

Chaque interrupteur sous **DXPR Studio** > **DXPR Builder** > **AI** (`/admin/dxpr_studio/dxpr_builder/ai_settings`) masque ses propres outils :

- **Pas de AI Agent ni de Tone of voice dans la barre d’outils du texte.** **Enable text editing assistant** est désactivé. Un profil d’utilisateur avec ses propres boutons d’éditeur de texte peut aussi les exclure : ajoutez **AI Assistant** et **AI Tone of Voice** au profil.
- **Pas de AI Agent sur la barre d’outils du builder, pas de prompt sur une page vide et pas de Edit with AI dans les menus More.** **Enable page creation assistant** est désactivé.
- **Pas de Edit with AI sur les éléments Image, ni de AI Image Generation sous Background image.** **Enable image generation** est désactivé.

Après avoir changé un interrupteur, cliquez sur **Save settings** et rechargez la page modifiée.

## Une requête échoue

- **La barre d’outils du texte dit « AI service is currently unavailable. Please try again later. »** DXPR n’a pas répondu à la demande. Réessayez dans une minute. Si cela continue d’échouer, vérifiez la clé sur la page du fournisseur et vos crédits.
- **Une demande de page ou d’élément dit « The AI service ran into a problem processing this request. »** La même cause, depuis les outils de page et d’élément. Réessayez, puis vérifiez la clé et vos crédits.
- **Une image affiche « Image generation failed. Please try again. » ou « Image editing failed. Please try again. »** DXPR n’a pas pu créer l’image, souvent à cause des crédits ou d’une description qui enfreint les règles de contenu. Cliquez sur **Retry**, ou sur **Cancel** et changez la description.
- **Un avertissement dit « Your AI credit balance is low ».** Il reste moins de 5 000 crédits. Rechargez sur dxpr.com/user/me/subscription/credits avant la panne.

## Crédits

**Usage and Credits** sur la page **AI** de DXPR Builder montre **Credits remaining** et les crédits utilisés ce mois-ci. Quand il affiche « Unable to load usage data », DXPR Builder n’a pas pu joindre dxpr.com avec la clé de produit sous **General Settings** : vérifiez cette clé et l’accès internet du serveur. Enregistrer le formulaire du fournisseur avec un compte vide affiche « You are using the Free Tier of DXPR or have run out of quota. »

## Des résultats lents ou faibles

- **Les réponses prennent du temps.** Les longs textes et les pages entières prennent plus longtemps. **DXAI Kavya M1 Fast** répond plus vite avec une qualité moindre ; choisissez-le sous **Default model** sur la page du fournisseur, ou sous **Model** dans le dialogue **AI Settings** de l’éditeur.
- **Le texte est générique.** Dites qui lit la page, à quoi elle sert et quels faits comptent. Choisissez un ton sous **Tone of voice** avant d’exécuter une commande.
- **Des liens ou images manquent dans le résultat.** **AI Output Filtering** a retiré les liens vers les domaines hors **Allowed domains**. Voir [Configuration de l’IA](/hc/documentation/learn-dxpr-builder/ai/configuration#ai-output-filtering).

## Confirmer la correction

Rechargez la page dans le builder. Le bouton **AI Agent** de la barre d’outils n’est plus grisé. La barre d’outils du texte commence par **AI Agent** et **Tone of voice**. Une courte commande comme **Polish** sur une phrase renvoie du nouveau texte.

## Et ensuite ?

[Activer l’IA dans DXPR Builder](/hc/documentation/learn-dxpr-builder/ai/setup) pour vérifier chaque réglage depuis le début.