Bir workflow çalıştırmasını oku
Bir çalıştırmayı son durumuna kadar izleyin ve varlıklarını toplayın.
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45runs:read gerektirir.
wait yanıtı belirtilen saniye sayısı kadar açık tutar ve durum değişir değişmez döner — yoklamadan daha ucuzdur ve bir bitişten daha hızlı haberdar eder. Üst sınır 45 saniyedir; bu olmadan çağrı hemen döner.
Yanıt
{
"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
}
}Durumlar
status | Anlamı | Yeniden yoklansın mı? |
|---|---|---|
queued | kabul edildi, başlamadı | evet |
running | iş akışı çalışıyor | evet |
succeeded | tamamlandı; assets çıktıyı taşır | hayır |
failed | durduruldu; error nedenini söyler | hayır |
needs_input | iş akışı bir soru sordu ve bir yanıt bekliyor | aşağıya bakın |
expired | expires_at zamanından önce tamamlanmadı | hayır |
Tanımadığınız herhangi bir durumu bitmeyen olarak kabul edin ve yoklamaya devam edin — sürüm numarası artmadan yenileri gelebilir.
credits_used, çalıştırmanın şu ana kadar harcadığı tutardır; iadeler düşülmüştür — ilk ücretlendirmesinden itibaren vardır, yalnızca tamamlandığında değil. Yalnızca belirli iş akışlarıyla sınırlı bir anahtar, başka herhangi bir iş akışının çalıştırmasını bulunamadı olarak okur.
needs_input
Bazı iş akışları çalışma sırasında bir soru sorar. Çalıştırma, Morphic Studio'daki bir kişinin bunu yanıtlamasını bekler; bunu yapmak için chat_id açın. Yanıtlandıktan sonra çalıştırma kendiliğinden devam eder; expires_at zamanından önce kimse yanıtlamazsa süresi dolar.
Varlıklar
assets yalnızca iş akışının çıktı olarak tanımladığı varlıkları taşır — adımlarının ürettiği tüm ara dosyaları değil. Buraya neyin geleceğine yazarları Studio'da karar verir.
| Varlık alanı | Anlamı |
|---|---|
id | Morphic'teki varlığın sabit kimliği; saklamak güvenlidir |
kind | image, video, audio veya document |
width, height | piksel, image ve video için |
duration_seconds | video ve audio için |
url | imzalı, kısa ömürlü bir indirme bağlantısı |
url_expires_at | o bağlantının çalışmayı bıraktığı zaman |
url sona erer. Bunları aldığınızda baytları kendi depolamanıza indirin; daha sonra birine ihtiyacınız olursa yeni bir bağlantı almak için çalıştırmayı yeniden okuyun. url değerini asla kalıcıymış gibi saklamayın.
assets dizisi boş olan succeeded durumundaki bir çalıştırma, iş akışının nihai çıktı tanımlamadığı anlamına gelir. Bu, bir iş akışı oluşturma eksikliğidir, bir API hatası değil — Studio'da yazarlarından hangi adımın çıktısının teslim edilecek şey olduğunu işaretlemelerini isteyin.