> 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.

# 创意智能体工作流

工作流面向**多步媒体生产**:生成→编辑→合成的多步链条、需要断线恢复与对账的长任务。单次对话用 runs,单步工具用 tools/execute;链条用 workflow。

## 何时用

- 一条生成链(提示词扩写 → 生成视频 → 提取参数)需要按依赖顺序执行;
- 任务价值高,进程重启不能丢:幂等创建 + 事件回放;
- 需要换种子重播同结构任务:`reseed`。

## 创建

```bash
curl --fail-with-body https://rcn.reelway.ai/v1/creative-agent/workflows \
  -H "api-key: $REELWAY_API_KEY" -H "Idempotency-Key: wf-<uuid>" \
  -d '{"steps":[{"id":"shot","tool":"generate_video","input":{"model":"minimax-h3-fl2va-fp8_t2v_turbo","prompt":"…"}}]}'
```

请求体 ≤ 1 MiB、严格解码(`1010`);DAG 环 `1007`、`dependsOn` 缺失 `1008`。响应 `201` 工作流形状。端点族细节见 [API 参考 → 创意工作流](https://docs.reelway.ai/api-reference/workflows.md)。

## 消费事件

SSE(`…/events/stream`,`Last-Event-ID` 重放)或 `after` 分页轮询;事件形状 `{seq, name, payload, createdAt}`;终态后关流。产物经 `downloadUrl` 签发(48 小时)。

## 重播(reseed)

`POST …/{id}/reseed` body `{seed_overrides: {stepId: seed}}` 产生一次**新 run**(201),原 run 保留;适合同一结构批量探索种子。

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