|
--- |
|
title: Q |
|
emoji: 🏢 |
|
colorFrom: indigo |
|
colorTo: purple |
|
sdk: docker |
|
pinned: false |
|
license: mit |
|
app_port: 8000 |
|
--- |
|
|
|
# 通义千问 API 代理服务器 |
|
|
|
这是一个基于 FastAPI 实现的通义千问 API 代理服务器，用于转发和处理与通义千问 API 的通信。 |
|
|
|
## 主要功能 |
|
|
|
- 模型列表获取 API |
|
- 聊天完成 API |
|
- 支持流式响应 |
|
- 内置模型列表缓存机制 |
|
- 自动重试机制 |
|
|
|
## 环境要求 |
|
|
|
- Python 3.7+ |
|
- FastAPI 0.104.1+ |
|
- Uvicorn 0.24.0+ |
|
- HTTPX 0.25.1+ |
|
|
|
## 安装步骤 |
|
|
|
1. 克隆项目到本地 |
|
|
|
2. 安装依赖： |
|
```bash |
|
pip install -r requirements.txt |
|
``` |
|
|
|
3. 使用 Docker（可选）： |
|
```bash |
|
docker build -t qwen-api-proxy . |
|
docker run -p 8000:8000 qwen-api-proxy |
|
``` |
|
|
|
## 运行服务 |
|
|
|
```bash |
|
python qwen.py |
|
``` |
|
或使用 uvicorn： |
|
```bash |
|
uvicorn qwen:app --host 0.0.0.0 --port 8000 |
|
``` |
|
|
|
服务将在 http://localhost:8000 上运行。 |
|
|
|
## API 接口说明 |
|
|
|
### 1. 获取模型列表 |
|
|
|
``` |
|
GET /api/models |
|
Header: Authorization: Bearer <your-token> |
|
``` |
|
|
|
返回可用的模型列表，结果会被缓存1小时。 |
|
|
|
### 2. 聊天完成 |
|
|
|
``` |
|
POST /api/chat/completions |
|
Header: Authorization: Bearer <your-token> |
|
|
|
{ |
|
"model": "string", |
|
"messages": [ |
|
{ |
|
"role": "user", |
|
"content": "string" |
|
} |
|
], |
|
"stream": boolean, |
|
"max_tokens": number (可选) |
|
} |
|
``` |
|
|
|
支持流式和非流式响应，可以通过 stream 参数控制。 |
|
|
|
## 错误处理 |
|
|
|
- 服务内置了自动重试机制，最多重试3次 |
|
- 500错误或HTML响应会触发重试 |
|
- 401错误表示未授权，需要检查token |
|
- 400错误表示请求参数有误 |
|
|
|
## 获取 API Key |
|
|
|
1. 访问 https://chat.qwenlm.ai/ 并登录 |
|
2. 打开浏览器开发者工具（通常按 F12） |
|
3. 切换到"应用程序"选项卡 |
|
4. 在左侧菜单中选择"Cookies" -> "https://chat.qwenlm.ai" |
|
5. 找到名称为"token"的cookie |
|
6. 复制其值，这就是你的API Key |
|
|
