# Essayez un vrai rendu dans Run

Run un modèle avec une clé API, une version, une variante et des données dans le Run.

**Run** vous permet de fournir des données et de créer des PDF dans l'éditeur. Sélectionnez l'édition du modèle, remplissez ses entrées et inspectez le résultat en un seul endroit avant de connecter le modèle à votre logiciel.

## 1. Sélectionnez une clé, une version et une variante

Enregistrez et publiez la version prévue, puis ouvrez **Run**. Sélectionnez une clé de projet API avec `template:render`, une **Version** et un nom de **Variante**. Créez une clé dans [API Keys](/docs/fr/developers/keys/) si nécessaire.

Les sélecteurs de Run sont indépendants de la vue ouverte de l'éditeur. Vous pouvez exécuter la v1 tout en visualisant la v2. La modification de la version charge les versions enregistrées Parameters, Defaults et les variantes ; attendez qu'il se charge avant de saisir des données. Les entrées sont conservées séparément pour chaque version de modèle dans ce navigateur. Les versions préliminaires peuvent être sélectionnées, mais doivent être publiées avant le rendu.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Run → Touche API → Version → Variante">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>COURIR</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">CLÉ API</small><span class="sim-input wf-select sim-focus">Clé du projet<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">Norme<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 → Touche API → Version → Variante</figcaption>
</figure>

## 2. Remplissez le Parameters du travail

Développez Parameters dans Run et modifiez les valeurs de test. Les champs proviennent du schéma déclaré ; les objets et les tableaux ont toujours besoin de leurs types corrects.

Ces entrées appartiennent au travail PDF et ne modifient pas le Defaults du modèle. La réinitialisation des entrées restaure les valeurs des paramètres par défaut.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Les entrées Run appartiennent au travail et ne remplacent pas Defaults">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>COURIR · Parameters</strong><div class="wf-actions"></div></div><div class="wf-fields"><div><small class="sim-label">destinataire</small><span class="sim-input sim-focus">Tembuilder</span></div><div><small class="sim-label">exemplaires</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>Les entrées Run appartiennent au travail et ne remplacent pas Defaults</figcaption>
</figure>

## 3. Générez un PDF et ouvrez le résultat

Choisissez **Rendu**. Le travail apparaît dans l’historique du Run pendant le traitement. Ouvrez sa ligne de résultats pour afficher l'état et téléchargez le PDF en cas de succès.

Run effectue un rendu réel : les tâches réussies sont prises en compte dans le quota et produisent une sortie conservée. Utilisez l'éditeur [preview](/docs/fr/renders/preview-render/) lors de l'ajustement de la mise en page.

Pour une tâche ayant échoué, ouvrez ses détails d'erreur pour identifier si l'entrée, le modèle ou les conditions d'utilisation nécessitent une attention particulière avant de réessayer.

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Rendu → historique → ouvrir le résultat → Télécharger">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>Rendu · #a18f</strong><div class="wf-actions"></div></div><div class="wf-rows"><div class=""><span>Statut</span><small>Succès</small></div><div class=""><span></span><small>2 · Norme</small></div></div><div class="wf-output"><span>document.pdf</span><span class="sim-control sim-focus">↓ Télécharger</span></div></div></div>
<figcaption>Rendu → historique → ouvrir le résultat → Télécharger</figcaption>
</figure>

## 4. Copiez une demande pour commencer l'intégration

Le menu de copie de Run propose **cURL**, **JavaScript** et **Python**. Les extraits utilisent `<YOUR_API_KEY>`; fournissez la clé dans votre propre environnement d’exécution.

L'extrait utilise la version, la variante et les valeurs d'entrée actuellement sélectionnées dans Run. Copiez-le après avoir choisi la combinaison que vous comptez intégrer ; changer le formulaire par la suite ne modifie pas un extrait déjà copié. Pour les champs de demande, l'état et les points de terminaison de téléchargement, voir [Render API reference](/docs/fr/developers/render-reference/).

<figure class="doc-sim data-assets-illustration workflow-illustration" aria-label="Copier → cURL / JavaScript / Python">
<div class="sim-stage"><div class="sim-panel"><div class="ds-head"><strong>COURIR</strong><div class="wf-actions"><span class="sim-control">Copier ⌄</span></div></div><div class="wf-rows"><div class="sim-focus"><span>Copier cURL</span><small>boucle</small></div><div class=""><span>Copier JavaScript</span><small>récupérer</small></div><div class=""><span>Copier Python</span><small>demandes</small></div></div></div></div>
<figcaption>Copier → cURL / JavaScript / Python</figcaption>
</figure>
