Orshot: Vorlagenbasierte Video-, PDF- und Bildgenerierung sowie…

Orshot: Video-, PDF- und Bildgenerierung aus Vorlagen und Social-Media-Veröffentlichung automatisieren

Orshot ist eine API zur automatisierten Bild-, PDF- und Video-Generierung aus Vorlagen. Designe eine Vorlage einmal im Orshot-Studio (oder importiere sie aus Canva oder Figma), rendere sie dann bei jedem Aufruf mit neuen Texten, Bildern und Videos und poste das Ergebnis in derselben Anfrage an verbundene Social-Media-Konten. Das Rendering ist deterministisch: Dieselbe Vorlage plus dieselben Daten ergeben immer dasselbe Ergebnis.

• Docs: https://orshot.com/docs (hänge .md an jede Docs-URL an, um Markdown zu erhalten)
• Gehosteter MCP-Server: https://mcp.orshot.com/mcp (100+ orshot_*-Tools)
• REST-Basis: https://api.orshot.com/v1
• Kostenloser Plan: 100 Credits pro Monat, keine Kreditkarte erforderlich.

Zuerst verbinden (MCP, kein Schlüssel zum Einfügen)

Der gehostete MCP-Server ist der schnellste Weg und der einzige, der Inline-Vorschauen, visuelle Postkarten und Designprüfungen zurückgibt. Füge ihn hinzu, melde dich im Browser mit dem Orshot-Konto des Benutzers an, und jedes unten stehende Tool funktioniert.

openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth
openclaw mcp login orshot

Noch kein Orshot-Konto? Die Anmeldeseite bietet eine Registrierung; der kostenlose Plan beginnt mit 100 Credits pro Monat. Claude Code: claude mcp add --transport http orshot https://mcp.orshot.com/mcp. Cursor, Windsurf, VS Code, Codex und ChatGPT akzeptieren dieselbe URL als entfernten MCP-Server.

Bestätige mit orshot_get_account. Es gibt das Profil, Arbeitsbereiche und Credits zurück. Wenn es sagt, dass das Abonnement inaktiv ist oder ein Planlimit erreicht wurde, handelt es sich um einen Abrechnungsstatus, nicht um einen Authentifizierungsfehler: Verweise den Benutzer auf die Abrechnungsseite seines Arbeitsbereichs unter https://orshot.com/pricing und höre auf, es erneut zu versuchen.

Headless-Fallback: REST mit einem API-Key. Nur, wenn der Agent MCP nicht ausführen kann (ein Cron-Job, ein serverseitiges Skript, n8n).

export ORSHOT_API_KEY=...   # Arbeitsbereichseinstellungen > API-Schlüssel
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"

Fahre nicht fort, bis einer der beiden Wege funktioniert.

Was du damit machen kannst

Jede Zeile nennt zuerst das MCP-Tool und dann die REST-Route.

