合作伙伴 API
通过 HTTPS 从你自己的系统运行 Morphic 工作流。
合作伙伴 API 会从你的软件中启动一个 Morphic 工作流。你先读取工作流的输入契约，用你的输入发起一次运行，然后跟踪该运行——通过轮询或接收 webhook——直到它返回完成的资产。
早期访问。 v1 已上线。字段名称和限制仍可能变更——请基于它进行开发，并告诉我们哪些地方不合适。
什么是工作流
工作流是你的团队在 Morphic Studio 中编写的配方：一系列生成步骤，接收命名输入并产出完成的资产。这个 API 会从你的系统中启动一个工作流并收集其输出。它不会编写工作流——这仍然留在 Studio 中，由负责创意决策的人来完成。
集成的结构
sequenceDiagram
participant You as Your system
participant M as Morphic API
You->>M: 获取工作流输入
M-->>You: 需要收集的输入
You->>M: POST 工作流运行
M-->>You: 202 + 运行 ID
循环直到终态
You->>M: GET 工作流运行
M-->>You: 状态，然后是资产
结束开始前你需要什么
| 数值 | 来源 |
|---|---|
| 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 仍然是你自己内容的源站。