Agile Developer Hilfe-Center › Agile Render

Umzug von einem anderen Vorlagen-Dienst

Sie rendern Videos und Bilder schon mit einem anderen Dienst und möchten zu Agile Render wechseln? In den meisten Fällen importieren Sie Ihre Vorlagen und tauschen danach in Ihrer Integration nur Basis-URL und API-Schlüssel aus.

Vorlagen sind bei uns offenes JSON (RenderScript). Daten setzen Sie über Modifications ein, Renders starten Sie mit template_id. Beim Import über den API-Schlüssel bleiben die Vorlagen-IDs erhalten, sodass bestehende Aufrufe weiter funktionieren.

Schritt 1: Vorlagen importieren

  1. Klicken Sie in Agile Render auf Neue Vorlage, dann auf Importieren.
  2. Wählen Sie die Quelle, aus der Ihre Vorlagen stammen. Designs aus Canva, Figma, Photoshop, PowerPoint, PDF oder SVG laden Sie als Datei hoch (siehe Artikel „Canva-Designs importieren“ und „Figma-, PSD-, PPTX-, PDF- und SVG-Import“).
  3. Vorlagen im JSON-Format fügen Sie über JSON einfügen ein und klicken auf Übernehmen. Dabei entsteht eine neue Vorlage mit neuer ID. Das eignet sich, um einzelne Vorlagen schnell auszuprobieren.
  4. Soll Ihre Integration ohne Änderung an den IDs weiterlaufen, nutzen Sie den Weg API-Schlüssel, sofern es ihn für Ihre Quelle gibt (siehe unten).

Importieren Sie dieselbe Vorlage später noch einmal, wird sie als neue Version derselben Vorlage übernommen. Ist eine ID bereits in einem anderen Arbeitsbereich vergeben, bekommt die Vorlage eine neue ID und Sie erhalten einen Hinweis.

Import per API-Schlüssel (Creatomate)

Für Vorlagen aus Creatomate gibt es den direkten Weg über den API-Schlüssel:

  1. Kopieren Sie in Creatomate unter Project Settings den API-Schlüssel.
  2. Wählen Sie bei uns unter Importieren die Quelle Creatomate, dann den Weg API-Schlüssel, und fügen Sie den Schlüssel ein.
  3. Optional: Tragen Sie unter Nur bestimmte Vorlagen die IDs ein (durch Komma getrennt). Leer lassen bedeutet: alle Vorlagen.
  4. Klicken Sie auf Vorlagen importieren.

Wir lesen damit einmalig Ihre Vorlagen und speichern den Schlüssel nicht. Die Vorlagen-IDs bleiben gleich, die Basis-URL https://api.creatomate.com ersetzen Sie in Schritt 2.

Schritt 2: Basis-URL und Schlüssel tauschen

Legen Sie unter Entwickler › API-Schlüssel einen Schlüssel an (siehe Artikel „API-Schlüssel und erste API-Anfrage“). Dann ändern Sie in Ihrer Integration zwei Werte:

| | Vorher | Nachher |
|---|---|---|
| Basis-URL | bisherige Basis-URL | https://render.agiledeveloper.de |
| Schlüssel | bisheriger API-Schlüssel | agile_render_IhrSchluessel |

Zum Beispiel in einer .env-Datei (die Namen der Variablen bleiben, wie sie in Ihrer Integration heißen):

RENDER_API_BASE=https://render.agiledeveloper.de
RENDER_API_KEY=agile_render_IhrSchluessel

Die Übersicht dazu finden Sie auch unter Entwickler › Schnellstart › Von einem anderen Dienst wechseln.

Unterstützte Endpunkte

  • POST /v1/renders (Antwort als Array, auch mehrere Renders über tags oder ein Array von Modifications)
  • GET /v1/renders, GET /v1/renders/{id}
  • POST /v2/renders (Antwort als einzelnes Render-Objekt), GET /v2/renders/{id}
  • GET/POST /v1/templates und /v2/templates, GET/PATCH/DELETE /v2/templates/{id}
  • GET /v1/direct für Render per URL, siehe Artikel „Render per URL“

