PDF-Generator API: PDFs automatisch aus Vorlagen und Daten erstellen

Die PDF-Generator API von DynaPictures erstellt PDF-Dokumente aus einer Vorlage, die du einmal gestaltest: Sende deine Daten als JSON an einen REST-Endpunkt und erhalte den Link zum fertigen ein- oder mehrseitigen PDF.

14 Tage gratis testen

14 Tage kostenlos testen. Keine Kreditkarte nötig.

API-Referenz

So funktioniert die PDF-API

Bilder automatisch per API erzeugen API zur Bildgenerierung

Gestalte das Layout einmal im Editor von DynaPictures, befüllen lässt du es von deinem Code. Jeder Text, jedes Bild und jede Farbe, die du in der Vorlage benennst, kann sich mit jeder Anfrage ändern.

  • Gestalte eine ein- oder mehrseitige Vorlage mit Texten, Bildern, Formen, Balkendiagrammen und eigenen Schriften.
  • Sende eine POST-Anfrage mit dem neuen Wert jeder benannten Ebene, Seite für Seite, und dem Format pdf.
  • Du erhältst JSON mit dem Link zum PDF, bereit zum Herunterladen, Versenden oder Speichern.
  • Erzeuge PDFs in großen Mengen aus einer CSV- oder Excel-Datei, aus Zapier, Pabbly Connect oder Integrately oder über das HTTP-Modul von Make.

Technische Daten der PDF-API

Was die PDF-Generator API heute kann, in Zahlen.

Seitengröße und Ausrichtung Jede Canvas-Größe im Hoch- oder Querformat, bis 20 Megapixel pro Seite. Voreinstellungen gibt es unter anderem für A4 hoch (1240 × 1754 px) und eine 16:9-Folie (1920 × 1080 px).
Seiten Ein- oder mehrseitige Vorlagen. Eine mehrseitige Vorlage ergibt ein PDF mit allen Seiten; POST /batch fügt Seiten aus mehreren Vorlagen zu einem PDF zusammen.
Schriften 1.093 Google Fonts, 6 websichere Schriften und die Schriften, die du hochlädst.
Dynamische Inhalte Text mit einfachem HTML, Bilder, Farben, Balkendiagramme, Tachoanzeigen und Fortschrittsbalken, jeweils über den Namen der Ebene geändert.
Ausgabe Ein PDF pro Anfrage. Jede Seite ist ein pixelgenaues Rendering ihrer Vorlagenseite und als Bild eingebettet, daher lässt sich der Text nicht markieren.
Auslieferung JSON mit imageUrl, dem Link zum PDF auf den Servern von DynaPictures. POST /batch und Bild-Links mit der Endung .pdf liefern die Datei direkt.
Speicherung und Aufbewahrung Gespeichert auf Servern von DynaPictures in Deutschland, so lange wie die Bildaufbewahrung deines Tarifs: 3 Monate bei Lite, 6 Monate bei Pro, individuell bei Personalisiert. Mit einem API-Aufruf kannst du eine Datei auch früher löschen.
Render-Timeout 120 Sekunden pro API-Anfrage, 240 Sekunden pro Bild-Link.
Viele PDFs auf einmal Eine Anfrage pro PDF aus deinem Code, ein PDF pro Zeile aus einem CSV- oder Excel-Import in der App, ein Bild-Link pro Dokument oder Zapier, Pabbly Connect, Integrately und das HTTP-Modul von Make.
Webhooks Registriere mit POST /hooks eine URL für eine Vorlage und erhalte das Ergebnis, sobald ein Rendering fertig ist.
Authentifizierung Dein API-Schlüssel als Bearer-Token im Authorization-Header.
Preis Ein Bild-Credit pro PDF-Seite. Tarife ab 29 EUR im Monat für 250 Credits, zzgl. MwSt.; 14 Tage kostenlos testen mit bis zu 100 Bildern, ohne Kreditkarte.
Hosting In Deutschland von der DynaPictures GmbH gerendert und gespeichert, gemäß DSGVO.

PDF erzeugen mit curl, JavaScript oder Python

Ersetze YOUR_TEMPLATE_ID durch die ID aus dem Editor und YOUR_API_KEY durch den Schlüssel aus deinem Konto. Jeder Eintrag in pages setzt neue Werte für die Ebenen einer Vorlagenseite; Ebenen, die du weglässt, behalten ihr Design.

