PUBLIC_USAGE.md

中转站使用说明

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

基本信息

Base URL：

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

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

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

API Key：

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

常见软件填写方式

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

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

curl 测试

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

$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，通常是当前模型没有可用上游账号、模型名不在可用列表，或上游暂时不可用。
• 额度、倍率、可用模型以管理员设置为准。