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

提交工作流运行

提交一次工作流运行任务。系统会先按工作流报价进行预扣费,任务完成后按实际消耗结算,多退少补以实际账单为准。
idempotency_key 必填。同一用户、相同工作流、相同幂等键的重复请求会返回同一笔运行记录,避免网络重试造成重复提交。
图片、视频、音频等普通媒体字段直接传资源字符串:公网 URL、data:image/<format>;base64,<data>asset://asset_xxx。需要声明素材角色或在提示词中引用素材时,使用 { "uri": "...", "role": "reference_image", "label": "人物A" }。本地文件建议先调用 上传工作流资源,再把返回的 asset_uri 字段值放入 inputs

请求参数

workflow_id
string
required
工作流 ID
revision_id
string
工作流版本 ID。建议使用详情接口返回的 revision_id,不传时使用当前已发布版本
inputs
object
工作流输入参数。key 来自详情接口的 editable_parameter_manifest
inputs.contains_real_person_material
boolean
历史 Seedance 视频工作流兼容参数。新接入外部视频模型时,建议使用 外部模型任务接口
idempotency_key
string
required
幂等键,由调用方生成。建议使用业务订单号、请求流水号或 UUID
accept_external_cost_risk
boolean
是否确认接受第三方模型费用风险。工作流可能产生外部模型费用时应传 true

响应参数

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

错误响应

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

代码示例

提示词引用素材

历史 Seedance 工作流或外部视频模型工作流支持在 inputs 的资源对象中传 label,并在 inputs.prompt 中使用 @label 指向该素材。
说明:
  • label 建议直接写显示名,例如 阿九,不需要带 @
  • prompt 中写 @阿九,也兼容 {{阿九}}{{ 阿九 }}
  • 同一个请求里 label 不能重复
  • 服务端会把自定义标签绑定到当前请求中的资源顺序,例如图片会映射为上游需要的 @图1@图2

响应示例

错误示例