API Partenaire
Exécutez un workflow Morphic depuis vos propres systèmes via HTTPS.
L’API partenaire démarre un workflow Morphic depuis votre propre logiciel. Vous lisez le contrat d’entrée d’un workflow, lancez une exécution avec vos entrées, puis suivez l’exécution — en la sondant ou en recevant un webhook — jusqu’à ce qu’elle vous renvoie ses assets finalisés.
Accès anticipé. La v1 est en ligne. Les noms de champs et les limites peuvent encore changer — développez dessus et dites-nous ce qui ne convient pas.
Ce qu’est un workflow
Un workflow est une recette que votre équipe rédige dans Morphic Studio : une séquence d’étapes de génération qui prend des entrées nommées et produit des assets finalisés. Cette API en lance une depuis vos systèmes et en récupère la sortie. Elle ne crée pas de workflows — cela reste dans Studio, où travaillent les personnes qui prennent les décisions créatives.
La structure d’une intégration
sequenceDiagram
participant Vous as Votre système
participant M as API Morphic
Vous->>M: GET les entrées du workflow
M-->>Vous: les entrées à récupérer
Vous->>M: POST exécution du workflow
M-->>Vous: 202 + ID d’exécution
loop until terminal
Vous->>M: GET exécution du workflow
M-->>Vous: état, puis assets
endCe dont vous avez besoin avant de commencer
| Valeur | D’où cela vient |
|---|---|
| Clé API | un administrateur de votre organisation Morphic la crée dans Studio ; la clé n’est affichée qu’une seule fois |
| URL de base | https://api.morphic.com/v1/partner — également affichée sur la page des clés API dans Studio ; voir Environnements pour la préproduction |
org_id | votre organisation Morphic — affichée, avec un bouton Copier, sur la page des clés API dans Studio |
project_id | le canevas dans lequel les exécutions arrivent : ouvrez-le dans Studio et copiez l’identifiant depuis son URL, …/editor/<project_id>/canvas (l’identifiant dans un /projects/… URL correspond à un autre) |
workflow_id | le workflow qu’on vous a demandé d’exécuter |
Il n’y a pas de téléversement de fichiers
Vous ne nous téléversez jamais d’octets. Chaque entrée de fichier est une lien HTTPS public que nous récupérons et vérifions — voir Transmission de fichiers par URL. Cela maintient un contrat unique pour les images, les vidéos, l’audio et les documents, et cela signifie que votre CDN reste l’origine de votre propre contenu.
À lire ensuite
Authentification
Clés, portées et environnements
Conventions
Identifiants, horodatages, erreurs, nouvelles tentatives
Obtenir les entrées d’un workflow
Le contrat d’entrée à respecter pour la collecte
Transmission de fichiers par URL
Les règles de liaison que nous appliquons
Démarrer une exécution de workflow
Démarrage du travail
Lire une exécution de workflow
États et assets
Webhooks
Être informé au lieu de demander
Erreurs et limites
Chaque code d’erreur et chaque limite