ワークフロー run を読み取る
実行を最終ステータスまで追跡し、そのアセットを収集します。
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45必要 runs:read.
待機 レスポンスをその秒数まで開いたままにし、ステータスが変わり次第すぐに返します — ポーリングより安く、完了をより早く知れます。上限は45秒で、指定しなければ呼び出しはすぐに返ります。
レスポンス
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "成功",
"created_at": "2026-09-22T04:10:00Z",
"completed_at": "2026-09-22T04:17:12Z",
"credits_used": 1792,
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"assets": [
{
"id": "0192f3e1-8b52-7c03-a41d-6e2f9b7c1d44",
"kind": "画像",
"mime_type": "image/png",
"width": 1920,
"height": 1080,
"size_bytes": 2841233,
"url": "https://storage.googleapis.com/…",
"url_expires_at": "2026-09-22T05:17:12Z"
}
],
"error": null,
"poll_after_seconds": 60
}
}ステータス
status | 意味 | 再度ポーリングしますか？ |
|---|---|---|
キュー済み | 承認済み、未開始 | はい |
実行中 | ワークフローが動作中です | はい |
成功した | 完了; assets 出力を含む | いいえ |
失敗 | 停止; エラー 理由を示します | いいえ |
入力が必要 | ワークフローが質問をし、回答を待っています | 下記を参照 |
期限切れ | これまで一度も完了していない expires_at | いいえ |
認識できないステータスはすべて非終端として扱い、ポーリングを続けてください — バージョンアップなしで新しいものが追加されることがあります。
credits_used これまでに実行が費やした合計額から返金分を差し引いたものです — 最初の請求時点から存在し、完了時だけではありません。特定のワークフローに限定されたキーは、他のワークフローの実行を見つかりませんとして扱います。
入力が必要
一部のワークフローは実行中に質問をします。実行は、Morphic Studio の担当者が回答するのを待ちます。開いて chat_id そのために使います。回答されると実行は自動的に再開し、誰もそれまでに対応しなければ期限切れになります expires_at.
アセット
assets 含みます ワークフローが出力として宣言したアセットのみ — ステップが生成したすべての中間ファイルではありません。ここに入るものは、Studio で作成者が決定します。
| アセットのフィールド | 意味 |
|---|---|
id | Morphic におけるアセットの安定 ID。保存しても安全です |
種類 | 画像, 動画, 音声 または ドキュメント |
幅, 高さ | ピクセル、対象は 画像 と 動画 |
duration_seconds | for 動画 と 音声 |
URL | 署名付きの短命なダウンロードリンク |
url_expires_at | そのリンクが使えなくなる時刻 |
URL 期限切れになります。受け取ったらバイトを自分のストレージにダウンロードし、後で必要になったら実行を再取得して新しいリンクを取得してください。決して保存しないでください URL 永続的であるかのように。
ある 成功した 空の assets 配列は、ワークフローが最終出力を宣言していないことを意味します。これはワークフロー作成上の不備であり、API の失敗ではありません — Studio で作成者に、どのステップの出力が納品物なのかをマークするよう依頼してください。