> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 创意工作流

创意工作流把一次创作任务表达为**多步 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 小时)。

```bash
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 保持不变。完整端点行为见[快速开始](https://docs.reelway.ai/api-reference/getting-started.md)的错误码表。