curl
curl -X POST "https://api.dynapictures.com/designs/YOUR_TEMPLATE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "pdf",
    "pages": [
      {
        "index": 0,
        "layers": [
          { "name": "title", "text": "Invoice #1042" },
          { "name": "logo", "imageUrl": "https://example.com/logo.png" }
        ]
      },
      {
        "index": 1,
        "layers": [
          { "name": "total", "text": "EUR 1,250.00" }
        ]
      }
    ]
  }'
JavaScript
const response = await fetch("https://api.dynapictures.com/designs/YOUR_TEMPLATE_ID", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    format: "pdf",
    pages: [
      {
        index: 0,
        layers: [
          { name: "title", text: "Invoice #1042" },
          { name: "logo", imageUrl: "https://example.com/logo.png" }
        ]
      },
      { index: 1, layers: [{ name: "total", text: "EUR 1,250.00" }] }
    ]
  })
});
if (!response.ok) throw new Error((await response.json()).message);
const pdf = await response.json();
console.log(pdf.imageUrl); // the link to the PDF
Python
import requests

response = requests.post(
    "https://api.dynapictures.com/designs/YOUR_TEMPLATE_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "format": "pdf",
        "pages": [
            {
                "index": 0,
                "layers": [
                    {"name": "title", "text": "Invoice #1042"},
                    {"name": "logo", "imageUrl": "https://example.com/logo.png"},
                ],
            },
            {"index": 1, "layers": [{"name": "total", "text": "EUR 1,250.00"}]},
        ],
    },
    timeout=130,  # a render may take up to 120 seconds
)
response.raise_for_status()
print(response.json()["imageUrl"])  # the link to the PDF
Antwort
{
  "id": "2e3zyoys980m",
  "templateId": "b394d5f371",
  "templateName": "Invoice",
  "imageUrl": "https://edge4.dynapictures.com/8eb9e4869b/2e3zyoys980m.pdf",
  "thumbnailUrl": "https://edge4.dynapictures.com/8eb9e4869b/2e3zyoys980m-thumb-2x.jpeg",
  "metadata": "",
  "width": 1240,
  "height": 1754
}

Die imageUrl in der Antwort ist der Link zum PDF. Ein Rendering kann bis zu 120 Sekunden dauern, gib deinem HTTP-Client also mindestens so viel Zeit.

Teste die PDF-API im Browser

Diese Beispielanfrage befüllt eine mehrseitige Vorlage und liefert ein PDF. Ändere Texte oder Bildlinks und klicke auf „Anfrage senden“.
POST https://api.dynapictures.com/designs/{id}
Anfrage (bearbeitbar)
Antwort
2020
Produkt entwickelt und die ersten PDFs und Bilder generiert
3200+
Unternehmen und Fachleute erstellen PDFs und Bilder
20
Die Anzahl der Länder, aus denen unsere KundInnen stammen.
DSGVO
Made in Germany, mit DSGVO von Anfang an.

Einseitige PDFs: Zertifikate, Tickets, Gutscheine und Rechnungen

Automatischer Banner-Generator mit Bildvorlagen
Befülle eine einseitige Vorlage mit einem Namen, einer Nummer oder einem Foto und erhalte ein PDF: Zertifikate, Eventtickets, Coupons, Gutscheine, Rechnungen oder Flyer, eins pro Anfrage oder eins pro Tabellenzeile.

Mehrseitige PDFs: Berichte, Angebote und Kataloge

Gestalte jede Seite eines Berichts, eines Angebots oder eines Produktkatalogs in einer mehrseitigen Vorlage. Die API befüllt jede Seite mit eigenen Daten und liefert ein PDF mit allen Seiten, für einen Bild-Credit pro Seite.

Kunden erstellen PDFs per Formular

Binde ein Formular, das mit deiner Vorlage verknüpft ist, in deine Website ein. Deine Kunden geben ihre Daten ein und erhalten ein PDF in deinem Design, ganz ohne Code.

PDFs ohne Code erzeugen

Starte Renderings aus den Automatisierungstools, die du schon nutzt, oder rufe die REST API von jeder Plattform auf, die HTTP-Anfragen senden kann.

PDF-APIs im Vergleich?

