# 06_API接口设计文档

## 1. 通用返回格式

```json
{
  "code": 0,
  "message": "success",
  "data": {},
  "request_id": "req_xxx"
}
```

---

## 2. 认证接口

```text
POST /api/auth/register
POST /api/auth/login
POST /api/auth/logout
GET  /api/auth/profile
```

---

## 3. 项目接口

```text
POST /api/projects
GET  /api/projects
GET  /api/projects/:id
PATCH /api/projects/:id
POST /api/projects/:id/cancel
DELETE /api/projects/:id
```

创建项目：

```json
{
  "title": "重生归来，我不再爱你",
  "input_mode": "ai_original",
  "genre": "urban_rebirth",
  "style_code": "korean_comic",
  "output_type": "short_video",
  "target_episode_count": 3,
  "episode_duration": 60
}
```

---

## 4. AI 原创小说接口

```text
POST /api/projects/:id/original/idea
POST /api/projects/:id/original/outline
POST /api/projects/:id/original/chapters
POST /api/projects/:id/original/self-check
GET  /api/projects/:id/original/result
```

---

## 5. 上传小说接口

```text
POST /api/projects/:id/novel/upload
POST /api/projects/:id/novel/paste
POST /api/projects/:id/novel/parse
GET  /api/projects/:id/novel/parse-result
PATCH /api/novel-chapters/:chapterId
```

---

## 6. 版权确认接口

```text
POST /api/projects/:id/copyright/confirm
GET  /api/projects/:id/copyright
```

请求：

```json
{
  "authorization_type": "author_self",
  "statement_text": "我确认拥有该小说的合法改编权。"
}
```

---

## 7. 故事圣经接口

```text
POST /api/projects/:id/story-bible/generate
GET  /api/projects/:id/story-bible
PATCH /api/projects/:id/story-bible
POST /api/projects/:id/story-bible/confirm
```

---

## 8. 角色接口

```text
POST /api/projects/:id/characters/extract
GET  /api/projects/:id/characters
POST /api/projects/:id/characters
PATCH /api/characters/:characterId
DELETE /api/characters/:characterId
POST /api/characters/:characterId/generate-images
POST /api/characters/:characterId/set-anchor
GET  /api/characters/:characterId/memories
```

---

## 9. 分集接口

```text
POST /api/projects/:id/episodes/generate-plan
GET  /api/projects/:id/episodes
PATCH /api/episodes/:episodeId
POST /api/projects/:id/episodes/confirm
```

---

## 10. 脚本接口

```text
POST /api/episodes/:episodeId/script/generate
GET  /api/episodes/:episodeId/script
PATCH /api/episodes/:episodeId/script
POST /api/episodes/:episodeId/script/confirm
```

---

## 11. 分镜接口

```text
POST /api/episodes/:episodeId/storyboard/generate
GET  /api/episodes/:episodeId/storyboard
PATCH /api/storyboard-shots/:shotId
DELETE /api/storyboard-shots/:shotId
POST /api/episodes/:episodeId/storyboard/confirm
POST /api/storyboard-shots/:shotId/regenerate-prompt
```

---

## 12. 长篇记忆接口

```text
GET  /api/projects/:id/plot-memories
POST /api/projects/:id/plot-memories/generate
GET  /api/projects/:id/plot-threads
POST /api/projects/:id/plot-threads
PATCH /api/plot-threads/:threadId
POST /api/episodes/:episodeId/continuity-check
```

---

## 13. 生成接口

```text
POST /api/episodes/:episodeId/preview/generate
POST /api/episodes/:episodeId/final/generate-images
POST /api/episodes/:episodeId/audio/generate
POST /api/episodes/:episodeId/subtitle/generate
POST /api/episodes/:episodeId/video/render
GET  /api/projects/:id/progress
GET  /api/episodes/:episodeId/assets
```

---

## 14. 修改申请接口

```text
POST /api/projects/:id/revisions
GET  /api/projects/:id/revisions
```

---

## 15. 后台接口

```text
GET  /api/admin/projects
GET  /api/admin/projects/:id
POST /api/admin/tasks/:id/retry
POST /api/admin/tasks/:id/cancel
POST /api/admin/tasks/:id/manual-required
GET  /api/admin/tasks
GET  /api/admin/provider-logs
GET  /api/admin/costs
POST /api/admin/projects/:id/manual-review
```

---

## 16. 案例和数据接口

```text
GET  /api/cases
GET  /api/cases/:id
POST /api/admin/cases
PATCH /api/admin/cases/:id
POST /api/projects/:id/analytics/import
GET  /api/projects/:id/analytics
```