اقرأ عملية تشغيل سير عمل
اتبع تشغيلًا حتى يصل إلى حالة نهائية واجمع أصوله.
GET {base_url}/workflow-runs/{run_id}
GET {base_url}/workflow-runs/{run_id}?wait=45يتطلب runs: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؛ آمن للتخزين |
kind | image, video, audio أو document |
width, height | بالبكسل، لـ image و video |
duration_seconds | لـ video و audio |
url | رابط تنزيل موقّع وقصير الأمد |
url_expires_at | متى يتوقف هذا الرابط عن العمل |
url تنتهي صلاحيته. نزّل البايتات إلى تخزينك الخاص عند استلامها؛ وأعد قراءة التشغيل للحصول على رابط جديد إذا احتجت إلى واحد لاحقًا. لا تخزّن url كما لو كان دائمًا.
التشغيل بالحالة succeeded مع مصفوفة assets فارغة يعني أن سير العمل لا يعلن أي مخرجات نهائية. هذه فجوة في تأليف سير العمل، وليست فشلًا في واجهة برمجة التطبيقات — اطلب من مؤلفيه في Studio تحديد أي خطوة يُعدّ ناتجها هو التسليم النهائي.