欢迎使用深旋科技（Atomelody）开放平台 API。
深旋科技提供了 Melo-1 等先进的生物基础大模型计算服务，支持以 API 接入的方式提交生物大分子三维结构预测与虚拟筛选任务、自动化轮询结果并集成至自有科研或企业内部研发系统中。
快速开始
首次接入时，按任务类型选择使用指南；任务接口字段、状态与错误码见任务管理 API，可用点数与周期额度查询见账户额度 API。
MCP 接入指南复制接入提示词，让 AI Agent 帮你连接 Atomelody；提供客户端配置、认证与连接验证步骤。任务管理 API查阅所有任务共用的询价、创建、查询、列表与取消接口，以及请求响应字段、状态和错误码。账户额度 API查询当前账号的可用点数、冻结点数、周期额度及下次刷新时间，提供 Python 与 cURL 示例。结构预测使用指南准备分子与复合物输入，预估费用、提交结构预测任务并下载和查看结果，提供 Python 与 cURL 示例。虚拟筛选使用指南针对同一靶点批量比较候选分子，了解输入格式、逐候选报价、结果下载与汇总表。生成结构预测结果报告下载独立 HTML 模板，让 agent 将结构预测结果 ZIP 生成为可离线打开的交互报告。生成虚拟筛选结果报告将整批筛选 ZIP 生成为离线交互报告，比较候选排名与评分，查看三维结构和置信度。API Key 凭据管理在平台控制台创建、查看与管理您的访问凭据密钥。计价与配额规则了解结构预测的 Token 阶梯、虚拟筛选的逐组合计费、任务限制及点数结算流程。
REST API 接入规范
以下规范适用于 REST API；AI Agent 的 MCP 地址、认证与配置方式见 MCP 接入指南。
基础域名与接口协议
- 所有开放 API 接口均基于 HTTPS 协议。
- 接口基础域名：
https://api.atomelody.com - 请求路径版本前缀为
/v1。 - 包含请求体的接口使用 JSON 编码，请设置
Content-Type: application/json。 - API 设有用户级别的请求速率限制，请在调用端主动控制请求速率。
身份认证 (Authentication)
在每次向 API 发送请求时，必须在 HTTP Header 中附带有效的 API Key：
Authorization: Bearer ak_your_api_key_here
通用响应结构
REST API 接口采用统一的 JSON 响应格式封装：
{
"code": "OK",
"message": "OK",
"data": { ... }
}
code: 稳定的机器可读业务码。"OK"表示调用成功，其他值表示具体错误类型。message: 本次请求的状态或错误描述，成功时为"OK"；错误文案可能包含具体的字段、位置或限制信息。data: 业务响应数据，类型根据具体接口定义而定。无返回数据的成功响应以及错误响应中可能不包含该字段。
客户端应根据 HTTP 状态码和 code 处理错误，不应依赖可能随具体错误原因变化的 message 文案。