بدء تشغيل سير عمل
ابدأ مسار عمل باستخدام مدخلاتك واحصل على معرّف تشغيل في المقابل.
POST {base_url}/workflow-runsيتطلب runs:write.
الطلب
POST {base_url}/workflow-runs
Authorization: Bearer mor_live_…
Content-Type: application/json
{
"org_id": "0192f3c1-7a44-7d10-9b22-1e5c8f0a3b61",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"idempotency_key": "story-48213-v2",
"inputs": {
"story_document": "https://cdn.example.com/stories/48213.pdf",
"character_sheets": [
"https://cdn.example.com/chars/48213-a.png",
"https://cdn.example.com/chars/48213-b.png"
],
"episode_count": 8,
"tone": "إثارة"
}
}| حقل الجسم | مطلوب | المعنى |
|---|---|---|
org_id | نعم | مؤسستك؛ يجب أن يطابق مفتاحها |
project_id | نعم | اللوحة التي يصل إليها التشغيل وأصوله — المعرّف في عنوان Studio URL الخاص بها، …/editor/<project_id>/canvas |
workflow_id | نعم | سير العمل المراد تشغيله |
المدخلات | نعم | كائن مُفهرس بمفتاح كل مدخل المفتاح |
idempotency_key | موصى به | يجعل إعادة المحاولة آمنة — راجع الاتفاقيات |
workflow_version_id | لا | يثبّت الإصدار الذي تُقرأ منه المدخلات |
معرّف webhook | لا | يرسل أحداث هذا التشغيل إلى نقطة نهاية مسجّلة واحدة — راجع خطافات الويب |
كيفية إرسال كل مدخل
يقبل | إرسال | مع allow_multiple |
|---|---|---|
القيمة | السلسلة النصية أو الرقم أو القيمة المنطقية نفسها | مصفوفة منها |
رابط | رابط HTTPS عام واحد، كسلسلة نصية | مصفوفة من الروابط |
الخيار | واحد options[].id، تمامًا كما هي مُعطاة | مصفوفة من المعرّفات |
الاستجابة
202 Accepted
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "queued",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"ingested": [
{ "input": "story_document", "bytes": 184320, "mime_type": "application/pdf" },
{ "input": "character_sheets", "bytes": 962144, "mime_type": "image/png" },
{ "input": "character_sheets", "bytes": 883021, "mime_type": "image/png" }
],
"poll_after_seconds": 60,
"expires_at": "2026-09-23T04:10:00Z"
}
}| حقل الاستجابة | المعنى |
|---|---|
المعرّف | معرّف التشغيل. استعلم عنه دوريًا، واحتفظ به في سجلك الخاص |
الحالة | في قائمة الانتظار عند القبول |
chat_id | جلسة Studio التي يتم فيها التشغيل. افتحها لمشاهدة التشغيل أو الإجابة عن سؤال يطرحه |
المُستَوعَب | مدخل واحد لكل ملف تم جلبه، بالترتيب الذي أُرسل به. مفيد للتأكد من أنك أرسلت ما كنت تقصده |
poll_after_seconds | مدة الانتظار قبل أول استعلام |
expires_at | عندما يُتخلّى عن تشغيل غير مكتمل باعتباره منتهي الصلاحية |
يتم جلب كل رابط والتحقق منه قبل رمز 202. التشغيل الذي يعود مقبولًا تكون ملفاته قد وصلت، لذا فإن الرابط السيئ يؤدي فورًا إلى 400 بدلًا من فشل بعد عشر دقائق.