# Versuchen Sie es mit einem echten Rendering in Run

Run eine Vorlage mit einem API-Schlüssel, einer Version, einer Variante und Daten im Run.

**Run** ermöglicht Ihnen die Bereitstellung von Daten und die Erstellung von PDFs im Editor. Wählen Sie die Vorlagenedition aus, geben Sie ihre Eingaben ein und überprüfen Sie das Ergebnis an einer Stelle, bevor Sie die Vorlage mit Ihrer Software verbinden.

## 1. Wählen Sie einen Schlüssel, eine Version und eine Variante aus

Speichern und veröffentlichen Sie die gewünschte Version und öffnen Sie dann **Run**. Wählen Sie einen Projektschlüssel API mit `template:render`, einer **Version** und einem **Variantennamen** aus. Erstellen Sie bei Bedarf einen Schlüssel in [API Keys](/docs/de/developers/keys/).

Die Selektoren von Run sind unabhängig von der geöffneten Editoransicht. Sie können v1 ausführen, während Sie v2 anzeigen. Beim Ändern der Version werden Parameters, Defaults und Varianten dieser gespeicherten Version geladen. Warten Sie, bis es geladen ist, bevor Sie Daten eingeben. Eingaben werden in diesem Browser für jede Vorlagenversion separat gespeichert. Entwurfsversionen können ausgewählt werden, müssen jedoch vor dem Rendern veröffentlicht werden.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Run → API-Taste → Version → Variante">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>LAUFEN</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">API-TASTE</small><span class="sim-input wf-select sim-focus">Projektschlüssel<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VERSION</small><span class="sim-input wf-select">v2<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div><div><small class="sim-label">VARIANTE</small><span class="sim-input wf-select">Standard<svg class="sim-chevron" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="m4 6 4 4 4-4" /></svg></span></div></div></div></div>
<figcaption>Run → API-Taste → Version → Variante</figcaption>
</figure>

## 2. Geben Sie Parameters des Jobs ein

Erweitern Sie Parameters in Run und bearbeiten Sie die Testwerte. Felder stammen aus dem deklarierten Schema; Objekte und Arrays benötigen weiterhin ihre richtigen Typen.

Diese Eingaben gehören zum Job PDF und ändern nicht den Defaults der Vorlage. Durch das Zurücksetzen der Eingaben werden die Standardparameterwerte wiederhergestellt.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Run-Eingaben gehören zum Job und ersetzen Defaults nicht">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>RUN · Parameters</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">Empfänger</small><span class="sim-input sim-focus">Tembuilder</span></div><div><small class="sim-label">Exemplare</small><span class="sim-input">2</span></div></div><div class="ds-code"><code>{ &quot;recipient&quot;: &quot;Tembuilder&quot;, &quot;copies&quot;: 2 }</code></div></div></div>
<figcaption>Run-Eingaben gehören zum Job und ersetzen Defaults nicht</figcaption>
</figure>

## 3. Generieren Sie ein PDF und öffnen Sie das Ergebnis

Wählen Sie **Rendern**. Der Auftrag erscheint während der Verarbeitung im Verlauf von Run. Öffnen Sie die Ergebniszeile, um den Status anzuzeigen und bei Erfolg den PDF herunterzuladen.

Run führt echtes Rendering durch: Erfolgreiche Jobs werden auf das Kontingent angerechnet und erzeugen eine beibehaltene Ausgabe. Verwenden Sie den Editor [preview](/docs/de/renders/preview-render/), während Sie das Layout anpassen.

Öffnen Sie bei einem fehlgeschlagenen Job dessen Fehlerdetails, um festzustellen, ob die Eingabe, Vorlage oder Nutzungsbedingungen Aufmerksamkeit erfordern, bevor Sie es erneut versuchen.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Rendern → Verlauf → Ergebnis öffnen → Herunterladen">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Rendern · #a18f</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>Status</span><small>Erfolg</small></div><div class=""><span>Version</span><small>2 · Standard</small></div></div><div class="wf-output"><span>Dokument.pdf</span><span class="sim-control sim-focus">↓ Herunterladen</span></div></div></div>
<figcaption>Rendern → Verlauf → Ergebnis öffnen → Herunterladen</figcaption>
</figure>

## 4. Kopieren Sie eine Anfrage, um mit der Integration zu beginnen

Das Kopiermenü von Run bietet **cURL**, **JavaScript** und **Python**. Snippets verwenden `<YOUR_API_KEY>`; Geben Sie den Schlüssel in Ihrer eigenen Ausführungsumgebung an.

Das Snippet verwendet die aktuell in Run ausgewählte Version, Variante und Eingabewerte. Kopieren Sie es, nachdem Sie die Kombination ausgewählt haben, die Sie integrieren möchten. Durch eine nachträgliche Änderung des Formulars wird ein bereits kopierter Snippet nicht geändert. Informationen zu Anforderungsfeldern, Status und Download-Endpunkten finden Sie unter [Render API reference](/docs/de/developers/render-reference/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Kopieren → cURL / JavaScript / Python">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>LAUFEN</strong><div class="wf-actions"><span class="sim-control">Kopieren ⌄</span></div></div><div class="wf-rows"><div class="sim-focus"><span>cURL kopieren</span><small>Locken</small></div><div class=""><span>Kopieren Sie JavaScript</span><small>holen</small></div><div class=""><span>Python kopieren</span><small>Anfragen</small></div></div></div></div>
<figcaption>Kopieren → cURL / JavaScript / Python</figcaption>
</figure>