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
- Klicken Sie in Agile Render auf Neue Vorlage, dann auf Importieren.
- 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“).
- 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.
- 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:
- Kopieren Sie in Creatomate unter Project Settings den API-Schlüssel.
- Wählen Sie bei uns unter Importieren die Quelle Creatomate, dann den Weg API-Schlüssel, und fügen Sie den Schlüssel ein.
- Optional: Tragen Sie unter Nur bestimmte Vorlagen die IDs ein (durch Komma getrennt). Leer lassen bedeutet: alle Vorlagen.
- 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_IhrSchluesselDie Ü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 übertagsoder 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/templatesund/v2/templates,GET/PATCH/DELETE /v2/templates/{id}GET /v1/directfü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}/medienmit einer Datei und dem Feldextern_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 (
warningsin der Antwort vonPOST /v2/renders). Gerendert wird trotzdem. Mit"strict": truewerden daraus Fehler. So finden Sie Tippfehler in Feldnamen. - Fehlerformat: Fehler kommen als
{ "hint": …, "documentation": … }, zusätzlich mit einer deutschen Meldung im Feldnachricht. - 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
- Rufen Sie für eine typische Anfrage
POST /v2/rendersmit"dry_run": trueauf. Die Antwort zeigtvalid,errors,warningsund die voraussichtlichen Credits, ohne zu rendern. - Beheben Sie gemeldete Warnungen, etwa falsch geschriebene Elementnamen.
- Rendern Sie einige echte Beispiele und vergleichen Sie das Ergebnis.
- Stellen Sie dann Ihre Produktion um.
Fragen zum Umzug? Wir helfen gern: Support-Chat in der App unter Hilfe oder info@agiledeveloper.de.