Team Ai
Apppublic

Fimall/scnet

sourceHugging Faceupdated 4mo agoView on Hugging Face
0likes
App README

SCNet → OpenAI Compatible API Proxy

这是一个可以部署到 Hugging Face Space 的 Docker 版本，提供 OpenAI 兼容接口：

  • —POST /v1/chat/completions
  • —GET /v1/models
  • —GET /healthz
  • —GET /

部署步骤

  1. 1.在 Hugging Face 新建一个 Space，SDK 选择 Docker。
  2. 2.把本目录里的文件上传到 Space 仓库根目录：
  3. 3.README.md
  4. 4.Dockerfile
  5. 5.go.mod
  6. 6.main.go
  7. 7..dockerignore
  8. 8.在 Space 的 Settings → Variables and secrets 里按需添加环境变量。
  9. 9.Space 自动 build 完成后即可使用。

环境变量

变量必填说明
API_KEY否设置后，调用方必须使用 Authorization: Bearer <API_KEY>。不设置则无鉴权。
SCNET_USERNAME否SCNet 登录用户名。需要联网搜索模型时建议设置。
SCNET_PASSWORD否SCNet 登录密码，建议在 Hugging Face Secrets 中设置。
SCNET_MAX_SESSIONS否最大缓存会话数，默认 10。
VERBOSE否设置为 true 或 1 输出更详细日志。
SCNET_CLEAN_ON_START否设置为 true 时启动时清理远端会话。默认不清理。
SCNET_CLEAN_ON_SHUTDOWN否设置为 false 时关闭时不清理远端会话。默认清理。
CACHE_FILE否会话缓存路径，默认 /tmp/conversations.json。
PORT否Hugging Face 默认使用 7860，通常不需要改。

调用示例

把 <SPACE_URL> 换成你的 Space 地址，例如 https://用户名-Space名.hf.space。

bash
curl <SPACE_URL>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "你好"}
    ],
    "stream": false
  }'

如果没有设置 API_KEY，删除 Authorization 这一行。

可用模型

匿名模式通常可用：

  • —deepseek-v4-pro
  • —deepseek-v4-flash

设置 SCNET_USERNAME / SCNET_PASSWORD 并登录成功后，还会暴露：

  • —deepseek-v4-pro-search
  • —deepseek-v4-flash-search

本地 Docker 测试

bash
docker build -t scnet-hf-space .
docker run --rm -p 7860:7860 \
  -e API_KEY=your_api_key \
  scnet-hf-space

然后访问：

bash
curl http://localhost:7860/healthz
curl http://localhost:7860/v1/models