Baca workflow run
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.
tunggu 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": "berhasil",
"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": "gambar",
"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? |
|---|---|---|
dalam antrean | diterima, belum dimulai | ya |
berjalan | alur kerja sedang berjalan | ya |
berhasil | selesai; aset membawa keluaran | tidak |
gagal | dihentikan; kesalahan menjelaskan alasannya | tidak |
needs_input | alur kerja mengajukan pertanyaan dan menunggu jawaban | lihat di bawah |
kedaluwarsa | tidak pernah selesai sebelumnya 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 workflow tertentu membaca run dari workflow lain sebagai tidak ditemukan.
needs_input
Beberapa workflow 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
aset membawa hanya aset yang dinyatakan workflow 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 | gambar, video, audio atau dokumen |
width, height | piksel, untuk gambar dan video |
duration_seconds | untuk video dan audio |
url | tautan unduhan bertanda tangan yang berumur pendek |
url_expires_at | saat tautan itu berhenti berfungsi |
url kedaluwarsa. Unduh byte ke penyimpanan Anda sendiri saat Anda menerimanya; baca ulang run untuk mendapatkan tautan baru jika Anda memerlukannya nanti. Jangan pernah menyimpan url seolah-olah itu permanen.
Sebuah berhasil run dengan sebuah array kosong aset array berarti workflow tidak mendeklarasikan output akhir. Itu adalah kekurangan dalam penulisan workflow, bukan kegagalan API — mintalah penulisnya di Studio untuk menandai output langkah mana yang menjadi hasil akhir.