部署环境
执行工作流
适用于:Workflow。
运行已部署的 Workflow 版本,支持阻塞和流式两种模式。
对应的标准 API 接口:执行工作流。差异:
- 忽略
workflow_id和请求体中的未知字段。 - 接受
trace_id和trace_session_id。 - 请求体上限为 8 MiB。
- 流中不包含 TTS、人工介入、Agent 日志和检索来源事件。运行进入人工介入步骤时会失败。
- 错误码不同。
POST
授权
每个请求都通过 API 密钥认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API 密钥,知识库接口使用知识库 API 密钥(快速开始)。
API 密钥应保存在服务端,切勿嵌入客户端代码。缺失或无效的密钥会返回 HTTP 401(unauthorized)。
查询参数
请求体
application/json
响应
内容类型和结构取决于请求中的 response_mode 参数。
- 如果
response_mode为blocking,返回application/json和WorkflowBlockingResponse对象。 - 如果
response_mode为streaming,返回text/event-stream和ChunkWorkflowEvent对象流。
本次运行的任务 ID。使用阻塞式返回时,任务 ID 只出现在最终响应体中,因此 停止工作流任务 实际只在流式返回时可用。