• Jede Vorlage mit deinen Daten rendern: OG-Bilder, Werbeanzeigen, Zertifikate, Rechnungen, Karussells, Reels. orshot_render_template oder POST /v1/studio/render.
• Studio-Vorlagen aus einer kurzen Beschreibung erstellen und verfeinern, mit Inline-Vorschauen und Designprüfungen. orshot_create_template_design, orshot_update_template_design, orshot_patch_template_elements (lies zuerst orshot://template-design-spec; die orshot-social-media-content-Fähigkeit enthält die Handwerksregeln).
• Echte Videos rendern: Animationen und Übergänge pro Element, Soundtracks aus dem Marken-Kit, kostenlose Bewegungsvorschauen vor einem kostenpflichtigen Rendering. Gleiches Rendering-Tool mit format: "mp4".
• Mit vorgefertigten Utility-Vorlagen beginnen: Tweet-Screenshots, Website-Screenshots, Balken- und Vergleichsdiagramme, App-Store-Screenshots, Telefon-Mockups, Hintergrundentfernung. orshot_render_library_template oder POST /v1/generate/:renderType.
• Ein Design in einem Aufruf in jedes soziale Format umwandeln (Smart Resize). size und extraSizes beim Rendern.
• Personalisierte Varianten in Serie rendern, wie Zertifikate für eine Liste von Namen. orshot_batch_render_template.
• Auf Marke bleiben: Farben, Schriftarten, Bilder, Videos und Audio aus dem Marken-Kit. orshot_get_brand_kit, orshot_import_brand_website.
• Organisieren: Ordner, Vorlagenfreigabe, Wechsel zwischen Kundenarbeitsbereichen. orshot_list_template_folders, orshot_set_active_workspace.
• Signierte dynamische URLs für OG-Bilder und Einbettungen ausstellen. orshot_create_dynamic_url oder POST /v1/signed-url/create.
• Social-Media-Beiträge entwerfen, planen und veröffentlichen, die beste Zeit zum Posten aus den eigenen Engagement-Daten des Benutzers lernen, Reichweiten- und Engagement-Analysen lesen. orshot_publish_social_post, orshot_get_best_time_to_post, orshot_get_social_analytics. Die orshot-social-media-scheduler-Fähigkeit enthält den vollständigen Ablauf.
• Automatisierungsworkflows erstellen und ausführen, die weiterhin Inhalte nach einem Zeitplan produzieren. orshot_create_workflow, orshot_run_workflow.

Beispielaufforderungen, die direkt auf diese Tools abbilden:

• "Rendere die Launch-Vorlage als OG-Bild mit dem Titel 'We just shipped'"
• "Erstelle eine Instagram-Post-Vorlage mit einer Überschrift, einem Untertitel und einem Produktbild"
• "Wandle mein Launch-Design in einem Aufruf in Instagram Story, Quadrat und OG um"
• "Generiere Zertifikate für diese Liste von 40 Namen als PDFs"
• "Mache einen Screenshot von diesem Tweet" / "Erfasse orshot.com als Bild" / "Erstelle ein Balkendiagramm aus diesen Zahlen"
• "Poste dieses Rendering zur besten Zeit auf Instagram und zeige mir, wie die Beiträge der letzten Woche abgeschnitten haben"

Kernworkflow

1. Verbinden (oben).
2. Die Vorlage finden. orshot_list_studio_templates (Suche nach Name und Tags) oder GET /v1/studio/templates/all?page=1&limit=10. Noch keine Vorlage? Nutze die 2.000+ Bibliotheksvorlagen (orshot_list_library_templates) oder entwirf eine mit orshot_create_template_design.
3. Ihre Parameter lesen. orshot_get_studio_template_modifications oder GET /v1/studio/templates/:id. Änderungen werden nach parameterId und nicht nach Ebenennamen geschlüsselt. Raten Sie niemals Schlüssel.
4. Rendern. orshot_render_template mit modifications, oder POST /v1/studio/render mit response: { type: "url", format: "png" }.
5. Ausliefern oder posten. Zeige dem Benutzer die Ausgabe-URL. Füge publish hinzu, um es im selben Aufruf in sozialen Medien zu posten.
6. Automatisieren. Füge den Aufruf in die n8n-, Make-, Zapier- oder Cron-Instanz ein, die der Benutzer bereits ausführt, oder erstelle einen Orshot-Workflow.
7. Überprüfen. orshot_list_workspace_logs oder GET /v1/workspace/logs zeigt das Rendering und seine source. Zeige die Ausgabe, bevor du sie als erledigt betrachtest.

Sicherheitsregeln für Agenten

• Bestätige, bevor etwas den Arbeitsbereich verlässt. Das Veröffentlichen eines Social-Media-Beitrags, das Ausführen eines Workflows (er verbraucht Credits und kann ausliefern oder posten) und das Löschen einer Vorlage, eines Workflows oder einer Markenressource benötigen eine explizite Zustimmung. Sage, was gepostet wird, wo und wann.
• Standardmäßig Social-Media-Beiträge als Entwürfe. "Vorbereiten", "Entwurf", "lass mich zuerst sehen" bedeuten status: "draft". Ein Entwurf erreicht niemanden, bis er veröffentlicht wird.
• Kosten vor Massenarbeit anzeigen. Renderings verbrauchen Credits, .prompt-Änderungen verbrauchen KI-Credits und jedes verbundene Social-Media-Konto ist ein kostenpflichtiges Add-on. Sage dies vor einer Schleife von Hunderten von Renderings.
• Niemals den API-Key in Chat, Dateien oder URLs einfügen. Lies ihn aus der Umgebung. Bevorzuge MCP, das überhaupt keinen Schlüssel hat.
• Lösche nichts, um "aufzuräumen", ohne Anweisung.

Häufige Fallstricke (vor dem Rendern lesen)

1. Änderungen werden nach parameterId geschlüsselt, nicht nach Ebenennamen. Wenn ein Wert ignoriert wird, ist der Schlüssel falsch. Rufe die Vorlage ab, anstatt zu raten.
2. Mehrseitige Vorlagen benötigen ein pageN@-Präfix. "page1@title", "page2@title". Ein bloßes "title" trifft nur Seite 1.
3. Die Studio-templateId ist eine Ganzzahl; die Utility-templateId ist ein String (/v1/generate/:renderType akzeptiert einen Slug wie "website-screenshot").
4. Videoausgabe benötigt keine Videoebenen. format: "mp4", "webm" oder "gif" rendert jede Vorlage. Lange Videorenderings müssen response.mode: "async" verwenden und orshot_get_render_job oder GET /v1/studio/render-jobs/:id abfragen, sonst timeoutet der Client.
5. Bild- und Video-URLs in Änderungen müssen öffentlich sein. Der Renderer ruft sie serverseitig ab; localhost, abgelaufene signierte URLs und durch Authentifizierung geschützte URLs schlagen fehl.
6. Stilüberschreibungen verwenden die Punktnotation auf der parameterId: "title.fontSize": "48px".
7. Die Antwortstruktur unterscheidet sich je nach Seitenzahl. Eine Seite: data ist ein Objekt (data.content). Mehrere Seiten: data ist ein Array von { page, content }.
8. base64 und binary kombinieren nicht. binary streamt eine Datei.
9. Credits und KI-Credits sind getrennt. .prompt-Änderungen verbrauchen zusätzlich KI-Credits.
10. Bei 429 warten unter Verwendung von Retry-After.
11. PDFs können nicht in sozialen Medien gepostet werden. Bilder können nicht an TikTok oder YouTube gehen (nur Video). Video kann nicht an Google Business gehen.
12. Social-Media-Konto-IDs sind Zahlen. Zwei Konten auf derselben Plattform haben unterschiedliche IDs. Veröffentliche immer nach ID, niemals nach Plattformnamen.
13. Social-Media-Veröffentlichung ist ein kostenpflichtiges Add-on. Arbeitsbereiche mit kostenlosem Plan können keine Konten verbinden. Die Veröffentlichung selbst verbraucht keine zusätzlichen Credits.

Rendering-Grundlagen

Vollständige Feldreferenz: references/render-configuration.md und references/api-reference.md.

await fetch("https://api.orshot.com/v1/studio/render", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
  body: JSON.stringify({
    templateId: 123,
    modifications: {
      title: "Launch day",             // Text
      hero_image: "https://.../a.png", // Bild-URL
      "title.fontSize": "56px",        // Stilüberschreibung
      "page2@title": "Slide two",      // Mehrseitig
    },
    response: { type: "url", format: "png", size: "instagram-story",
                extraSizes: ["1080x1080", "1200x630"] },
  }),
});

