Evose

API · Workflow

触发 · 查询执行 · 取消

Workflow API

触发 Workflow 与查询执行。

列出 Workflow

GET /v1/workflows?workspace_id=ws-001

触发执行(同步)

POST /v1/workflows/{id}/runs
{
  "inputs": {
    "topic": "RAG 在企业落地的常见误区",
    "tone": "深度技术",
    "length": 1500
  },
  "user_id": "u-001"
}

响应:

{
  "request_id": "req-xxx",
  "run_id": "run-abc",
  "workflow_id": "wf-001",
  "status": "completed",
  "duration_ms": 3200,
  "outputs": {
    "article": "..."
  },
  "usage": { "tokens_in": 1020, "tokens_out": 2080, "credits": 0.052 }
}

长 Workflow 用异步

如果 Workflow 通常运行 > 30s,改用异步触发 + Webhook 通知。

触发执行(异步)

POST /v1/workflows/{id}/runs?async=true

立即返回:

{
  "run_id": "run-abc",
  "status": "running"
}

后续通过 Webhook 接收完成通知或轮询:

GET /v1/runs/{run_id}

列出执行

GET /v1/workflows/{id}/runs?status=failed&limit=20

取消执行

POST /v1/runs/{run_id}/cancel

running 状态的可取消。

流式执行进度

POST /v1/workflows/{id}/runs
Accept: text/event-stream

事件:

event: node_start
data: {"node": "生成大纲", "started_at": "..."}

event: node_end
data: {"node": "生成大纲", "duration_ms": 1400, "output": {...}}

event: usage
data: {...}

event: done
data: {"status": "completed", "outputs": {...}}

接下来

页面导航