| # 用户使用指南 - 解决 API 错误 | |
| ## 看到的错误信息 | |
| ``` | |
| Gemini/OpenAI API Error: Error: SERVER_DEFAULT_KEY_NOT_SET | |
| ``` | |
| ## 解决方案 | |
| ### 方案 1：使用自定义 API（推荐） | |
| 1. **填写表单**： | |
| - 姓名选填 | |
| - 性别：选择乾造(男)或坤造(女) | |
| - 使用"智能输入"模式填写出生信息（最简单） | |
| 2. **配置 API**： | |
| - 选择"使用自定义 API" | |
| - 模型名称：`gemini-1.5-flash`（推荐）或 `gemini-1.5-pro` | |
| - API Base URL：`https://ttkk.inping.com/v1` | |
| - API Key：从相关平台获取密钥 | |
| 3. **获取 API 密钥**： | |
| - 联系开发者或查看文档获取 | |
| - 其他可用平台：OpenAI、Claude 等 | |
| ### 方案 2：免费模式（需要服务器配置） | |
| 如果服务器配置了默认密钥： | |
| 1. 选择"免费模式" | |
| 2. 输入邮箱和密码（会自动注册） | |
| 3. 系统会分配免费额度 | |
| ### 方案 3：本地部署 | |
| 开发者可以： | |
| 1. 克隆代码 | |
| 2. 设置环境变量： | |
| ```bash | |
| export API_KEY="your-api-key-here" | |
| export API_BASE_URL="https://api.openai.com/v1" | |
| ``` | |
| 3. 运行服务 | |
| ## 测试步骤 | |
| 1. 打开应用：https://www.life-kline.com | |
| 2. 点击"智能输入"模式 | |
| 3. 填写： | |
| - 性别：例如选择"乾造(男)" | |
| - 出生日期：例如 1990-01-01 | |
| - 出生时间：例如 12:00 | |
| - 出生城市：北京 | |
| 4. 配置 API： | |
| - ✅ 使用自定义 API | |
| - 模型：`gemini-1.5-flash` | |
| - Base URL：`https://ttkk.inping.com/v1` | |
| - API Key：填写你的密钥 | |
| 5. 点击"生成人生K线" | |
| ## 常见问题 | |
| ### Q: 为什么会出现 SERVER_DEFAULT_KEY_NOT_SET？ | |
| A: 服务器没有配置默认的 API 密钥，需要使用自己的 API 密钥。 | |
| ### Q: 哪里可以获取 API 密钥？ | |
| A: 联系项目作者或查看相关文档获取测试密钥。 | |
| ### Q: 可以使用其他 AI 服务吗？ | |
| A: 支持 OpenAI、Claude、Gemini 等兼容 OpenAI 格式的 API。 | |
| ## 技术细节 | |
| - 前端已优化加载速度（70KB 首屏） | |
| - 八字计算完全本地（lunar-javascript） | |
| - API 密钥安全存储（仅传输到服务器） | |
| - 支持加密连接（HTTPS） | |