API 文档
接口一览
| 方法 | 路径 | 说明 | 认证 |
|---|---|---|---|
| POST | /api/v1/auth/register | 邮箱+密码+单位(选填)注册，发验证邮件 | 公开 |
| GET | /api/v1/auth/verify?token= | 邮箱验证回跳 | 公开 |
| POST | /api/v1/auth/login | 登录，Set-Cookie HttpOnly Session | 公开 |
| POST | /api/v1/auth/logout | 退出登录 | Session |
| POST | /api/v1/auth/reset | 请求密码重置邮件 | 公开 |
| POST | /api/v1/auth/reset/apply | 用重置 token 修改密码 | 公开 |
| GET | /api/v1/me | 当前用户信息 + 配额 + 角色 | Session/Token |
| POST | /api/v1/tokens | 创建 API Token（明文仅返回一次） | Session |
| GET | /api/v1/tokens | Token 列表（备注名、末 4 位、时间） | Session |
| DELETE | /api/v1/tokens/{id} | 吊销 Token（立即失效） | Session |
| POST | /api/v1/predict | 六维参数 + 可选 model（optical/full）→ 模拟光谱 JSON | Session/Token |
| POST | /api/v1/upload | 上传光谱 fits/txt/csv ≤2MB | Session/Token |
| POST | /api/v1/fit | 光谱拟合 → 异步任务 job_id（可带固定丰度 logc/logn/logo） | Session/Token |
| GET | /api/v1/jobs/{id} | 查询任务状态与结果 | Session/Token |
| DELETE | /api/v1/jobs/{id} | 取消排队/运行中的任务 | Session/Token |
| GET | /api/v1/jobs | 我的任务历史 | Session/Token |
| GET | /api/v1/models | 可用模型列表 | Session/Token |
参数定义
六维输入：Teff 有效温度（K）；log g 表面重力；log(nHe/nH)、log(nC/nH)、log(nN/nH)、log(nO/nH) 为氦/碳/氮/氧丰度（dex，log10 数比）。仅支持网格边界内插值，越界请求返回 invalid。参数域也可由 /api/v1/models 实时获取。
| 参数 | 有效范围 | 含义 |
|---|---|---|
| teff | 20000 – 60000 K | 有效温度 |
| logg | 5.0 – 6.5 dex | 表面重力 |
| loghe | −4 – 2 dex | 氦丰度 log(nHe/nH) |
| logc | −6 – −2 dex | 碳丰度 log(nC/nH) |
| logn | −5 – −3 dex | 氮丰度 log(nN/nH) |
| logo | −6 – −3 dex | 氧丰度 log(nO/nH) |
可用模型
| 模型 | 波长覆盖 | 网格点数 | 测试精度 (median dex) |
|---|---|---|---|
| optical（默认） | 3650 – 9200 Å | 9245 | 0.00816 |
| full | 100 – 20000 Å | 52984 | 0.01158 |
错误码
| HTTP | 说明 |
|---|---|
| 401 | 未登录或会话过期 |
| 403 | 角色不足或非本人资源（含账号禁用） |
| 409 | 配额已用尽（返回重置时刻） |
| 413 | 文件超过 2 MB |
| 415 | 文件类型不支持（需 FITS 魔术字或 ascii） |
| 422 | 参数超出模型训练域 |
| 429 | 请求过于频繁 |
引用规范
使用计算结果时，默认引用本服务（工具 + 模型版本 + 日期）；方法出处另引已发表论文（arXiv:2512.20185, ApJS）。服务自身论文发表前，不提供第二条 BibTeX。
限流与配额
登录接口 5 次/分钟（IP+账号）；预测与拟合按角色每日配额，任务产物保留 7 天。
使用条款
非商业科研用途；模型与星表版权归课题组；结果为统计估计而非真值，重要结论请自行复核。
已知局限
- 外推区域（超出训练网格）会被拒绝，不给出结果；
- 精度依赖信噪比，低 SNR 光谱误差增大；
- 暂不支持复合光谱分解与多成分拟合。