Die Vorschau funktioniert, das Rendern jedoch nicht
Überprüfen Sie die veröffentlichte Version, den Schlüssel/das Projekt, template:render, das Kontingent und die Vorschau-Ressourcenwarnungen. Die Vorschau kann unzulässige Bilder auslassen, während ein echtes Rendering sie ablehnt.
Identifizieren Sie den Fehler, bevor Sie es erneut versuchen
| Code oder Symptom | Aktion |
|---|---|
PDF_TEMPLATE_VERSION_NOT_PUBLISHED |
Öffnen Sie die Zielversion im Editor und veröffentlichen Sie sie. Versuchen Sie dann den Job erneut. |
PDF_INVALID_API_KEY / PDF_API_KEY_INSUFFICIENT_SCOPE |
Überprüfen Sie den aktiven Schlüssel, das richtige Projekt und den template:render-Bereich. |
PDF_RENDER_QUOTA_EXCEEDED / quota_exceeded |
Überprüfen Sie die Arbeitsbereichsnutzung in den Einstellungen. Wiederholte POSTs stellen das Kontingent nicht wieder her. |
EXTERNAL_IMAGES_NOT_ALLOWED |
Lesen Sie die Vorschauwarnung und Bildrichtlinie; Verwenden Sie die im Plan des Arbeitsbereichs zulässigen Ressourcen. |
ASSET_STORAGE_PLAN_REQUIRED |
Der Arbeitsbereich kann derzeit keine Projektressourcen bereitstellen. Überprüfen Sie den Plan und den Speicherhinweis in Assets. |
RENDER_TIMEOUT |
Vereinfachen oder teilen Sie große Inhalte, reduzieren Sie die Bildarbeit und überprüfen Sie die Verarbeitungsgrenze, bevor Sie es erneut versuchen. |
| 404 unmittelbar nach Render 202 | Behalten Sie die akzeptierte Render-ID bei und befolgen Sie die Statuswiederholungsanweisungen](/docs/de/developers/render-reference/). |
| PDF zeigt immer noch ein altes Etikett | Speichern Sie das Design und erstellen Sie dann die PDF-Vorschau neu. Run-Eingaben aktualisieren die Werte der Editorvorschau nicht. |
Fehlende Daten
Überprüfen Sie Namen, params-Bindungen, Propsumfang und ausgewählte Variante. Überprüfen Sie in Arrays den Elementkontext und die vollständige JSON-Form.
Ausschnitt oder überschüssiger Leerraum
Überprüfen Sie feste Höhen/Überlauf, Ränder, Schriftarten und Zusammenhalteeinstellungen. Beginnen Sie mit kleinen Eingaben und verwenden Sie die PDF-Vorschau, um physische Seitenübergänge zu lokalisieren.
Der Download schlägt fehl
Bestätigen Sie den Erfolg, die beibehaltene Ausgabe und die Projektautorisierung. Download-URLs umgehen die Zugriffskontrollen nicht.
HTTP 401/403
Überprüfen Sie den Ursprung von API, ApiKey, die aktuellen Anmeldeinformationen und die Bereiche. Der Schlüssel eines Projekts A kann nicht auf die Vorlage von Projekt B zugreifen. Senden Sie keine Geheimnisse an den Support.
Agent-Revisionskonflikt
Lesen Sie den aktuellen Kontext erneut und gleichen Sie die Änderungen ab. Überschreiben Sie nicht blind eine neuere Revision. Unterscheiden Sie das Projekt /mcp vom öffentlichen /docs/mcp und verwenden Sie die richtigen Header.
Reproduzierbar melden
Geben Sie Zeit, Aktion, Vorlage/Version, Render-/Liefer-IDs und bereinigte Fehler an. Bevorzugen Sie gefälschte Reproduktionsdaten und schwärzen Sie Anmeldeinformationen/persönliche Informationen in Screenshots.