# API接口

**Repository Path**: bozoyan/api

## Basic Information

- **Project Name**: API接口
- **Description**: 一些测试用的 API。不保证数据安全。。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-06
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# API接口

## 项目概述

这是一个 PHP 与 Python 混合开发的 API 接口项目，主要用于 AI 相关的图像处理、文本生成和多组织管理系统。项目包含 Web 界面和 API 接口，支持多个组织的权限管理和会话控制。一些测试用的 API。不保证数据安全。。

## 核心架构

### PHP 部分
- **入口文件**: `index.php` - 登录认证和用户管理
- **主界面**: `main.php` - 组织管理系统的主界面
- **API处理**: `process.php` - 处理各种 API 请求和调用

### Python 部分
- **Gradio界面**: `ai_comfly_chat.py` - 基于 Gradio 的 AI 聊天界面
- **BizyAIR模块**: `BizyAIR/API 接口/` - 图像处理 API 集合（单图修改、去水印、放大、多图融合等）
- **TTS功能**: `Qwen-TTS.py` - 文本转语音功能
- **NAFNet**: `run_NAFNet.py` - 图像修复处理

### 目录结构
```
├── index.php          # 登录入口
├── main.php           # 主管理界面
├── process.php        # API 处理中心
├── BizyAIR/           # 图像处理模块
│   ├── index.php      # BizyAIR Web界面
│   └── API 接口/      # Python API 脚本
├── 开发说明/          # 开发文档
└── ph-output/         # PHP 输出目录
```

## 常用开发命令

### PHP 环境启动
```bash
# 启动 PHP 内置服务器（用于开发测试）
php -S localhost:8000

# 访问登录页面
http://localhost:8000/index.php?login=bozo
```

### Python 环境配置
```bash
# 安装依赖
pip install -r requirements.txt

# 启动 Gradio 界面
python ai_comfly_chat.py

# 运行 TTS 功能
python Qwen-TTS.py

# 启动图像修复
python run_NAFNet.py
```

### Gradio 启动方式
```python
# 网页自动弹出
.launch(inbrowser=True)

# 指定端口启动
.launch(server_port=8002, server_name="0.0.0.0")
```

## 权限和安全系统

### Cookie 管理
- 用户登录后设置多个 Cookie： `OR_KEY`, `ZP_KEY`, `BIZY_KEY`
- Cookie 有效期为 30 天
- 通过 `cookie.php` 统一管理权限验证

## API 接口规范

### BizyAIR 图像处理 API
- **端点**: `https://api.bizyair.cn/w/v1/webapp/task/openapi/create`
- **认证**: Bearer Token
- **支持功能**:
  - 单图修改、去水印、放大、重绘
  - 双图、三图、四图、五图融合
- **数据格式**:
  - 图片支持 URL 和 base64 编码
  - 返回任务 ID 和处理后的图片 URL

### 内置 API 处理
- `process.php` 处理内部 API 请求
- 支持文件夹创建、自定义提示词、标签类型选择
- 自动从 Cookie 和环境变量获取 API 密钥

## 开发注意事项

1. **多组织支持**: 代码设计需要考虑多组织隔离，每个组织有独立的配置和 API 密钥
2. **权限验证**: 所有敏感操作都需要通过 `cookie.php` 进行权限验证
3. **文件路径**: 使用 `__DIR__` 和 `dirname(__DIR__)` 获取正确的文件路径
4. **错误处理**: API 调用需要完善的错误处理和日志记录
5. **文件管理**: 临时文件和输出文件需要按日期和任务 ID 分类存储

## 环境变量

- `DASHSCOPE_API_KEY`: 阿里云 TTS API 密钥
- `MODELSCOPE_API_KEY`: ModelScope API 密钥
- `OSS_ENDPOINT`, `OSS_REGION`, `OSS_BUCKET_NAME`: 阿里云 OSS 配置
- `BIZYAIR_API_KEY`: BizyAIR 图像处理 API 密钥

## 文件命名规范

- PHP 文件使用小写字母和下划线
- Python 文件使用小写字母和下划线
- 配置文件使用 `.env` 后缀
- 临时文件按日期格式 `Ymd_His` 命名