← Daten und Automatisierung

Automate: Bilder per URL und API erzeugen

Zuletzt aktualisiert 22. Oktober 2026

Im Template-Editor erzeugst du mit Automate Bilder und Videos aus deinem Template, ohne den Design-Generator. Du bekommst eine Bild-URL, in der die Werte deiner Input-Felder stehen, oder eine fertige Anfrage an die API. Über die API bestellen andere Programme Bilder bei Bluepic. Den Tab API brauchst du nur, wenn jemand so eine Anbindung baut. Du findest Automate im Menü Share des Template-Editors.

Das geht in zwei Schritten:

  1. Erstelle im Popup Automate eine Bild-URL mit deinen Werten.
  2. Teste im Tab API eine Anfrage an die API.

Bild-URL erstellen

  1. Klicke oben rechts in der Toolbar auf Share. Ein Menü öffnet sich.
    Share-Menü im Template-Editor mit markiertem Punkt Automate.
  2. Klicke auf Automate. Bluepic speichert das Template, und das Popup Automate öffnet sich im Tab Image URL. Oben steht die URL deines Templates, darunter eine Live-Vorschau. Jedes Input-Feld ist ein Wert in der URL, hinter einem Gleichheitszeichen.
  3. Klicke in der URL auf einen Wert. Je nach Input-Feld geht es so weiter:
    • Für einen Text:
      • Gib deinen Text ein und drücke Enter.
    • Für ein Bild:
      • Wähle eines deiner Bilder aus der Liste.

    Die Live-Vorschau zeigt dein Design jetzt mit dem neuen Wert.
    Es erscheint „Query string is … bytes, the API accepts 2048“?

    Der Teil der URL nach dem ? darf höchstens 2048 Bytes lang sein. Kürze einen Wert oder entferne einen.


    Automate im Tab Image URL: Ein Wert in der URL wurde geändert, die Live-Vorschau zeigt ihn.
  4. Klicke rechts neben der URL auf das Zahnrad. Das Popup URL settings öffnet sich.
    URL settings mit Readable alias, Format und Scale.
  5. Wähle die Einstellungen für deine URL:
    • Readable alias: Statt der ID des Templates steht ein lesbarer Name in der URL. Kreuzt du es an, wählst du darunter bei Scope, ob die URL unter Personal oder unter deinem Team steht, und gibst bei Alias den Namen ein. Mit Save speicherst du den Alias. Er gilt sofort für das Template, nicht nur für diese URL. Änderst du später den Alias oder den URL-Scope deines Teams, funktionieren URLs mit dem alten Namen nicht mehr.
    • Canvas: welcher Canvas gerendert wird. Gibt es nur, wenn das Template mehrere Canvases hat.
    • Format: der Dateityp, zum Beispiel png oder jpeg, bei Animationen mp4 oder mov.
    • Scale: die Größe der Datei, von @0.5x bis @4x.
  6. Klicke rechts neben der URL auf das Symbol mit den zwei Blättern. Das ist Copy URL. Die URL ist jetzt in deiner Zwischenablage. Jeder, der sie kennt, kann die Datei abrufen. Schreib deshalb keine privaten Daten hinein.
    Rechtes Ende der URL-Leiste im Tab Image URL mit markierten Symbolen Copy URL, Open in a new tab und Zahnrad.
  7. Klicke auf das Symbol mit dem Pfeil aus dem Kasten. Das ist Open in a new tab. Die Datei öffnet sich in einem neuen Browser-Tab.
  8. Prüfe, ob die Datei deine Werte zeigt und den richtigen Dateityp hat.
    Die Datei zeigt deine Werte nicht?

    Schlägt das Rendering fehl, liefert die URL das gespeicherte Vorschaubild des Templates statt eines Fehlers. Prüfe die Werte in der URL. Am sichersten kopierst du die URL neu aus Automate.

Bild-URLs laufen über image.bluepic.io, Videos über video.bluepic.io. Du kannst sie überall einbinden, wo ein Bild oder Video per Link geladen wird.

API-Anfrage testen

  1. Klicke im Popup Automate oben auf den Tab API. Oben steht jetzt POST https://api.bluepic.io/v1/renders. Darunter siehst du dieselbe Anfrage als curl-Befehl, mit den Werten aus dem Tab Image URL und deinem API-Key. Hast du noch keinen API-Key, legt Studio einen für dich an.
    Es erscheint „No API key: …“?

    Studio konnte keinen API-Key für dich anlegen. Erstelle einen unter Settings → Developer → Keys und öffne Automate neu.

  2. Soll deine Anwendung nicht auf die Datei warten, kreuze Render as a job an. Die API antwortet dann sofort mit einem Auftrag statt der Datei. Du fragst ihn mit GET /v1/renders/{id} ab oder trägst eine Webhook-URL ein, an die Bluepic das Ergebnis meldet. Das Ergebnis bleibt 30 Tage gespeichert.
  3. Klicke oben rechts auf das Dreieck. Das ist Send request. Bluepic rendert dein Design über die API. Das Ergebnis erscheint statt der Live-Vorschau, darunter Status, Dateityp, Größe und Dauer. Das ist ein echtes Rendering und kostet Credits. Kommt es aus dem Cache, steht dort „from cache, not billed“.
    Automate im Tab API mit dem curl-Befehl; der Key ist verdeckt. Der Button Send request ist markiert.
  4. Klicke auf Back to live preview. Die Live-Vorschau erscheint wieder. Mit Download daneben speicherst du vorher das Ergebnis.
  5. Klicke auf das Symbol mit den zwei Blättern. Das ist Copy as curl. Der Befehl ist jetzt in deiner Zwischenablage. Er enthält deinen API-Key. Gib ihn deshalb nicht weiter.

Willst du die Anfrage weiter ausbauen, klicke auf Open in Explorer. Der Explorer im Developer-Bereich öffnet sich in einem neuen Tab, mit deinem Template schon ausgewählt.

Kosten

  • Ein neues Bild über eine Bild-URL oder die API kostet 0,01 Credit.
  • Ein neues Video über eine Video-URL oder die API kostet 0,1 Credit.
  • Kommt ein Ergebnis aus dem Cache, weil genau diese Werte schon einmal gerendert wurden, wird es nicht berechnet.
  • Sind die Credits aufgebraucht, liefern URLs weiter ihre Datei, aber mit Wasserzeichen.