HTML-zu-PDF-Dienste wandeln Markup um, das du selbst schreibst; DynaPictures befüllt Vorlagen aus einem visuellen Editor. Unser Ratgeber vergleicht 15 PDF-Generator-APIs.

15 PDF-Generator-APIs im Vergleich (auf Englisch)

Oder sieh dir DynaPictures im direkten Vergleich an:

Das sagen unsere Kunden

API-Aufrufe sind schnell und einfach. Super leichte Implementierung mit grundlegenden REST-API-Kenntnissen. Ich liebe die Funktion zur automatischen Größenanpassung der Textfelder, das fehlt bei ähnlichen Diensten und ist super notwendig. Gefällt mir bis jetzt sehr gut!
Ilan Manoim  - Technischer Leiter
Einfach in der Handhabung.
Hervorragend geeignet für die Automatisierung deiner Tweets in schön anzusehende Instagram-Posts, für die Personalisierung von Bildern für E-Mails an potenzielle Kunden sowie für Vorschaubilder für Print on Demand/individuelle Produkte. Sehr zu empfehlen!
Henry Hoe  - Stratege im E-Commerce Marketing

PDF-Generator API: häufige Fragen

Was ist eine PDF-Generator API?

Eine PDF-Generator API erstellt PDF-Dateien aus Daten per HTTP-Anfrage. Bei DynaPictures gestaltest du das Layout einmal als Vorlage; jeder API-Aufruf befüllt sie mit neuen Texten und Bildern und liefert den Link zum PDF.

Gibt es eine kostenlose PDF-Generator API?

DynaPictures ist nicht dauerhaft kostenlos, aber jedes neue Konto startet mit einer 14-tägigen kostenlosen Testphase mit bis zu 100 Bildern, ohne Kreditkarte. Jede PDF-Seite zählt als ein Bild, die Testphase reicht also für 100 PDF-Seiten. Danach läuft die API mit einem bezahlten Tarif weiter.

HTML-zu-PDF-API oder Vorlagen-API: Was brauche ich?

Eine HTML-zu-PDF-API wandelt HTML um, das Entwickler schreiben, und der Text bleibt markierbar; das passt zu langen Textdokumenten. Eine Vorlagen-API wie DynaPictures rendert ein Layout aus einem visuellen Editor, sodass Marketing- oder Operations-Teams das Design ohne Code ändern können. DynaPictures bettet jede Seite als Bild ein, ihr Text ist daher nicht markierbar.

Wie erzeuge ich ein PDF aus JSON?

Sende eine POST-Anfrage an https://api.dynapictures.com/designs/ gefolgt von der ID deiner Vorlage, mit deinem API-Schlüssel als Bearer-Token und einem JSON-Body, der format auf pdf setzt und unter pages die neuen Ebenenwerte jeder Seite auflistet. Die Antwort enthält imageUrl, den Link zum PDF.

Was kostet die PDF-Generator API?

Jede PDF-Seite verbraucht einen Bild-Credit. Lite kostet 29 EUR im Monat für 250 Credits oder 49 EUR für 1.000; Pro beginnt bei 79 EUR für 2.000 Credits und reicht bis 699 EUR für 200.000. Alle Preise zzgl. MwSt.

Wo werden die Daten verarbeitet?

Vorlagen werden auf Servern von DynaPictures in Deutschland gerendert, und die PDFs werden dort gespeichert. Die DynaPictures GmbH in Freiburg verarbeitet die Daten nach DSGVO. Nur eine Vorlage mit einer KI-Bildebene sendet deren Prompt an den KI-Anbieter, den du wählst, wie in der Datenschutzerklärung beschrieben.

Kann ich viele PDFs auf einmal erzeugen?

Ja. Sende eine Anfrage pro Dokument aus deinem Code, importiere eine CSV- oder Excel-Datei und erzeuge in der App ein PDF pro Zeile, oder nutze die API aus Zapier, Pabbly Connect, Integrately oder dem HTTP-Modul von Make. POST /batch fügt Seiten aus einer oder mehreren Vorlagen zu einem einzigen PDF zusammen.

Welche Schriften und Seitengrößen kann ich nutzen?

Jede der 1.093 Google Fonts, 6 websichere Schriften oder deine eigenen hochgeladenen Schriften. Eine Seite kann jede Größe bis 20 Megapixel haben, im Hoch- oder Querformat; der Editor hat eine Voreinstellung für A4 hoch mit 1240 × 1754 px.