Partner-API
Führen Sie einen Morphic-Workflow aus Ihren eigenen Systemen über HTTPS aus.
Die Partner-API startet einen Morphic-Workflow aus Ihrer eigenen Software. Sie lesen den Eingabevertrag eines Workflows, starten einen Lauf mit Ihren Eingaben und verfolgen dann den Lauf – per Polling oder per Webhook-Empfang – bis er seine fertigen Assets zurückgibt.
Früher Zugang. v1 ist live. Feldnamen und Limits können sich noch ändern — bauen Sie darauf auf und sagen Sie uns, was nicht passt.
Was ein Workflow ist
Ein Workflow ist ein Rezept, das Ihr Team in Morphic Studio erstellt: eine Abfolge von Generierungsschritten, die benannte Eingaben entgegennimmt und fertige Assets erzeugt. Diese API startet einen solchen Ablauf aus Ihren Systemen heraus und sammelt seine Ausgabe ein. Sie erstellt keine Workflows — das bleibt in Studio, wo die Menschen arbeiten, die die kreativen Entscheidungen treffen.
Die Form einer Integration
sequenceDiagram
participant You as Ihr System
participant M as Morphic API
You->>M: GET workflow inputs
M-->>You: die zu erfassenden Eingaben
You->>M: POST workflow run
M-->>You: 202 + Lauf-ID
loop bis zum Endzustand
You->>M: GET workflow run
M-->>You: Status, dann Assets
endWas Sie vor dem Start benötigen
| Wert | Woher es kommt |
|---|---|
| API-Schlüssel | Ein Administrator Ihrer Morphic-Organisation erstellt ihn in Studio; der Schlüssel wird nur einmal angezeigt |
| Basis-URL | https://api.morphic.com/v1/partner — wird auch auf der Seite für API-Schlüssel in Studio angezeigt; siehe Umgebungen für Staging |
org_id | Ihre Morphic-Organisation — wird auf der Seite für API-Schlüssel in Studio mit einer Kopieren-Schaltfläche angezeigt |
project_id | die Arbeitsfläche, in der die Läufe landen: Öffnen Sie sie in Studio und kopieren Sie die ID aus ihrer URL, …/editor/<project_id>/canvas (die ID in einer /projects/… URL ist eine andere) |
workflow_id | der Workflow, den Sie ausführen sollen |
Kein Datei-Upload
Sie laden uns nie Byte-Daten hoch. Jede Dateieingabe ist ein öffentlichen HTTPS-Link den wir abrufen und verifizieren — siehe Dateien per URL übergeben. Dadurch bleibt ein einziger Vertrag für Bilder, Video, Audio und Dokumente bestehen, und Ihr CDN bleibt die Ursprungsquelle Ihrer eigenen Inhalte.
Weiterlesen
Authentifizierung
Schlüssel, Berechtigungen und Umgebungen
Konventionen
IDs, Zeitstempel, Fehler, Wiederholungsversuche
Die Eingaben eines Workflows abrufen
Der Eingabevertrag, gegen den gesammelt wird
Dateien per URL übergeben
Die Verknüpfungsregeln, die wir durchsetzen
Einen Workflow-Lauf starten
Arbeit starten
Einen Workflow-Run lesen
Status und Assets
Webhooks
Informiert werden, statt zu fragen
Fehler & Limits
Jeder Fehlercode und jede Obergrenze