# vl_model_chat

**Repository Path**: thunderlz/vl_model_chat

## Basic Information

- **Project Name**: vl_model_chat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-17
- **Last Updated**: 2025-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视觉模型访问 - FastAPI网页界面

这是一个基于FastAPI的网页界面，用于访问运行在localhost:8011的视觉模型API。

## 功能特性

- 🖼️ 支持两种图像输入方式：
  - 上传本地图像文件
  - 输入图像URL（支持HTTP/HTTPS或file://协议）
- 📝 可自定义提示文本
- 🎨 现代化的响应式网页界面
- ⚡ 实时API状态检查
- 📋 一键复制结果文本
- 🚀 拖放文件上传支持

## 系统要求

- Python 3.13+
- Conda（用于环境管理）
- 运行在localhost:8011的视觉模型API

## 安装和运行

### 1. 创建Conda环境
```bash
conda create -n fastapi-env python=3.13
conda activate fastapi-env
```

### 2. 安装依赖
```bash
pip install -r requirements.txt
```

### 3. 启动FastAPI服务器
```bash
uvicorn main:app --host 0.0.0.0 --port 8000 --reload
```

### 4. 访问网页界面
打开浏览器访问：http://localhost:8000

## 项目结构

```
视觉模型访问/
├── main.py              # FastAPI主应用
├── requirements.txt     # Python依赖
├── README.md           # 项目说明
├── templates/
│   └── index.html      # 网页界面模板
└── static/
    ├── css/
    │   └── style.css   # 样式文件
    └── js/
        └── script.js   # 客户端JavaScript
```

## API端点

- `GET /` - 主页面
- `POST /describe` - 处理图像描述请求
- `GET /health` - 健康检查端点

## 配置

在`main.py`中可以修改以下配置：
- `VISION_API_URL`: 视觉模型API地址（默认：http://localhost:8011/chat/completions）
- `DEFAULT_MODEL`: 默认模型路径

## 使用示例

### 通过网页界面
1. 访问 http://localhost:8000
2. 选择图像输入方式（上传文件或输入URL）
3. 输入提示文本（可选）
4. 点击"生成描述"按钮
5. 查看结果

### 通过API调用
```bash
# 使用图像URL
curl -X POST "http://localhost:8000/describe" \
  -F "prompt=请详细描述这张图片。" \
  -F "image_url=file:///path/to/image.jpg"

# 上传图像文件
curl -X POST "http://localhost:8000/describe" \
  -F "prompt=请描述这张图片。" \
  -F "image_file=@/path/to/image.jpg"
```

## 故障排除

### 视觉模型API不可达
1. 确保视觉模型服务正在运行在localhost:8011
2. 检查防火墙设置
3. 验证API端点是否正确

### 文件上传失败
1. 检查文件大小（限制为10MB）
2. 确保文件格式为常见图像格式（JPEG、PNG等）
3. 检查文件权限

### 请求超时
1. 图像处理可能需要较长时间，请耐心等待
2. 可以尝试减小图像尺寸
3. 检查服务器资源使用情况

## 许可证

本项目仅供学习和研究使用。