tianping / README.md
maltose1's picture
Upload 9 files
d498971 verified
---
title: Tenbin OpenAI API Adapter
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false
---
# Tenbin OpenAI API 适配器
本项目将 [Tenbin.ai](https://tenbin.ai/) (Oshiete AI) 的服务接口转换为与 OpenAI API 完全兼容的格式。
它通过一个 Docker 容器,同时运行 FastAPI 核心服务和一个 [Turnstile-Solver](https://github.com/Theyka/Turnstile-Solver) 实例,实现了对 Tenbin 账户池的管理、请求转换、流式响应和人机验证的全自动处理。
## 🚀 如何使用此 Space
部署成功后,您可以像使用官方 OpenAI API 一样,在任何支持的客户端中使用此服务。
- **API Base URL**: `https://<your-space-name>.hf.space/v1`
- **API Key**: 您在 `Secrets` 中配置的任何一个 API 密钥。
- **模型**: 请参考 `models.json` 文件中的可用模型列表。
### cURL 示例
```bash
curl "https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "claude-3.7-sonnet",
"messages": [
{
"role": "user",
"content": "你好,请介绍一下你自己"
}
],
"stream": false
}'
```
> **注意**: 请将 `YOUR_USERNAME`, `YOUR_SPACE_NAME` 和 `YOUR_API_KEY` 替换为您自己的信息。
## ⚙️ 如何配置 (Secrets)
为了安全,所有敏感信息都应该通过 Hugging Face 的 **Secrets** 来配置。请在你的 Space 的 **Settings -> Secrets** 页面添加以下内容:
1. **`SESSION_IDS`** (必需)
- **说明**: 你的 Tenbin/Oshiete AI 账户的 `session_id` 列表。
- **格式**: 使用逗号分隔。
- **示例**: `id_abc123,id_def456,id_ghi789`
2. **`API_KEYS`** (必需)
- **说明**: 用于访问此代理服务的客户端 API 密钥。
- **格式**: 使用逗号分隔。
- **示例**: `sk-mykey-1,sk-mykey-2`
3. **`HTTP_PROXY`** (可选)
- **说明**: 为所有出站请求(例如到 Tenbin API)设置 HTTP/HTTPS 代理。
- **格式**: 标准的代理 URL。
- **示例**: `http://user:pass@host:port`
4. **`DEBUG_MODE`** (可选)
- **说明**: 设置为 `true` 可以启用详细的调试日志。
- **格式**: `true` 或 `false`。
- **示例**: `true`
## 📝 文件说明
- `main.py`: 核心 FastAPI 应用。
- `getCaptcha.py`: 与 Turnstile 验证码求解器交互。
- `Dockerfile`: 构建 Docker 镜像的蓝图。
- `start.sh`: 在容器内启动所有服务的脚本。
- `requirements.txt`: Python 依赖。
- `models.json`: 模型名称映射表。
- `resigner.py`: (本地工具) 用于自动注册新 `session_id` 的脚本。
一、实践
这期不写思路了,我很急,必须让佬友们立刻用上!刚刚开过dang会,我现在红的发烫! :china:
免费过Turnstile。 我是Windows系统,如果你也是,可以根据以下步骤安装Turnstile-Solver,如果系统不一样请自行参考原网站 Turnstile-Solver。
1.1. 运行命令 git clone https://github.com/Theyka/Turnstile-Solver.git
1.2. 进入文件夹后无脑运行命令(但记得python要3.8+) python -m venv venv,然后激活环境venv\Scripts\activate,紧接着配置环境pip install -r requirements.txt
1.3. 我选择安装模拟的是,其他浏览器自行参考原github。python -m patchright install chromium
1.4. 启动服务python api_solver.py,默认是5000端口。