La vista previa funciona pero el renderizado no
Verifique la versión publicada, la clave/proyecto, template:render, la cuota y obtenga una vista previa de las advertencias de recursos. La vista previa puede omitir imágenes no permitidas, mientras que una representación real las rechaza.
Identifique el error antes de volver a intentarlo
| Código o síntoma | Acción |
|---|---|
PDF_TEMPLATE_VERSION_NOT_PUBLISHED |
Abra la versión de destino en el editor y publíquela, luego vuelva a intentar realizar el trabajo. |
PDF_INVALID_API_KEY / PDF_API_KEY_INSUFFICIENT_SCOPE |
Verifique la clave activa, el proyecto correcto y el alcance template:render. |
PDF_RENDER_QUOTA_EXCEEDED / quota_exceeded |
Verifique el uso del espacio de trabajo en Configuración. Los POST repetidos no restablecen la cuota. |
EXTERNAL_IMAGES_NOT_ALLOWED |
Lea la advertencia de vista previa y image Policy; utilizar los recursos permitidos por el plan del espacio de trabajo. |
ASSET_STORAGE_PLAN_REQUIRED |
Actualmente, el espacio de trabajo no puede servir a los activos del proyecto. Consulta el aviso de plan y almacenamiento en Assets. |
RENDER_TIMEOUT |
Simplifique o divida contenido grande, reduzca el trabajo con imágenes y verifique el límite de procesamiento antes de volver a intentarlo. |
| 404 inmediatamente después del render 202 | Mantenga el ID de renderizado aceptado y siga la guía de reintento de estado. |
| PDF todavía muestra una etiqueta antigua | Guarde el diseño y luego regenere la vista previa de PDF. Las entradas Run no actualizan los valores de la vista previa del editor. |
Datos faltantes
Verifique los nombres, los enlaces params, el alcance de la propiedad y la variante seleccionada. En las matrices, inspeccione el contexto del elemento y la forma JSON completa.
Recorte o exceso de espacios en blanco
Inspeccione las alturas fijas/desbordamiento, márgenes, fuentes y configuraciones de mantenimiento. Comience con entradas pequeñas y utilice la vista previa de PDF para localizar las transiciones de páginas físicas.
La descarga falla
Confirmar el éxito, los resultados retenidos y la autorización del proyecto. Las URL de descarga no eluden los controles de acceso.
HTTP 401/403
Verifique el origen de API, ApiKey, la credencial actual y los alcances. Una clave del proyecto A no puede acceder a la plantilla del proyecto B. No envíe secretos al soporte.
Conflicto de revisión del agente
Vuelva a leer el contexto actual y concilie los cambios. No sobrescriba ciegamente una revisión más reciente. Distinga el proyecto /mcp del público /docs/mcp y utilice los encabezados correctos.
Informar de forma reproducible
Proporcione tiempo, acción, plantilla/versión, ID de renderizado/entrega y errores desinfectados. Prefiere datos de reproducción falsos y censura credenciales/información personal en capturas de pantalla.