5MIN_GUIDE.md

🚀 Grok2API HF Spaces 快速部署

5 分钟完成 Hugging Face Spaces 部署！

第一步：获取源代码 ⏱️ 1分钟

Windows 用户（PowerShell）：

.\get_source.ps1

Mac/Linux 或 Git Bash：

bash get_source.sh

第二步：创建 Space ⏱️ 1分钟

1. 访问：https://huggingface.co/new-space
2. 填写：
   • Space name: grok2api
   • SDK: Docker ⚠️
   • Hardware: CPU basic
3. 点击创建

第三步：推送代码 ⏱️ 1分钟

git init
git add .
git commit -m "Deploy to HF Spaces"
git remote add hf https://huggingface.co/spaces/你的用户名/你的Space名
git push hf main

第四步：配置环境 ⏱️ 1分钟

在 Space Settings → Variables 添加：

APP_KEY = 你的管理密码
API_KEY = sk-你的API密钥
APP_URL = https://你的用户名-你的Space名.hf.space
DATA_DIR = /data
ACCOUNT_STORAGE = local

第五步：启用存储 ⏱️ 30秒

在 Space Settings 中：

• 启用 Persistent Storage

第六步：配置保活 ⏱️ 30秒

1. Fork https://github.com/wankuzidi/hf-keepalive
2. 在你的 fork 设置 Variables: HF_SPACES=你的Space链接
3. 启用 Actions

---

✅ 完成！

访问你的 Space：https://你的用户名-你的Space名.hf.space

管理后台：https://你的用户名-你的Space名.hf.space/admin/login

---

🆘 遇到问题？

问题	解决方案
Space 无法启动	查看 Logs 标签，检查环境变量
图片/视频 403	检查 APP_URL 是否正确
数据丢失	确认启用了 Persistent Storage
API 调用失败	检查 API_KEY，添加 X Token

详细说明：DEPLOY_GUIDE.md

---

免责声明: 仅供学习交流使用