---
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端口。