Skip to main content
POST
提交工作流运行

提交工作流运行

提交一次工作流运行任务。系统会先按工作流报价进行预扣费,任务完成后按实际消耗结算,多退少补以实际账单为准。
idempotency_key 必填。同一用户、相同工作流、相同幂等键的重复请求会返回同一笔运行记录,避免网络重试造成重复提交。
调用本接口前,必须先查询 工作流详情,并根据返回的 editable_parameter_manifest 组装 inputs。参数名使用 manifest 条目的 name,参数值按 value_typeui_schema 填写。

请求参数

string
required
工作流 ID
string
工作流版本 ID。建议使用详情接口返回的 revision_id,不传时使用当前已发布版本
object
工作流输入参数。每个 key 必须来自详情接口 editable_parameter_manifest[].name;未声明的 key 会被拒绝。具体类型、下拉选项、必填规则和文件传法请参考 工作流详情中的参数填写规则
string
required
幂等键,由调用方生成。建议使用业务订单号、请求流水号或 UUID
boolean
是否确认接受第三方模型费用风险。工作流可能产生外部模型费用时应传 true

inputs 填写规则

  1. 调用工作流详情接口,读取 revision_ideditable_parameter_manifest
  2. 对每个 required=true 的条目,在 inputs 中使用条目的 name 作为 key
  3. string 传字符串,int/float 传 JSON 数字,bool 传 JSON 布尔值
  4. ui_schema.control="select" 时传 ui_schema.options[].value 中的一个,并保留该值原本的 JSON 类型
  5. 图片、视频、音频或文件参数需要传资源字符串;本地文件先调用 上传工作流资源,再传返回的 asset_uri
不要使用 display_namebindings[].field 作为 inputs 的 key,也不要额外传 manifest 中不存在的字段。数字参数当前没有统一的最大值、最小值或步长,详情接口中的完整规则见 editable_parameter_manifest 说明

响应参数

integer
响应码,0 表示成功
string
响应信息
object
运行提交结果

错误响应

当提交阶段调用执行引擎失败时,接口会返回一个简单原因和详细错误信息,便于定位输入参数、文件获取、实例调度或工作流执行器问题。
integer
0 表示失败
string
简单失败原因
object
执行引擎错误详情

代码示例

响应示例

错误示例