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=45Gerektirir runs:read.
bekleyin 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": "başarılı",
"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
durum | Anlamı | Yeniden yoklansın mı? |
|---|---|---|
kuyrukta | kabul edildi, başlamadı | evet |
çalışıyor | iş akışı çalışıyor | evet |
başarılı | tamamlandı; varlıklar çıktıyı taşır | hayır |
başarısız oldu | durduruldu; hata nedenini söyler | hayır |
needs_input | iş akışı bir soru sordu ve bir yanıt bekliyor | aşağıya bakın |
süresi dolmuş | daha önce hiç tamamlanmadı expires_at | 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 bu, ç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; chat_id bunu yapmak için açın. Yanıtlandıktan sonra çalıştırma kendiliğinden devam eder ve kimse yanıtlamazsa önce expires_at.
Varlıklar
varlıklar taşır yalnızca iş akışının çıktı olarak tanımladığı varlıkları — 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 |
tür | görüntü, video, ses veya belge |
genişlik, yükseklik | piksel, için görüntü ve video |
duration_seconds | için video ve ses |
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. Asla url sanki kalıcıymış gibi saklamayın.
Bir başarılı boş bir varlıklar dizi, 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.