# Résoudre les problèmes courants

Résoudre les échecs de rendu, les données manquantes, les images bloquées et les sauts de page.

## L'aperçu fonctionne mais pas le rendu
Vérifiez la version publiée, la clé/le projet, `template:render`, les quotas et les avertissements de ressources d'aperçu. L'aperçu peut omettre les images non autorisées tandis qu'un rendu réel les rejette.

## Identifiez l'erreur avant de réessayer

| Code ou symptôme | Action |
| --- | --- |
| `PDF_TEMPLATE_VERSION_NOT_PUBLISHED` | Ouvrez la version cible dans l'éditeur et publiez-la, puis réessayez le travail. |
| `PDF_INVALID_API_KEY` / `PDF_API_KEY_INSUFFICIENT_SCOPE` | Vérifiez la clé active, le projet correct et la portée `template:render`. |
| `PDF_RENDER_QUOTA_EXCEEDED` / `quota_exceeded` | Vérifiez l'utilisation de l'espace de travail dans Paramètres. Les POST répétés ne restaurent pas le quota. |
| `EXTERNAL_IMAGES_NOT_ALLOWED` | Lisez l'avertissement d'aperçu et [image Policy](/docs/fr/assets/images/) ; utiliser les ressources autorisées par le plan de l’espace de travail. |
| `ASSET_STORAGE_PLAN_REQUIRED` | L'espace de travail ne peut actuellement pas servir les actifs du projet. Vérifiez le plan et l'avis de stockage dans Assets. |
| `RENDER_TIMEOUT` | Simplifiez ou divisez le contenu volumineux, réduisez le travail sur les images et vérifiez la limite de traitement avant de réessayer. |
| 404 immédiatement après le rendu 202 | Conservez l'ID de rendu accepté et [suivez les instructions de nouvelle tentative d'état](/docs/fr/developers/render-reference/). |
| PDF affiche toujours une ancienne étiquette | Enregistrez la conception, puis régénérez l'aperçu PDF. Les entrées Run ne mettent pas à jour les valeurs de l'aperçu de l'éditeur. |

## Données manquantes
Vérifiez les noms, les liaisons `params`, la portée de l'accessoire et la variante sélectionnée. Dans les tableaux, inspectez le contexte de l’élément et la forme JSON complète.

## Coupure ou espace excessif
Inspectez les hauteurs/débordements fixes, les marges, les polices et les paramètres de maintien. Commencez par une petite entrée et utilisez l’aperçu PDF pour localiser les transitions de page physiques.

## Le téléchargement échoue
Confirmer le succès, les résultats retenus et l'autorisation du projet. Les URL de téléchargement ne contournent pas les contrôles d'accès.

## HTTP 401/403
Vérifiez l'origine du API, le `ApiKey`, les informations d'identification actuelles et les étendues. Une clé du projet A ne peut pas accéder au modèle du projet B. N'envoyez pas de secrets au support.

## Conflit de révision d'agent
Relisez le contexte actuel et réconciliez les changements. N'écrasez pas aveuglément une révision plus récente. Distinguez le projet `/mcp` du public `/docs/mcp` et utilisez les en-têtes corrects.

## Rapport reproductible
Fournissez l'heure, l'action, le modèle/la version, les ID de rendu/de livraison et les erreurs nettoyées. Préférez les fausses données de reproduction et expurgez les informations d’identification/informations personnelles dans les captures d’écran.