转写接口

转写记录相关的 API 接口。

提交转写记录

保存一条转写记录。

请求

POST /api/transcriptions
Authorization: Bearer <token>
Content-Type: application/json

请求体

{
  "recordTitle": "会议记录 2026-01-29",
  "text": "这是转写的完整文本内容...",
  "language": "zh-CN",
  "durationSeconds": 300
}

请求字段

字段	类型	必填	说明
recordTitle	string	否	记录标题
text	string	否	转写文本
language	string	否	语言代码
durationSeconds	number	否	音频时长 (秒)

响应

成功 (200):

{
  "transcriptionRecordId": 999,
  "userId": 123,
  "recordTitle": "会议记录 2026-01-29",
  "text": "这是转写的完整文本内容...",
  "textLength": 2543,
  "language": "zh-CN",
  "durationSeconds": 300,
  "createdAt": "2026-01-29T10:30:00Z",
  "updatedAt": null
}

---

获取转写列表

获取当前用户的转写记录列表。

请求

GET /api/transcriptions
Authorization: Bearer <token>

响应

成功 (200):

[
  {
    "transcriptionRecordId": 999,
    "userId": 123,
    "recordTitle": "会议记录 2026-01-29",
    "textLength": 2543,
    "language": "zh-CN",
    "durationSeconds": 300,
    "createdAt": "2026-01-29T10:30:00Z"
  }
]

---

获取使用量统计

获取当前用户的转写使用量。

请求

GET /api/transcriptions/usage
Authorization: Bearer <token>

响应

成功 (200):

{
  "userId": 123,
  "totalUsage": 36000,
  "dailyUsage": [
    {
      "date": "2026-01-29",
      "usage": 3600
    },
    {
      "date": "2026-01-28",
      "usage": 2400
    }
  ]
}

响应字段

字段	类型	说明
totalUsage	number	累计使用秒数
dailyUsage	array	每日使用统计
dailyUsage[].date	string	日期 (yyyy-MM-dd)
dailyUsage[].usage	number	当日使用秒数