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

# 回放记录

回放记录(replay records)把一次可复现的生成上下文(提示词、参数、种子、中间产物引用)以**结构化记录**归档在账户命名空间下,供后续检索与复现。


POSThttps://rcn.reelway.ai/v1/replay/records鉴权:凭证

写入记录;返回 runId 与时间戳



GEThttps://rcn.reelway.ai/v1/replay/records?limit=<n>鉴权:凭证

分页列出;limit>100 归一 20



GEThttps://rcn.reelway.ai/v1/replay/records/{id}鉴权:凭证

单条;不存在 404


## 写入

```bash
curl --fail-with-body https://rcn.reelway.ai/v1/replay/records \
  -H "api-key: $REELWAY_API_KEY" \
  -d '{
    "schemaVersion": 1,
    "record": { "prompt": "…", "seed": 20251102, "modelId": "z_image_turbo_bf16" }
  }'
```

- `record` 内容由调用方定义(`schemaVersion` 标注结构),平台不解释其语义。
- 响应含 `runId`、`schemaVersion`、`redacted` 与时间戳。
- 平台侧脱敏钩子待接入(当前 `redacted: false`);**敏感信息请先自行脱敏再写入**。

## 检索

列表按写入顺序倒序返回,`limit` 归一上限 20。需要按业务键检索时,请在 `record` 内自建索引字段并在客户端过滤。

## 另见

- [创意工作流](https://docs.reelway.ai/api-reference/workflows.md) —— 执行面;回放记录承担「可复现上下文」的归档面
- [工作流模板](https://docs.reelway.ai/api-reference/templates.md) —— 模板持久化的替代方案