ワークフロー run を読み取る
実行を最終ステータスまで追跡し、そのアセットを収集します。
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45runs:read が必要です。
wait は、レスポンスをその秒数まで開いたままにし、ステータスが変わり次第すぐに返します — ポーリングより安く、完了をより早く知れます。上限は45秒で、指定しなければ呼び出しはすぐに返ります。
レスポンス
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "succeeded",
"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": "image",
"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 | 意味 | 再度ポーリングしますか？ |
|---|---|---|
queued | 承認済み、未開始 | はい |
running | ワークフローが動作中です | はい |
succeeded | 完了; assets に出力が含まれる | いいえ |
failed | 停止; error が理由を示します | いいえ |
needs_input | ワークフローが質問をし、回答を待っています | 下記を参照 |
expired | expires_at までに完了しなかった | いいえ |
認識できないステータスはすべて非終端として扱い、ポーリングを続けてください — バージョンアップなしで新しいものが追加されることがあります。
credits_used は、これまでに実行が費やした合計額から返金分を差し引いたものです — 最初の請求時点から存在し、完了時だけではありません。特定のワークフローに限定されたキーは、他のワークフローの実行を見つかりませんとして扱います。
needs_input
一部のワークフローは実行中に質問をします。実行は、Morphic Studio の担当者が回答するのを待ちます。回答するには chat_id を開いてください。回答されると実行は自動的に再開し、expires_at までに誰も回答しなければ期限切れになります。
アセット
assets に含まれるのは ワークフローが出力として宣言したアセットのみ です — ステップが生成したすべての中間ファイルではありません。ここに入るものは、Studio で作成者が決定します。
| アセットのフィールド | 意味 |
|---|---|
id | Morphic におけるアセットの安定 ID。保存しても安全です |
kind | image, video, audio または document |
width, height | ピクセル、対象は image と video |
duration_seconds | video と audio の場合 |
url | 署名付きの短命なダウンロードリンク |
url_expires_at | そのリンクが使えなくなる時刻 |
url には有効期限があります。受け取ったらバイトを自分のストレージにダウンロードし、後で必要になったら実行を再取得して新しいリンクを取得してください。url を永続的なものとして保存しないでください。
assets 配列が空の succeeded の実行は、ワークフローが最終出力を宣言していないことを意味します。これはワークフロー作成上の不備であり、API の失敗ではありません — Studio で作成者に、どのステップの出力が納品物なのかをマークするよう依頼してください。