パートナー API
自分のシステムから HTTPS 経由で Morphic のワークフローを実行します。
Partner API は、お使いのソフトウェアから Morphic のワークフローを開始します。ワークフローの入力契約を読み取り、入力を指定して実行を開始し、その後は実行を追跡します。ポーリングするか、Webhook を受け取ることで、完了したアセットが返ってくるまで追い続けます。
早期アクセス版。 v1 は公開中です。フィールド名や上限は今後も変更される可能性があります。これを前提に実装し、合わない点があればお知らせください。
ワークフローとは
ワークフローは、チームが Morphic Studio で作成するレシピです。名前付きの入力を受け取り、完成したアセットを生成する一連の生成ステップから成ります。この API は、お使いのシステムからそのワークフローを開始し、出力を収集します。ワークフローを作成する機能はありません。作成は Studio で行い、クリエイティブな判断を担う人々がそこで作業します。
統合の全体像
sequenceDiagram
participant You as あなたのシステム
participant M as Morphic API
You->>M: ワークフロー入力を GET
M-->>You: 収集する入力
You->>M: ワークフロー実行を POST
M-->>You: 202 + 実行 ID
terminal までループ
You->>M: ワークフロー実行を GET
M-->>You: ステータス、次にアセット
end始める前に必要なもの
| 値 | 取得元 |
|---|---|
| API キー | Morphic 組織の管理者が Studio で作成します。キーは一度だけ表示されます |
| ベース URL | https://api.morphic.com/v1/partner — Studio の API キー ページにも表示されます。参照先: 環境 ステージング用 |
org_id | あなたの Morphic 組織 — Studio の API キー ページに、コピー ボタン付きで表示されます |
project_id | 実行先となるキャンバス: Studio で開き、その URL から ID をコピーします, …/editor/<project_id>/canvas （ /projects/… URL にある ID とは別のものです） |
workflow_id | 実行を依頼されたワークフロー |
ファイルのアップロードはありません
バイト列を当社にアップロードすることはありません。すべてのファイル入力は 公開HTTPSリンク 当社が取得して検証する URLでファイルを渡すものです — 参照先: これにより、画像・動画・音声・ドキュメントで共通の契約を維持でき、CDN をコンテンツのオリジンのままにできます。