creative_studio/backend/README.md

Creative Studio Backend

基于 FastAPI 的 AI 剧集创作平台后端服务。

快速开始

详细的快速启动指南请参考项目根目录的 README.md。

安装依赖

pip install -r requirements.txt

配置环境变量

cp .env.example .env
# 编辑 .env 文件，填入 ZAI_API_KEY

启动服务

uvicorn app.main:app --reload

访问 API 文档

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

技术栈

• Python 3.11+
• FastAPI
• MongoDB
• Redis
• zai-sdk (智谱 AI SDK)

主要功能

• Skill 管理系统
• 项目管理
• 记忆系统
• 审核系统
• Agent 执行引擎

开发指南

完整的开发指南请参考 DEVELOPMENT_GUIDE.md。

项目结构

backend/
├── app/
│   ├── main.py                   # 应用入口
│   ├── config.py                 # 配置管理
│   ├── api/v1/                   # API 路由
│   ├── core/                     # 核心业务逻辑
│   │   ├── llm/                  # GLM 客户端
│   │   ├── skills/               # Skill 管理器
│   │   ├── agents/               # Agent 执行引擎
│   │   ├── memory/               # 记忆系统
│   │   └── review/               # 审核系统
│   ├── models/                   # 数据模型
│   └── utils/                    # 工具函数
│
├── skills_storage/               # Skill 文件存储
│   ├── builtin_skills/          # 内置 Skills
│   └── user_skills/             # 用户 Skills
│
└── requirements.txt

API 端点

详细的 API 文档请参考 docs/API.md。

Skill 管理

端点	方法	描述
/api/v1/skills	GET	列出所有 Skills
/api/v1/skills/{id}	GET	获取 Skill 详情
/api/v1/skills	POST	创建新 Skill
/api/v1/skills/{id}/test	POST	测试 Skill
/api/v1/skills/{id}	PUT	更新 Skill
/api/v1/skills/{id}	DELETE	删除 Skill

项目管理

端点	方法	描述
/api/v1/projects	GET	列出项目
/api/v1/projects	POST	创建项目
/api/v1/projects/{id}	GET	获取项目详情
/api/v1/projects/{id}/execute	POST	执行剧集创作

常见问题

如何获取智谱 AI API Key？

访问 智谱AI开放平台 创建 API Key。

支持哪些模型？

• glm-4-flash - 快速响应模型（推荐）
• glm-4-plus - 高质量模型
• glm-4-0520 - 稳定版本

许可证

MIT License