创意工作流

创意工作流把一次创作任务表达为多步 DAG:每个 step 调用一个托管工具,dependsOn 表达依赖,服务端按依赖顺序执行并发布事件。与单次工具执行相比,工作流是持久资源:幂等创建、断线可恢复、事件可回放。

POSThttps://rcn.reelway.ai/v1/creative-agent/workflows鉴权:凭证

两段式创建 + 幂等;输入 ≤1 MiB;严格解码

GEThttps://rcn.reelway.ai/v1/creative-agent/workflows鉴权:凭证

分页 offset/limit;{workflows[], total}

GEThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}鉴权:凭证

单工作流(含 steps);不存在 404

GEThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/events?after=<seq>鉴权:凭证

事件列表,单次上限 500 条

SSEhttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/events/stream鉴权:凭证

SSE;Last-Event-ID 重放;终态后关流

POSThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/cancel鉴权:凭证

取消

POSThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/confirm-cost鉴权:凭证

费用确认(当前恒 409,1006)

POSThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/resume鉴权:凭证

恢复(当前恒 409,无挂起态)

POSThttps://rcn.reelway.ai/v1/creative-agent/workflows/{id}/reseed鉴权:凭证

按 step 覆写种子,产生一次新 run

预览执行器 M1 为占位:契约稳定,内容质量随真实引擎接入提升

创建与消费

POST body 为 DAG 定义 {steps: [{id, tool, input, dependsOn?}]};Idempotency-Key 作用域 workflow.create,同键异体 422(1012);未知字段 400(1010)。
事件形状 {seq, name, payload, createdAt};after 分页;SSE 断线用 Last-Event-ID 重放。
终态后产物经 GET /v1/image|media/downloadUrl 签发(48 小时)。

curl --fail-with-body https://rcn.reelway.ai/v1/creative-agent/workflows \
  -H "api-key: $REELWAY_API_KEY" \
  -H "Idempotency-Key: wf-20261102-001" \
  -d '{"steps":[{"id":"shot","tool":"generate_video","input":{"model":"minimax-h3-fl2va-fp8_t2v_turbo","prompt":"雨后屋顶上的橘猫"}}]}'

DAG 校验

HTTP	错误码	场景
422	`1007`	DAG 存在环,或依赖指向更晚的 step
422	`1008`	`dependsOn` 引用不存在的 step id
422	`1001`	step 引用了未实现的工具

状态生命周期

created → running → completed | failed | cancelled;cancel 对已终态工作流返回 409(1006)。reseed 以 {seed_overrides: {stepId: seed}} 产生一次新 run(响应 201),原 run 保持不变。完整端点行为见快速开始的错误码表。

#创意工作流

#创建与消费

#DAG 校验

#状态生命周期

创意工作流

创建与消费

DAG 校验

状态生命周期