diff --git a/docs_v1.0/M4_workspace/2026-05-14_trace_mode_api_update.md b/docs_v1.0/M4_workspace/2026-05-14_trace_mode_api_update.md
new file mode 100644
index 0000000..ddd90cf
--- /dev/null
+++ b/docs_v1.0/M4_workspace/2026-05-14_trace_mode_api_update.md
@@ -0,0 +1,27 @@
+# trace video normal/debug mode — API 更新交付
+
+**Date**: 2026-05-14
+**From**: M5
+**To**: M4
+
+---
+
+## 變更
+
+trace video API 新增 `mode` 參數：
+
+| Mode | 說明 | Overlay | 速度 |
+|:----:|------|:-------:|:----:|
+| `debug` (預設) | bbox + trace_id + Frame + Cut + Identity + UUID | ✅ | 需 re-encode |
+| `normal` | 原始片段，無任何 overlay | ❌ | `-c copy` (即時) |
+
+## 文件
+
+`API_V1.0.0/TRACE/TRACE_API_REFERENCE_V1.0.0.md` §3 已更新。
+
+## Commits
+
+| Commit | 內容 |
+|--------|------|
+| `995d925` | docs: trace video normal/debug mode |
+| `8f877b4` | feat: trace video normal/debug mode |