Dasselbe Objekt ist die Eingabe von orshot_render_template über MCP.

• format: png, jpg, webp, pdf, mp4, webm, gif.
• size rendert das Design in einer anderen Voreinstellung oder BREITExHÖHE; extraSizes fügt in einem Aufruf weitere Kopien hinzu (Smart Resize). Voreinstellungen: orshot://formats.
• response.mode: "async" gibt einen Job zurück; frage ihn ab oder übergib webhook_url. Verwende es für Videos.
• Viele Varianten auf einmal: orshot_batch_render_template, oder schleife den Rendering-Aufruf über REST.
• Signierte URLs: POST /v1/signed-url/create für eine Rendering-URL, die du einbetten kannst, ohne den Schlüssel offenzulegen.

SDKs für die Headless-Nutzung: npm install [email protected], pip install orshot==0.2.0, composer require rishimohan/orshot:0.2.0, gem install orshot -v 0.2.0.

import { Orshot } from "orshot";
const orshot = new Orshot(apiKey); // aus deiner Umgebung lesen
const res = await orshot.renderFromTemplate({
  templateId: "open-graph-image-1",
  modifications: { title: "Hello World" },
  responseType: "url",
  responseFormat: "png",
});

Social-Media-Veröffentlichung (die Kurzversion)

Orshot postet Renderings auf 13+ Plattformen: X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Telegram, Snapchat, Google Business. Die orshot-social-media-scheduler-Fähigkeit enthält Planung, Entwürfe, Analysen und beste Zeit; dies ist der Kern.

