5MIN_GUIDE.md

# 🚀 Grok2API HF Spaces 快速部署

> 5 分钟完成 Hugging Face Spaces 部署！

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

**Windows 用户（PowerShell）：**
```powershell
.\get_source.ps1
```

**Mac/Linux 或 Git Bash：**
```bash
bash get_source.sh
```

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

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

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

```bash
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 中：
- [x] 启用 **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](./DEPLOY_GUIDE.md)

---

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