NAIS API v1
국가과학AI연구센터 공개 API. 1단계는 ADME/Tox 예측입니다. 예측은 기관 내부 장비에서 계산되며 입력 구조는 기관 밖으로 나가지 않습니다. 요청 본문(SMILES)은 기록하지 않습니다.
1. API 키
- 관리자가 API 사용을 허가한 계정이 포털의 API 키 화면에서 직접 발급합니다(최대 5개 · 만료 30/90/365일).
- 키는 발급할 때 한 번만 보입니다. 서버에는 해시만 저장됩니다. 잃어버리면 폐기하고 새로 발급하십시오.
- 모든 요청에
Authorization: Bearer nais_…헤더를 넣습니다.
2. 예측
POST/v1/admet/predictions — 분자 하나(SMILES, 1,000자 이하)
curl -s https://api.nais.re.kr/v1/admet/predictions \
-H "Authorization: Bearer $NAIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"smiles": "CC(=O)OC1=CC=CC=C1C(=O)O"}'
{
"smiles": "CC(=O)OC1=CC=CC=C1C(=O)O",
"elapsed_ms": 151,
"properties": [
{ "id": "molecular_weight", "name": "Molecular Weight", "category": "Physicochemical",
"category_label": "물리화학적 성질", "units": "Dalton", "value": 180.159, "percentile": 12.3,
"reliability": "computed", "auroc": null, "r2": null, "hidden": false },
{ "id": "Half_Life_Obach", "name": "Half Life", "value": null, "reliability": "unusable", "hidden": true, … }
],
"hidden": [ { "name": "Half Life", "r2": -2.386 } ],
"counts": { "computed": 11, "high": 22, … }
}
reliability: computed(결정적 계산) · high · medium · low · unusable.
unusable(R² ≤ 0, 평균을 찍는 것보다 못한 모델)은 값을 주지 않습니다(value: null, hidden: true).
GET/v1/admet/properties — 예측하는 성질 목록과 성능 수치(AUROC · R²)
3. 한도
| 단위 | 한도 | 넘으면 |
|---|---|---|
| 키당 1분 | 60회 | 429 rate_limited (Retry-After) |
| 키당 하루(KST) | 1,000회 — 성공한 예측만 셉니다 | 429 daily_limit_reached |
| 동시 예측(서버 전체, 웹 화면 포함) | 2건 | 503 busy — 몇 초 뒤 다시 |
응답 헤더 X-Daily-Limit · X-Daily-Remaining 로 남은 하루 한도를 알 수 있습니다.
4. 오류
{ "error": { "code": "invalid_smiles", "message": "이 SMILES 를 읽을 수 없습니다(invalid_smiles)." } }
code 는 바뀌지 않는 약속이고 message 는 사람이 읽는 설명입니다. 코드 목록:
unauthorized invalid_json invalid_request smiles_blank smiles_too_long invalid_smiles rate_limited daily_limit_reached busy model_not_ready disabled unavailable not_found
5. 명세
OpenAPI 3.1: /v1/openapi.json