1. Konten. orshot_list_social_accounts oder GET /v1/social/accounts?include_health=true. Konten werden von einem Menschen im Dashboard verbunden (Arbeitsbereich > Soziale Netzwerke > Konten); die API kann kein Konto verbinden. Eine leere Liste bedeutet, sende den Benutzer dorthin.
2. In einem Aufruf rendern und posten. Füge publish zum Rendering hinzu:

publish: {
  accounts: [1, 3],
  content: "Bildunterschrift, max. 5000 Zeichen",
  status: "draft",                       // "published" (Standard) | "draft" | "scheduled"
  // scheduled_for: "2026-11-01T14:00:00Z", timezone: "America/New_York",
  platformOptions: { "3": { firstComment: "https://orshot.com" } },
  tiktokSettings: { autoAddMusic: true }, // TikTok-Foto-Karussells
}

Mehrseitige Vorlagen werden automatisch als Karussell gepostet. Die Antwort enthält publish[] mit pro-Konto status, url und error. Ein fehlgeschlagenes Posten blockiert niemals das Rendering.

3. Eine vorhandene Medien-URL posten. orshot_publish_social_post oder POST /v1/social/publish mit media_urls.
4. Gehaltene Beiträge. orshot_list_social_posts, orshot_get_social_post (visuelle Karte), orshot_update_social_post, orshot_publish_social_draft, orshot_discard_social_post. REST: GET|PATCH|DELETE /v1/social/posts/:id, POST /v1/social/posts/:id/publish.
5. Analysen und beste Zeit. orshot_get_social_analytics, orshot_get_social_analytics_daily, orshot_get_social_followers, orshot_get_best_time_to_post. REST: GET /v1/social/analytics, /daily, /accounts, /insights.

Übliche Rezepte

OG-Bild bei jedem Deployment

response: { type: "url", format: "png", size: "og-image" }
// <meta property="og:image" content={data.content} />

Massenverarbeitung aus einer CSV (Zertifikate, Rechnungen, Abzeichen): orshot_batch_render_template mit einem Änderungssatz pro Zeile und format: "pdf", oder schleife POST /v1/studio/render.

Wöchentliche Social-Media-Grafik, als Entwurf zur Überprüfung gepostet: rendere mit publish.status: "draft", dann orshot_publish_social_draft, nachdem der Benutzer zugestimmt hat.

Ein Design, jede Größe: extraSizes: ["1080x1920", "1080x1080", "1200x630"].

TikTok-, Instagram- oder LinkedIn-Karussell: siehe die orshot-carousel-Fähigkeit.

Wiederkehrende Pipeline: references/recurring-automation.md. Überprüfe die Arbeitsbereichsprotokolle auf die source, die der Benutzer bereits ausführt (n8n, Make, Zapier, SDK) und füge hinzu; biete Orshot-Workflows nur an, wenn sie noch nichts ausführen.

Referenzdateien

Lies diese bei Bedarf; sie werden nicht standardmäßig geladen.

Datei	Wann
references/api-reference.md	Jeder REST-Endpunkt: Rendering, Vorlagen, signierte URLs, Marken-Assets, dynamische URLs, Ordner, Workflows
references/render-configuration.md	Änderungstypen, Videooptionen, asynchrone Jobs, Animationen, Audio, Smart Resize, Antworttypen, Credits
references/template-design-spec.md	Elementschema zum Erstellen oder Bearbeiten von Vorlagen über die API
references/recurring-automation.md	n8n-, Make-, Zapier-, Pipedream-, Cron- und Orshot-Workflows-Playbook
references/integrations-and-errors.md	Integrationsliste, Fehlercodes, Best Practices
references/oauth-developer-apps.md	Erstellen einer Drittanbieter-App auf Orshot mit OAuth
references/embed.md	White-Label-Editor-Einbettung (iframe, React, Vue)
references/migration.md	Migration von Bannerbear, Placid, Templated, Creatomate oder ähnlichen

Jede Docs-Seite ist als Markdown verfügbar: https://orshot.com/docs/<pfad>.md. Der MCP-Server liefert auch orshot://template-design-spec und orshot://formats.

Kurzreferenz

# verbinden
openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth && openclaw mcp login orshot
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"   # REST-Prüfung

# Vorlagen
GET  /v1/studio/templates/all?page=1&limit=2

…

[gekürzt für die Übersetzung]