中文 | English | Go | JavaScript | CF_worker
N-1 是一个基于 Flask 的 Web 应用程序，提供强大的 API 接口用于处理聊天完成请求。该项目支持多种组合模式，可以根据需求选择并行分析或直接处理模式。在并行模式下，系统能够同时查询多个大语言模型，并使用专门的摘要模型综合这些响应，提供全面而准确的答案。项目支持文本和视觉多模态处理，是 AI 开发者和研究人员的理想工具。
您可以使用以下 Demo API 地址进行测试:
https://n_1.leez.tech/v1/chat/completions
curl --location --request POST 'https://n_1.leez.tech/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ilovelinuxdo' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "这是什么图片？"},
{"type": "image_url", "image_url": {"url": "https://global.discourse-cdn.com/openai1/original/4X/f/9/5/f95edd5d0d8848f9322525341bbfc3bf01a48057.png"}}
]
}
],
"max_tokens": 300,
"model": "Qwen2.5-VL-72B",
"stream": false
}'curl --location --request POST 'https://n_1.leez.tech/v1/chat/completions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ilovelinuxdo' \
--header 'Accept: */*' \
--header 'Connection: keep-alive' \
--data-raw '{
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": "这是什么图片？"},
{"type": "image_url", "image_url": {"url": "https://global.discourse-cdn.com/openai1/original/4X/f/9/5/f95edd5d0d8848f9322525341bbfc3bf01a48057.png"}}
]
}
],
"max_tokens": 300,
"model": "N-1",
"stream": false
}'- 后端框架：Flask (Python)
- 并发处理：threading, queue
- 外部请求：requests
- 配置管理：YAML
- 流式输出：Server-Sent Events (SSE)
-
组合式配置
- 支持多种预设组合模式
- 每个组合可独立配置所有参数
- 灵活切换处理模式
-
多模型并行分析
- 同时调用多个语言模型
- 支持文本和视觉处理
- 专业的摘要模型整合结果
-
视觉处理能力
- 支持图片 URL 和 base64 格式
- 专门的视觉模型处理
- 可配置图片细节级别
-
系统功能
- 流式和非流式输出
- Bearer Token 认证
- 错误重试机制
- 超时控制
- 实时状态反馈
- 调试模式支持
- Python 3.7+
git clone https://github.com/leezhuuuuu/N-1.git
cd N-1pip install flask requests pyyaml编辑 config.yaml 文件，配置您的组合参数。示例配置如下：
# 全局默认配置
default_combination: "parallel" # 默认使用的组合名称
# 模型组合配置
combinations:
- name: "parallel" # 并行分析组合
api_bearer_token: YOUR_API_BEARER_TOKEN
stream_status_feedback: true
use_parallel_analysis: true
debug_mode: true
text_models:
- endpoint: https://api.example.com/v1/chat/completions
bearer_token: MODEL_BEARER_TOKEN
model_name: ExampleModel
temperature: 0.7
max_retries: 3
timeout: 150
# ... 其他配置python app.py服务将在 http://0.0.0.0:18888 上启动。
向 /v1/chat/completions 端点发送 POST 请求：
{
"model": "parallel", // 可选，不填则使用默认组合
"messages": [
{"role": "user", "content": "你的问题"}
],
"stream": true或false
}{
"model": "parallel",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "这张图片是什么？"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/image.jpg",
"detail": "auto"
}
}
]
}
],
"stream": true
}- 并行调用多个模型
- 综合分析结果
- 适合需要全面答案的场景
- 智能组合模式：
- 文本请求：使用高性能大语言模型（如 Qwen2.5-72B-Instruct）
- 视觉请求：自动切换到视觉模型（如 Qwen2-VL-7B-Instruct）
- 特点：
- 单一模型处理，响应速度快
- 智能识别请求类型
- 通过组合实现高性能多模态能力
- 使用场景：
- 日常对话和咨询
- 图片分析和理解
- 需要快速响应的业务场景
| 特性 | parallel 模式 | direct 模式 |
|---|---|---|
| 处理方式 | 多模型并行 | 单模型智能切换 |
| 响应速度 | 较慢 | 快速 |
| 答案质量 | 全面、多角度 | 精准、简洁 |
| 资源消耗 | 较高 | 低 |
| 适用场景 | 需要深度分析 | 日常对话和图片分析 |
{
"model": "direct",
"messages": [
{"role": "user", "content": "什么是量子计算？"}
],
"stream": true
}{
"model": "direct",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "这张图片里有什么？"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/image.jpg",
"detail": "auto"
}
}
]
}
],
"stream": true
}- 401 Unauthorized：无效的 Bearer Token
- 500 Internal Server Error：服务器内部错误
本项目基于 MIT 许可证。详见 LICENSE 文件。
欢迎贡献！请提交问题或拉取请求。
- leezhuuuuu
- Flask
- Requests
- PyYAML