ワークフロー実行を開始する
入力を使ってワークフローを開始し、run id を返します。
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": "thriller"
}
}| 本文フィールド | 必須 | 意味 |
|---|---|---|
org_id | はい | あなたの組織。キーのものと一致している必要があります |
project_id | はい | ランとそのアセットが配置されるキャンバス。Studio URL内のID、 …/editor/<project_id>/canvas |
workflow_id | はい | 実行するワークフロー |
入力 | はい | 各入力の キー |
idempotency_key | 推奨 | 再試行を安全にします — 参照 規約 |
workflow_version_id | いいえ | 入力を読み取ったバージョンを固定します |
webhook_id | いいえ | このランのイベントを1つの登録済みエンドポイントに送信します — 参照 Webhooks |
各入力の送信方法
受け入れます | 送信 | で allow_multiple |
|---|---|---|
値 | 文字列、数値、または真偽値そのもの | それらの配列 |
URL | 文字列としての公開HTTPSリンク1つ | リンクの配列 |
オプション | 1つ options[].id、指定どおりに | 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"
}
}| レスポンスフィールド | 意味 |
|---|---|
id | ランID。ポーリングし、あなた自身の記録と照合して保持してください |
status | キュー済み 受理時 |
chat_id | ランが実行されるStudioセッション。開いてランを監視するか、質問に答えてください |
取り込まれた | 取得したファイルごとに1件、送信順に並びます。意図したものを送信できたか確認するのに便利です |
poll_after_seconds | 最初のポーリングまで待つ時間 |
expires_at | 未完了のランが放棄された場合は 期限切れ |
すべてのリンクは取得され、検証されます 前に 202 の前に。accepted で返ってきたランはファイルを受け取れているため、リンクが不正なら10分後の失敗ではなく即座に 400 になります。