NAIS API v1

국가과학AI연구센터 공개 API. 1단계는 ADME/Tox 예측입니다. 예측은 기관 내부 장비에서 계산되며 입력 구조는 기관 밖으로 나가지 않습니다. 요청 본문(SMILES)은 기록하지 않습니다.

1. API 키

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