# Sub2API 模块分析报告：Sora与媒体服务模块

## 1. 模块概述

### 1.1 模块定位
Sora与媒体服务模块是Sub2API的视频生成和媒体管理核心，负责接入OpenAI Sora视频生成服务，提供视频生成、媒体存储、播放等功能。

### 1.2 核心职责
- **Sora视频生成**：调用Sora API生成视频
- **媒体存储**：管理生成的视频文件
- **播放服务**：提供视频播放和下载

## 2. 代码结构分析

### 2.1 核心文件

| 文件路径 | 职责 |
|---------|------|
| `handler/sora_gateway_handler.go` | Sora网关处理 |
| `handler/sora_client_handler.go` | Sora客户端API |
| `service/sora_gateway_service.go` | Sora网关服务 |
| `service/sora_media_storage.go` | 媒体存储服务 |
| `service/sora_s3_storage.go` | S3存储服务 |

## 3. 功能详细分析

### 3.1 视频生成流程

```go
// service/sora_gateway_service.go - GenerateVideo
func (s *SoraGatewayService) GenerateVideo(ctx context.Context, req *SoraRequest) (*SoraResponse, error) {
    // 1. 验证请求
    if err := s.validateRequest(req); err != nil {
        return nil, err
    }
    
    // 2. 获取Sora账号
    account := s.selectAccount(req.GroupID)
    if account == nil {
        return nil, ErrNoAccountAvailable
    }
    
    // 3. 调用Sora API
    response, err := s.callSoraAPI(ctx, account, req)
    if err != nil {
        return nil, err
    }
    
    // 4. 返回结果
    return &SoraResponse{
        VideoID:    response.VideoID,
        Status:     response.Status,
        DownloadURL: s.getDownloadURL(response.VideoID),
    }, nil
}
```

### 3.2 媒体存储

```go
// service/sora_media_storage.go
type MediaStorage interface {
    Upload(ctx context.Context, key string, data []byte, contentType string) error
    Download(ctx context.Context, key string) ([]byte, error)
    GetURL(ctx context.Context, key string, expiry time.Duration) (string, error)
    Delete(ctx context.Context, key string) error
}

// 支持：本地存储、S3兼容存储
```

## 4. 总结

Sora模块特点：

- **视频生成**：支持Sora API调用
- **多种存储**：支持本地和S3存储
- **URL签名**：支持带签名的播放URL

---
*文档版本：1.0*
*分析基于：Sub2API v0.1.104*