tianping / README.md
maltose1's picture
Upload 9 files
d498971 verified
metadata
title: Tenbin OpenAI API Adapter
emoji: 🚀
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false

Tenbin OpenAI API 适配器

本项目将 Tenbin.ai (Oshiete AI) 的服务接口转换为与 OpenAI API 完全兼容的格式。

它通过一个 Docker 容器,同时运行 FastAPI 核心服务和一个 Turnstile-Solver 实例,实现了对 Tenbin 账户池的管理、请求转换、流式响应和人机验证的全自动处理。

🚀 如何使用此 Space

部署成功后,您可以像使用官方 OpenAI API 一样,在任何支持的客户端中使用此服务。

  • API Base URL: https://<your-space-name>.hf.space/v1
  • API Key: 您在 Secrets 中配置的任何一个 API 密钥。
  • 模型: 请参考 models.json 文件中的可用模型列表。

cURL 示例

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_NAMEYOUR_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 可以启用详细的调试日志。
    • 格式: truefalse
    • 示例: 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端口。