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 ; 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. |
| 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.