PUBLIC_USAGE.md

# 中转站使用说明

这是一个兼容 OpenAI 格式的中文 AI API 中转站。你拿到管理员发给你的 API Key 后，就可以在支持 OpenAI 接口的软件里使用。

## 基本信息

Base URL：

```text
https://<owner>-<space>.hf.space/v1
```

示例：如果管理员的 Hugging Face 用户名是 `liuyiyang1439`，Space 名叫 `zhongzhuanzhan`，那 Base URL 就是：

```text
https://liuyiyang1439-zhongzhuanzhan.hf.space/v1
```

API Key：

```text
由管理员单独发放，请不要公开分享
```

## 常见软件填写方式

在支持 OpenAI 兼容接口的软件里填写：

- API Base / Base URL：`https://<owner>-<space>.hf.space/v1`
- API Key：你的用户 API Key
- Model：管理员告诉你的可用模型名

## curl 测试

把 `<user-api-key>` 和 `<model>` 换成你的实际内容：

```powershell
$headers = @{
  "Authorization" = "Bearer <user-api-key>"
  "Content-Type" = "application/json"
}

$body = @{
  model = "<model>"
  messages = @(
    @{ role = "user"; content = "你好，请用中文简单介绍你自己。" }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://<owner>-<space>.hf.space/v1/chat/completions" `
  -Method POST `
  -Headers $headers `
  -Body $body
```

## 注意事项

- 不要把 API Key 发到群里、论坛或公开仓库。
- 如果提示 `401`，通常是 API Key 写错、被禁用，或 Base URL 少了 `/v1`。
- 如果提示 `503`，通常是当前模型没有可用上游账号、模型名不在可用列表，或上游暂时不可用。
- 额度、倍率、可用模型以管理员设置为准。