Mulai run alur kerja
Mulai alur kerja dengan input Anda dan dapatkan ID run sebagai balasan.
POST {base_url}/workflow-runsMemerlukan runs:write.
Permintaan
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",
"name": "Story 48213",
"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": "thriller"
}
}| Bidang isi | Diperlukan | Arti |
|---|---|---|
org_id | ya | organisasi Anda; harus cocok dengan kunci |
project_id | ya | Canvas tempat run dan asetnya berada — ID dalam URL Studio-nya, …/editor/<project_id>/canvas |
workflow_id | ya | alur kerja yang akan dijalankan |
inputs | ya | sebuah objek yang dikunci dengan key tiap input |
idempotency_key | disarankan | membuat percobaan ulang aman — lihat Konvensi |
workflow_version_id | tidak | mengunci versi tempat Anda membaca input |
webhook_id | tidak | mengirim event run ini ke satu endpoint terdaftar — lihat Webhook |
name | tidak | judul sesi Studio milik run, ditampilkan sebagai API: <name>. Satu baris, maksimal 250 karakter. Jika dihilangkan, nama alur kerja yang dipakai |
Cara mengirim setiap input
accepts | Kirim | Dengan allow_multiple |
|---|---|---|
value | string, angka, atau boolean itu sendiri | larik dari semuanya |
url | satu link HTTPS publik, sebagai string | larik link |
option | satu options[].id, persis seperti yang diberikan | larik ID |
Respons
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"
}
}| Bidang respons | Arti |
|---|---|
id | ID run. Lakukan polling padanya, dan simpan untuk dicocokkan dengan catatan Anda sendiri |
status | queued saat diterima |
chat_id | sesi Studio tempat run berlangsung. Buka untuk memantau run atau menjawab pertanyaan yang diajukannya |
ingested | satu entri per file yang diambil, sesuai urutan yang dikirim. Berguna untuk memastikan Anda mengirim apa yang Anda maksud |
poll_after_seconds | berapa lama menunggu sebelum polling pertama |
expires_at | ketika sebuah run yang belum selesai ditinggalkan sebagai expired |
Setiap link diambil dan diverifikasi sebelum 202. Run yang kembali diterima sudah memiliki file-nya di tangan, jadi link yang buruk langsung menjadi 400, bukan kegagalan sepuluh menit kemudian.