# AI 风格管理 API 文档

本文档描述了 AI 风格管理相关的接口规范。

## 1. 全局响应结构

所有接口的返回值均由 `GlobalResponseWrapper` 统一包装，遵循以下 JSON 结构：

```json
{
  "code": 200,          // 状态码 (200: 成功, 其他: 失败)
  "message": "success", // 响应消息
  "success": true,      // 成功标识
  "data": { ... },      // 具体业务数据
  "timestamp": 1709628736123 // 响应时间戳
}
```

---

## 2. 新增风格

*   **URL**: `/v2/style/add`
*   **Method**: `POST`
*   **Content-Type**: `application/json`
*   **描述**: 新增 AI 风格。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `name` | string | 否 | 风格名字 |
| `describe` | string | 否 | 风格描述 |
| `author` | string | 否 | 作者 |
| `coverImg` | string | 否 | 风格封面，可以是一个视频封面 |
| `detailImg` | string | 否 | 详情图(逗号分割) |
| `originalStandardPlanPrice` | number | 否 | 标准定价(原价) |
| `originalStandardPlanPoints` | integer | 否 | 标准定价(原价)(积分) |
| `standardPlanPrice` | number | 否 | 标准定价 |
| `standardPlanPoints` | integer | 否 | 标准定价(积分) |
| `originalFastPlanPrice` | number | 否 | 快速套餐价格(原价) |
| `originalFastPlanPoints` | integer | 否 | 快速套餐价格(原价)(积分) |
| `fastPlanPrice` | number | 否 | 快速套餐价格 |
| `fastPlanPoints` | integer | 否 | 快速套餐价格(积分) |
| `sort` | integer | 否 | 排序 |
| `tagId` | string | 否 | 风格的tag（限免、上新、等） |
| `use` | integer | 否 | 风格的使用量 |
| `minPic` | integer | 否 | 风格所需最低图片数量 |
| `maxPic` | integer | 否 | 风格所需最高图片数量 |
| `fastPic` | integer | 否 | 快速套餐生成图片数量 |
| `standardPic` | integer | 否 | 标准套餐生成图片数量 |
| `templateZip` | string | 否 | 模版zip文件 |
| `showType` | integer | 否 | 展示类型 0:默认 |
| `textTitleBelowSampleImg` | string | 否 | 样图下面区域文本标题 |
| `textContentBelowSampleImg` | string | 否 | 样图下面区域文本内容 |
| `sampleImg` | string | 否 | 样图 |
| `detailImgMask` | string | 否 | 详情图蒙版 |
| `cardCoverImg` | string | 否 | 卡片模块下封面图 |
| `platform` | string | 否 | 平台(iOS,安卓等) |
| `minVersionNum` | string | 否 | 最小版本号 |
| `maxVersionNum` | string | 否 | 最大版本号 |
| `sampleImgTitle` | string | 否 | 样图标题 |
| `sampleImgDesc` | string | 否 | 样图描述 |
| `stylemode` | integer | 否 | stylemode |
| `inneed` | integer | 否 | inneed |
| `badge` | string | 否 | 角标 |
| `color` | string | 否 | 角标颜色值 |
| `lang` | string | 否 | 语言包 |
| `apiType` | integer | 否 | ai平台(默认2) |
| `aiContent` | string | 否 | api调用默认参数 |
| `aiType` | string | 否 | 滤镜能力 |
| `requirements` | string | 否 | requirements |
| `styleType` | integer | 否 | 模版类型,0:可试用，1:vip |
| `previewImg` | string | 否 | 视频封面预览图 |

### 响应参数

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `data` | boolean | 是否成功 |

---

## 3. 删除风格

*   **URL**: `/v2/style/delete/{id}`
*   **Method**: `DELETE`
*   **描述**: 根据 ID 删除风格。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `id` | integer | 是 | 风格ID |

### 响应参数

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `data` | boolean | 是否成功 |

---

## 4. 修改风格

*   **URL**: `/v2/style/update`
*   **Method**: `PUT`
*   **Content-Type**: `application/json`
*   **描述**: 修改风格信息。

### 请求参数

与新增风格参数一致，需包含 `id` 字段。

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `id` | integer | 是 | 风格ID |
| ... | ... | ... | 其他需修改的字段 |

### 响应参数

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `data` | boolean | 是否成功 |

---

## 5. 获取单个风格

*   **URL**: `/v2/style/get/{id}`
*   **Method**: `GET`
*   **描述**: 根据 ID 获取风格详情。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `id` | integer | 是 | 风格ID |

### 响应参数 (`data` 字段)

返回 `TAiStyle` 对象，字段详情见新增接口参数说明。

---

## 6. 分页查询风格

*   **URL**: `/v2/style/page`
*   **Method**: `GET`
*   **描述**: 分页查询风格，支持风格名称模糊查询。

### 请求参数

| 字段名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| `pageNum` | integer | 是 | 页码 (默认 1) |
| `pageSize` | integer | 是 | 每页数量 (默认 10) |
| `name` | string | 否 | 风格名称 (模糊查询) |
| `id` | integer | 否 | 风格ID (精确查询) |

### 响应参数 (`data` 字段)

| 字段名 | 类型 | 说明 |
| :--- | :--- | :--- |
| `records` | array | 风格列表 |
| `total` | integer | 总记录数 |
| `size` | integer | 每页数量 |
| `current` | integer | 当前页码 |
| `pages` | integer | 总页数 |