New API¶

1. 服务简介¶

New API 是课题组内部统一的 AI 模型 API 网关。用户可以通过该网关使用小组提供的部分大模型(包括商业和自部署)，也可以通过该网关分享一些模型。

2. 适用场景¶

New API 主要适用于：

• 科研数据处理脚本中的大模型调用
• Python / R / Shell 程序调用 AI
• Claude Code、Codex 等 AI 编程工具
• Open WebUI、Cherry Studio 等 AI 客户端
• Agent、MCP 等智能体开发
• 课题组内部开发的 AI 应用
• 批量文献处理、文本分析、信息抽取等科研任务

3. 服务地址¶

New API 控制台

平台禁止个人注册，请联系管理员获取账号。

4. 创建 API Token¶

登录 New API 后，在：

控制台 → Token / 令牌管理

创建自己的 API Token，可以根据需要设置该key的时效、额度以及模型。建议 Token 名称能够说明用途，这样后续发生异常调用时，更容易定位来源。

5. 快速测试¶

可以通过 curl 测试 API 是否正常。

curl https://api.iomics.pro/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下自己。"
      }
    ]
  }'

其中：

YOUR_API_KEY

替换为自己的 Token。

MODEL_NAME

替换为 New API 中实际可用的模型名称。

6. 查看可用模型¶

可以通过 API 查询当前账号能够访问的模型：

curl https://api.iomics.pro/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

也可以直接登录 New API 控制台查看，也可以直接在Playground测试

不同用户、用户组或 Token 所能调用的模型可能不同。

7. 使用规范¶

为了保证组内服务稳定，请遵守以下规则：

账号安全¶

• 禁止共享自己的 API Token
• 禁止将 Token 上传到公开代码仓库
• 禁止将组内 API 转发给无关人员

资源使用¶

• 普通任务尽量选择能够满足需求的小模型
• 大规模批处理任务建议提前说明
• 避免无意义的高并发请求
• 避免无限循环调用 API
• 不要使用自动化程序恶意占用模型资源

数据安全¶

对于尚未公开的科研数据、论文、项目材料等，应根据数据敏感程度选择合适的模型。

尤其注意：

• 自建模型
• 第三方商业 API
• 外部云端模型

三者的数据处理方式可能不同。

涉及敏感或未公开数据时，如不确定是否可以使用某个模型，请先咨询管理员。

8. 服务维护¶

服务负责人： <管理员姓名> 问题反馈： <微信群 / Issue / 邮箱> 服务状态： <可选：状态页地址>

如果遇到服务异常，请优先反馈：

时间 + 模型 + 错误信息 + Request ID

无需提供自己的完整 API Key。