Felder wie template_id, modifications, output_format, render_scale, max_width, max_height, webhook_url, metadata und dry_run funktionieren wie gewohnt. Die Datei-Adresse in url steht sofort fest und liefert die Datei, sobald der Render fertig ist.

Fehlende Medien

Dateien, die Sie direkt beim bisherigen Dienst hochgeladen haben, verweisen in den Vorlagen oft über eine Asset-ID statt über eine öffentliche Adresse. Solche Dateien lassen sich beim Import meist nicht abrufen. Der Import meldet sie deshalb als fehlende Medien. Medien mit öffentlicher Adresse werden beim Rendern wie gewohnt geladen.

So lösen Sie das:

  • Ersetzen Sie die Quelle im Editor durch eine eigene Datei aus Medien oder eine öffentliche Adresse, oder
  • laden Sie die Originaldateien per API nach: POST /api/v1/importe/{Import-ID}/medien mit einer Datei und dem Feld extern_id (der bisherigen Asset-ID) oder einem ZIP, in dem jede Datei nach ihrer Asset-ID benannt ist. Die ID wird dann in allen Vorlagen Ihres Arbeitsbereichs ersetzt.

Gut zu wissen

  • Prüfung statt stiller Fehler: Unbekannte Eigenschaften und Modifications, die zu keinem Element passen, melden wir als Warnung (warnings in der Antwort von POST /v2/renders). Gerendert wird trotzdem. Mit "strict": true werden daraus Fehler. So finden Sie Tippfehler in Feldnamen.
  • Fehlerformat: Fehler kommen als { "hint": …, "documentation": … }, zusätzlich mit einer deutschen Meldung im Feld nachricht.
  • Credits statt Abbruch: Sind die Credits aufgebraucht, antwortet die API mit Status 402. Ab dem Tarif Starter können Sie mit automatischer Überschreitung weiterrendern, siehe Artikel „Credits und Tarife“.
  • Gleichzeitige Renders: Je nach Tarif laufen 1 bis 15 Renders parallel, weitere warten in der Warteschlange.
  • Auflösung je Tarif: Liegt die Ausgabe über der Grenze Ihres Tarifs, wird sie proportional verkleinert und Sie erhalten eine Warnung.
  • Signierte Webhooks: Webhooks tragen den Header Agile-Signature. Sie müssen ihn nicht prüfen, sollten es aber, siehe Artikel „Webhooks“.
  • Rate-Limit: 120 Anfragen pro Minute je Schlüssel, mit X-RateLimit-*-Headern.
  • KI-Bilder: Ältere DALL-E-Modelle in provider-Angaben werden beim Import auf ein aktuelles Bildmodell umgestellt; Sie erhalten dazu einen Hinweis.
  • Aufbewahrung: Wie lange Dateien abrufbar sind, hängt von Ihrem Tarif ab (7 Tage bis 1 Jahr).

Vor dem Umschalten prüfen

  1. Rufen Sie für eine typische Anfrage POST /v2/renders mit "dry_run": true auf. Die Antwort zeigt valid, errors, warnings und die voraussichtlichen Credits, ohne zu rendern.
  2. Beheben Sie gemeldete Warnungen, etwa falsch geschriebene Elementnamen.
  3. Rendern Sie einige echte Beispiele und vergleichen Sie das Ergebnis.
  4. Stellen Sie dann Ihre Produktion um.

Fragen zum Umzug? Wir helfen gern: Support-Chat in der App unter Hilfe oder info@agiledeveloper.de.

War dieser Artikel hilfreich?

Zuletzt aktualisiert am 19. Oktober 2026

Weitere Artikel zu Agile Render

Nicht gefunden, was Sie suchen?Schreiben Sie uns. Wir helfen gern weiter.