Baca run alur kerja
Ikuti sebuah run hingga status terminal dan kumpulkan asetnya.
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45Memerlukan runs:read.
wait menahan respons tetap terbuka hingga selama itu dalam detik dan mengembalikan segera setelah status berubah — lebih murah daripada polling, dan lebih cepat mengetahui saat selesai. Batasnya 45 detik; tanpa itu panggilan kembali segera.
Respons
{
"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
status | Arti | Periksa lagi? |
|---|---|---|
queued | diterima, belum dimulai | ya |
running | alur kerja sedang berjalan | ya |
succeeded | selesai; assets membawa keluaran | tidak |
failed | dihentikan; error menjelaskan alasannya | tidak |
needs_input | alur kerja mengajukan pertanyaan dan menunggu jawaban | lihat di bawah |
expired | tidak selesai sebelum expires_at | tidak |
Perlakukan status apa pun yang tidak Anda kenali sebagai non-terminal dan terus lakukan polling — yang baru dapat muncul tanpa peningkatan versi.
credits_used adalah yang telah dihabiskan run sejauh ini, setelah dikurangi pengembalian dana — ada sejak tagihan pertamanya, bukan hanya setelah selesai. Kunci yang dibatasi ke alur kerja tertentu membaca run dari alur kerja lain sebagai tidak ditemukan.
needs_input
Beberapa alur kerja mengajukan pertanyaan di tengah proses. Run menunggu seseorang di Morphic Studio untuk menjawabnya; buka chat_id untuk melakukannya. Run akan dilanjutkan sendiri setelah dijawab, dan kedaluwarsa jika tidak ada yang melakukannya sebelum expires_at.
Aset
assets membawa hanya aset yang dinyatakan alur kerja sebagai output-nya — bukan setiap file perantara yang dihasilkan langkah-langkahnya. Apa yang sampai di sini adalah keputusan yang dibuat para penulisnya di Studio.
| Kolom aset | Arti |
|---|---|
id | ID stabil aset di Morphic; aman disimpan |
kind | image, video, audio atau document |
width, height | piksel, untuk image dan video |
duration_seconds | untuk video dan audio |
url | link unduhan bertanda tangan yang berumur pendek |
url_expires_at | saat link itu berhenti berfungsi |
url kedaluwarsa. Unduh byte ke penyimpanan Anda sendiri saat Anda menerimanya; baca ulang run untuk mendapatkan link baru jika Anda memerlukannya nanti. Jangan pernah menyimpan url seolah-olah itu permanen.
Run succeeded dengan array assets kosong berarti alur kerja tidak mendeklarasikan output akhir. Itu adalah kekurangan dalam penulisan alur kerja, bukan kegagalan API — mintalah penulisnya di Studio untuk menandai output langkah mana yang menjadi hasil akhir.