Skip to main content

누빈트 API 문서

누빈트 API의 인증, 엔드포인트, 응답 형식을 정리했습니다. 원고 검토, 과학 그림, 근거 종합을 같은 키로 부릅니다.

개요

모든 요청은 HTTPS로 보내는 JSON입니다. 원고 점검, 논문 검색, 데이터 차트는 결과가 응답에 바로 담겨 돌아옵니다. 그림이나 문헌 조사처럼 몇 분 걸리는 작업은 taskId를 돌려주고, 결과는 작업 조회로 읽습니다.

기본 주소https://api.nubint.ai/api/v1

응답 필드 이름은 camelCase입니다. 예외로 서지(csl)는 CSL-JSON 표준 키(container-title, DOI 등)를, 지적의 params는 snake_case 키를 그대로 씁니다.

인증

요청마다 X-API-Key 헤더에 API 키를 넣습니다. Authorization 헤더가 아닙니다.

Header
X-API-Key: nbk_live_...

키는 누빈트 앱의 설정 → API/MCP에서 발급합니다. nbk_live_로 시작하고 발급 직후 한 번만 보여 줍니다. 서버에는 해시만 저장하므로 잃어버리면 새로 발급해야 합니다.

계정당 활성 키는 10개까지입니다. 유출이 의심되면 같은 화면에서 바로 폐기하세요. 폐기한 키는 즉시 거절됩니다.

모든 경로는 Starter·Pro·Max 요금제가 필요하고, 무료 요금제 계정의 키로 부르면 403을 받습니다 — 키는 그대로 남고, 구독하면 같은 키로 동작합니다. 크레딧이 들지 않는 도구(논문 검색, 라이브러리, 원고 저장, 문서 읽기·수정 제안, 작업 조회)와 참고문헌 실존 확인은 크레딧이 차감되지 않습니다.

키를 브라우저 코드나 공개 저장소에 넣지 마세요. 서버나 로컬 환경 변수에서만 쓰세요.

누빈트

참고문헌 실존 확인

POST/developer/review/reference-verification

참고문헌 목록의 각 항목이 실제 문헌을 가리키는지 학술 색인과 대조합니다. 언어 모델을 부르지 않아 같은 입력에는 같은 결과가 나옵니다. 참고문헌을 `.bib` 파일로 가지고 있다면 `referencesBibtex`에 원문을 그대로 넣어도 됩니다 (서버가 한 줄씩으로 바꿔 이어 붙입니다).

요청

referencesstring[]

참고문헌 문자열 배열. 본문이 아니라 References 섹션의 항목을 한 줄씩 넣습니다. 최대 100건. DOI가 있으면 함께 두세요 — 매칭이 정확해집니다.

curl -X POST https://api.nubint.ai/api/v1/developer/review/reference-verification \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "references": [
      "Spiegel, K., Leproult, R., & Van Cauter, E. (1999). Impact of sleep debt on metabolic and endocrine function. The Lancet, 354(9188), 1435-1439.",
      "Anderson, R. T., & Liu, M. (2023). Chronotype misalignment and cognitive load in higher education. Educational Neuroscience Quarterly, 11(4), 501-519."
    ]
  }'

응답

200 OK
{
  "results": [
    {
      "text": "Spiegel, K., Leproult, R., & Van Cauter, E. (1999). ...",
      "status": "verified",
      "basis": "title_exact",
      "paper": {
        "canonicalId": "https://doi.org/10.1016/s0140-6736(99)01376-8",
        "csl": {
          "type": "article-journal",
          "title": "Impact of sleep debt on metabolic and endocrine function",
          "container-title": "The Lancet",
          "DOI": "10.1016/s0140-6736(99)01376-8"
        }
      },
      "csl": null,
      "matchedTitle": "Impact of sleep debt on metabolic and endocrine function",
      "nearMissTitle": null
    },
    {
      "text": "Anderson, R. T., & Liu, M. (2023). ...",
      "status": "off_index",
      "basis": "parsed",
      "paper": null,
      "csl": {
        "type": "article-journal",
        "title": "Chronotype misalignment and cognitive load in higher education",
        "container-title": "Educational Neuroscience Quarterly"
      },
      "matchedTitle": null,
      "nearMissTitle": null
    }
  ],
  "summary": {
    "total": 2,
    "verified": 1,
    "uncertain": 0,
    "offIndex": 1,
    "unparseable": 0,
    "needsReview": 1
  }
}
status

판정. 아래 '판정 값'을 참고하세요.

basis

판정 근거 — identifier(DOI 등 식별자 일치), title_exact, title_strong, title_partial, parsed(색인 밖, 서지만 읽음), none.

paper

색인에서 찾은 논문의 서지와 식별자. verified와 uncertain일 때만 채워집니다.

csl

색인 밖 문헌을 원문에서 읽어 낸 서지(CSL-JSON). off_index일 때만 채워집니다.

matchedTitle

채택된 색인 후보의 제목. uncertain일 때 사용자가 자기 참고문헌과 대조하는 데 씁니다.

nearMissTitle

제목이 충분히 겹치지 않아 버린 후보의 제목(off_index일 때만). 원고 쪽 표기가 틀린 경우 고칠 단서입니다. 채택된 매칭이 아니므로 인용으로 쓰면 안 됩니다.

summary

집계. needsReview는 verified가 아닌 전부, 즉 사용자가 직접 확인할 건수입니다.

누빈트

AI 작성 감지

POST/developer/review/ai-detection

텍스트가 AI로 작성된 것처럼 읽히는지 독립된 감지 모델로 판정합니다. 문단 단위로 판정하고, 걸린 문단에서는 판정을 이끈 문장을 순위와 함께 짚습니다.

safe는 사람이 썼다는 뜻이 아닙니다. 사람 글을 AI로 판정하는 오탐을 줄이도록 기준을 보수적으로 잡아, 놓치는 경우가 잡는 경우보다 많습니다. 걸리면 신호이고, 안 걸리면 모르는 것입니다. 확률 숫자는 반환하지 않습니다.

요청

textstring

검사할 텍스트. 문단은 빈 줄로 구분합니다. 최대 200,000자.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/review/ai-detection \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Full manuscript text, paragraphs separated by blank lines..." }'

응답

200 OK
{
  "verdict": "caution",
  "checked": 9,
  "flagged": 2,
  "creditsCharged": 40,
  "issues": [
    {
      "code": "possibly",
      "category": "possibly",
      "anchor": "The sentence in your manuscript that drove the flag.",
      "reference": null,
      "params": {
        "lang": "en",
        "rank": 1,
        "rank_total": 2,
        "unit_tokens": 142,
        "reasons": [
          { "code": "sentence_contribution", "rank": 1, "total": 2 }
        ]
      },
      "message": null
    }
  ]
}
verdict

문서 전체 판정 — safe · caution · risk · inconclusive.

checked

판정한 문단 수.

flagged

단계가 붙은 문단 수.

creditsCharged

이 요청에 청구된 크레딧. inconclusive 는 0.

issues

걸린 문장 목록. code는 단계(likely · possibly), anchor는 원문 문장, params.rank는 그 문단 안에서의 순위입니다.

감지 서비스가 응답하지 않으면 이 엔드포인트는 502를 돌려줍니다. 결과 없이 safe를 내보내지 않습니다.

누빈트

원고 전체 점검

POST/developer/review/manuscript-check

본문과 참고문헌을 한 번에 보내면 참고문헌 실존 확인, AI 작성 감지, 출처 품질 세 섹션을 돌려줍니다. 참고문헌 매칭은 한 번만 수행해 두 섹션이 같은 논문을 봅니다. 참고문헌을 `.bib` 파일로 가지고 있다면 `referencesBibtex`에 원문을 그대로 넣어도 됩니다 (서버가 한 줄씩으로 바꿔 이어 붙입니다).

요청

textstring

원고 본문. 비우면 AI 작성 감지와 출처 품질이 skipped 됩니다. 최대 200,000자.

referencesstring[]

참고문헌 문자열 배열. 비우면 참고문헌 확인과 출처 품질이 skipped 됩니다. 최대 100건.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/review/manuscript-check \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Full manuscript text...",
    "references": [
      "Spiegel, K., Leproult, R., & Van Cauter, E. (1999). Impact of sleep debt on metabolic and endocrine function. The Lancet, 354(9188), 1435-1439.",
      "Anderson, R. T., & Liu, M. (2023). Chronotype misalignment and cognitive load in higher education. Educational Neuroscience Quarterly, 11(4), 501-519."
    ]
  }'

응답

AI 작성 감지가 실패한 예입니다. 나머지 섹션은 그대로 결과를 냅니다 (일부 필드 생략).

200 OK
{
  "citations": {
    "status": "ok",
    "reason": null,
    "summary": { "total": 2, "verified": 1, "offIndex": 1, "needsReview": 1, ... },
    "results": [ ... ]
  },
  "aiDetection": {
    "status": "failed",
    "reason": "TimeoutError: detection service did not respond",
    "verdict": null,
    "checked": 0,
    "flagged": 0,
    "issues": []
  },
  "sourceQuality": {
    "status": "ok",
    "reason": null,
    "checked": 1,
    "issues": []
  },
  "creditsCharged": 30
}
*.status

섹션마다 따로 있습니다 — ok(검사함), failed(우리 쪽 장애로 못 함, 다시 시도하면 됨), skipped(입력이 없어 건너뜀). failed와 skipped에는 reason이 붙습니다.

sourceQuality

확인된 참고문헌만 검사합니다 — 철회(retracted_source), 우려 표명(expression_of_concern), 프리프린트(preprint_source · preprint_has_published_version), 인용이 적은 출처(low_citation_source) 등.

creditsCharged

이 요청에 청구된 크레딧. 성공한 섹션만 과금하고 failed·skipped 와 AI 감지 inconclusive 는 0.

누빈트

판정 값

참고문헌 판정 (status)

verified

색인에서 확인됨. DOI 등 식별자나 제목이 일치합니다.

uncertain

후보는 찾았지만 제목이 부분적으로만 일치합니다. matchedTitle과 대조해 보세요.

off_index

이 색인으로는 확인하지 못했습니다. 단행본 · 법령 · 비공개 학술지처럼 원래 색인에 없는 문헌일 수 있습니다. 존재하지 않는다는 뜻이 아닙니다.

unparseable

서지 항목으로 읽을 수 없는 줄입니다 (제목 · 연도 · 저자를 찾지 못함).

AI 작성 감지 판정 (verdict)

safe

이 검사로는 AI 작성 특징을 찾지 못했습니다. 사람이 썼다는 보증이 아닙니다.

caution

일부 문단에 AI 작성 특징이 있습니다. 해당 문장을 확인하세요.

risk

여러 문단에 뚜렷한 AI 작성 특징이 있습니다.

inconclusive

판정할 산문이 부족합니다 (너무 짧거나 표 · 목록 위주). AI가 아니라는 뜻이 아닙니다.

누빈트

지적 객체

AI 작성 감지와 출처 품질의 지적은 같은 형태입니다.

code

안정적인 식별자. 화면 문구를 이 값으로 고르세요.

anchor

문제가 된 원문 문장. 저자-연도 인용(APA 등) 원고에서는 출처 품질 지적의 anchor가 비어 있을 수 있습니다. 그때는 reference로 논문을 식별합니다.

anchorStart

anchor가 요청에 보낸 text에서 시작하는 위치. 같은 문장이 두 번 나올 때 문자열 검색은 앞엣것을 집습니다 — 문서에 코멘트를 달거나 하이라이트할 때는 이 값을 쓰세요. 위치를 못 구하면 null입니다. 세는 단위는 유니코드 코드 포인트라 JavaScript 인덱스(UTF-16)와 이모지 등에서 어긋납니다.

anchorEnd

anchor가 끝나는 위치 (anchorStart + 앵커 길이).

reference

지적 대상 논문의 식별자(canonicalId).

params

문구를 만드는 데 쓰는 값(참고문헌 번호, 인용 수, 순위 등).

message

사용자 언어로 된 지적 문구. 검사가 문구를 만든 경우에만 채워집니다.

누빈트 피규어

그림 그리기 · 고치기

POST/developer/figure/start

설명으로 그림을 그리거나 이미 그린 그림을 바꿉니다. 작업을 시작하고 taskId를 바로 돌려주며, 결과는 작업 조회로 읽습니다. 그림은 프로젝트 캔버스에도 놓입니다(응답의 url).

요청

promptstring

그릴 내용, 배치, 라벨. 라벨은 그림에 넣을 언어로 씁니다. generate와 edit에 필요합니다.

actionstring

할 일 — generate(기본) · edit · recolor · remove_background · white_background · change_ratio · upscale · to_svg · to_pptx. generate가 아니면 이미 있는 그림이 대상입니다.

kindstring

새로 그릴 그림의 종류 — illustration(기본, 일러스트 · 모식도) 또는 flowchart(상자 · 화살표 · 글자로 된 흐름도 · 구조도).

projectIdstring

결과를 놓을 프로젝트. 비우면 새 프로젝트가 생기고, 같은 값을 넘기면 한 캔버스에 쌓입니다.

baseImageUrlstring

바꿀 그림의 imageUrl. 비우면 projectId에서 가장 최근에 나온 그림이 대상입니다.

stylestring

화풍 — flat · 2.5d · 3d · sketch · line-art · hand-drawn.

palettestring

색 구성. action이 recolor면 꼭 넣습니다.

ratiostring

비율 — 16:9 · 1:1 · 4:3 등. action이 change_ratio면 꼭 넣습니다.

upscaleTargetstring

action이 upscale일 때의 목표 크기 — 2k · 4k · 8k.

attachmentsstring[]

그림의 내용이 될 파일의 fileUrl 배열. /developer/figure/file 로 먼저 올립니다.

styleReferencesstring[]

생김새를 따를 그림의 fileUrl 배열. 내용은 옮기지 않습니다.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/figure/start \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Ligand-receptor signaling through the MAPK cascade (RAS, RAF, MEK, ERK) to target gene transcription",
    "style": "flat",
    "ratio": "16:9"
  }'

응답

{
  "taskId": "9f2c41d0...",
  "status": "running",
  "projectId": "5b0f7a3e...",
  "url": "https://app.nubint.ai/figure/5b0f7a3e..."
}
taskId

작업 조회에 넘기는 값. 24시간 동안 쓸 수 있습니다.

projectId

이 그림의 프로젝트. 다음 요청에 넘겨 이어 갑니다.

url

누빈트 피규어에서 캔버스를 여는 주소. 글자 수정, 영역 다시 그리기, 내보내기는 여기서 합니다.

result

작업 조회의 결과. 그림이면 imageUrl, SVG · PPTX면 fileUrl이 오고, creditsCharged에 이 작업에 쓴 크레딧이 실립니다.

그림 속 글자는 이미지 모델이 그리므로 철자를 한 번 확인하도록 안내하세요. 실제 데이터로 그리는 차트는 이 경로가 아니라 /developer/figure/plot 을 쓰세요.

누빈트 피규어

데이터 차트

POST/developer/figure/plot

실제 데이터로 차트를 그립니다. 이미지 모델이 아니라 코드가 그려서 값이 표 그대로이고, 결과가 같은 응답에 담겨 돌아옵니다.

요청

csvstring

CSV 글. 첫 줄이 열 이름입니다. 값을 반올림하거나 채우지 말고 그대로 보냅니다.

dataFilestring

csv 대신 — /developer/figure/file 에 purpose를 data로 올린 표(CSV · TSV · XLSX)의 fileUrl. 엑셀은 첫 시트를 읽습니다.

journalStylestring

저널 스타일 — general(기본) · nature · science · cell · plos-one · acs. 그 저널의 그림이 흔히 쓰는 폭과 글자 크기로 그립니다. 저널의 투고 규정을 보증하지는 않습니다.

chart.typestring

차트 종류 — bar · line · scatter · box · violin · heatmap · histogram.

chart.x · chart.ystring

x축과 y축에 쓸 열 이름. histogram은 x에 구간으로 묶을 숫자 열을 줍니다.

chart.groupBystring

계열을 나눌 열.

chart.aggregatestring

bar · line에서 x가 같은 줄을 합치는 방법 — mean(기본) · median · sum · count · none.

chart.errorstring

오차 막대 — none · sd · sem.

palette · ratiostring

색 구성과 비율.

includeSvgboolean

true면 고칠 수 있는 SVG 파일(svgUrl)도 함께 받습니다. SVG 내보내기 값이 더해집니다.

projectIdstring

차트를 놓을 프로젝트.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/figure/plot \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "csv": "group,glucose\ncontrol,5.1\ncontrol,5.4\nrestricted,6.2\nrestricted,6.0",
    "chart": { "type": "bar", "x": "group", "y": "glucose", "error": "sd", "showPoints": true }
  }'

응답

200 OK
{
  "imageUrl": "https://.../plot.png",
  "summary": {
    "type": "bar", "rowsRead": 4, "rowsPlotted": 4,
    "rowsDropped": 0, "errorBars": "sd"
  },
  "url": "https://app.nubint.ai/figure/5b0f7a3e..."
}
imageUrl

차트 PNG(300 dpi).

summary

실제로 그린 값 — 읽은 줄, 그린 줄, 뺀 줄 수와 계열별 n · 평균 · 표준편차. 숫자를 말할 때는 이 값을 인용하세요.

creditsCharged

이 요청에 청구된 크레딧. 그릴 수 없는 표(열이 없거나 숫자가 없음)는 차감하지 않고 400을 돌려줍니다.

누빈트 에비던스

논문 검색

POST/developer/search/papers

연구 질문이나 키워드로 학술 색인(OpenAlex · KCI)을 검색합니다. 크레딧이 들지 않고 결과가 바로 돌아옵니다.

요청

querystring

연구 질문 또는 키워드. 어느 언어든 됩니다.

limitinteger

돌려받을 편수. 기본 10, 최대 30.

yearFrom · yearTointeger

출판 연도의 범위. 한쪽만 줘도 됩니다.

minCitations · openAccessOnly · excludeRetracted

최소 인용 수, 오픈 액세스만, 철회된 논문 제외. 준 조건만 걸립니다.

sortstring

정렬 — relevance(기본) · cited · recent · oldest.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/search/papers \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "sleep restriction and insulin sensitivity", "limit": 3 }'

응답

200 OK
{
  "papers": [
    {
      "id": "https://doi.org/10.1016/s0140-6736(99)01376-8",
      "title": "Impact of sleep debt on metabolic and ...",
      "year": 1999,
      "venue": "The Lancet"
    },
    ...
  ]
}
papers[].id

논문 식별자. 라이브러리에 저장할 때 그대로 씁니다.

papers[].supportingPassage

원문이 색인돼 있으면 질의와 맞는 문단이 함께 옵니다.

note

결과가 없을 때 붙는 안내. 질의에 검색할 주제가 없어도 빈 결과가 나옵니다.

누빈트 에비던스

문헌 조사

POST/developer/evidence/literature-review

연구 질문으로 문헌 조사를 씁니다. 색인을 검색해 핵심 논문을 고르고, 인용 번호가 참고문헌과 맞물리는 리뷰를 마크다운으로 돌려줍니다. 작업으로 돌고 몇 분 걸립니다.

요청

questionstring

연구 질문 또는 주제.

depthstring

깊이 — fast(기본) · balanced · comprehensive. 깊을수록 인용하는 편수와 시간, 크레딧이 늘어납니다.

languagestring

결과를 쓸 언어 — ko · en · ja · zh-CN(간체) · zh-TW(번체). 비우면 영어입니다.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/evidence/literature-review \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Does sleep restriction impair glucose metabolism in healthy adults?",
    "depth": "fast",
    "language": "en"
  }'

응답

{
  "taskId": "9f2c41d0...",
  "threadId": "0199c2e4...",
  "status": "running"
}
threadId

이 문헌 조사의 손잡이. 작업 조회에 taskId 대신 넘기면 24시간이 지난 뒤에도 결과를 다시 읽습니다.

url

누빈트에서 결과를 여는 주소.

result

작업 조회의 결과 — 리뷰 본문과 references(본문의 [n]과 같은 순서).

누빈트 에비던스

체계적 문헌고찰 · 데이터 추출

출시 준비 중

체계적 문헌고찰(프로토콜 제안, 스크리닝, 종합 리포트)과 데이터 추출은 출시 준비 중입니다. 지금은 API와 MCP 어느 쪽으로도 쓸 수 없고, 해당 경로를 부르면 403을 돌려줍니다.

지금 쓸 수 있는 것은 논문 검색과 문헌 조사입니다. 출시되면 요청과 응답 형식을 이 문서에 싣겠습니다.

공통

작업 조회

POST/developer/tasks/get

작업을 시작하는 경로는 taskId를 바로 돌려줍니다. 결과는 이 경로에 taskId를 보내 읽습니다. 15초에서 30초 간격으로 조회하고, 느리다고 같은 작업을 다시 시작하지 마세요 — 시작할 때마다 새로 과금됩니다.

요청

taskIdstring

시작 응답의 taskId. 24시간 동안 쓸 수 있습니다.

threadIdstring

taskId 대신 넘기면 지난 작업의 최신 결과를 언제든 다시 읽습니다.

cURL
curl -X POST https://api.nubint.ai/api/v1/developer/tasks/get \
  -H "X-API-Key: $NUBINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "9f2c41d0..." }'

응답

200 OK
{
  "status": "completed",
  "result": {
    "imageUrl": "https://.../figure.png",
    "mimeType": "image/png"
  },
  "projectId": "5b0f7a3e...",
  "url": "https://app.nubint.ai/figure/5b0f7a3e..."
}
status

running · completed · failed · cancelled.

result

completed일 때의 결과. 모양은 작업마다 다릅니다(위 각 절).

error

failed일 때의 사유.

url

누빈트에서 결과를 여는 주소.

작업을 시작하는 요청과 차트 · 원고 저장에는 idempotencyKey를 넣을 수 있습니다. 요청마다 직접 정한 값을 넣고, 응답을 못 받아 다시 보낼 때 같은 값을 쓰세요 — 새로 시작하지 않고 처음 응답을 그대로 돌려주며(replayed: true) 크레딧도 한 번만 나갑니다. 24시간 동안 기억합니다.

요금

AI 작성 감지는 1만 토큰당 88크레딧, 출처 품질은 1만 토큰당 66크레딧입니다. 본문 분량은 영문 A4 5장 단위로 올림하며, 그 한 단위가 최소 과금입니다. 에디터의 AI 검토와 같은 단가입니다.

참고문헌 확인은 크레딧이 들지 않습니다. 우리 쪽 장애로 실패한 섹션(failed), 입력이 없어 건너뛴 섹션(skipped), 판정할 산문이 부족한 AI 감지(inconclusive)는 차감하지 않습니다.

실행 전에 예상 비용을 확인해, 잔액이 모자라면 실행하지 않고 402를 돌려줍니다.

오류

오류 응답 본문은 detail 필드 하나를 가진 JSON입니다.

401 Unauthorized
{ "detail": "Invalid API key" }
400

한도 초과 — 참고문헌 100건 또는 본문 200,000자를 넘었습니다. 잘라서 처리하지 않습니다.

401

X-API-Key 헤더가 없거나, 키가 잘못되었거나, 폐기된 키입니다.

402

크레딧이 부족합니다 — 잔액이 0이거나 이 요청의 예상 비용을 감당하지 못합니다. 검사는 실행되지 않았습니다.

403

Starter·Pro·Max 요금제가 필요합니다 — 무료 요금제 계정의 키로 부르면 모든 경로가 이 응답을 돌려줍니다.

422

요청 본문 형식이 맞지 않습니다(필드 이름 · 타입).

429

요청 한도를 넘었습니다. 1분 뒤 다시 시도하세요.

502

AI 작성 감지 서비스가 응답하지 않았습니다(/developer/review/ai-detection). 잠시 후 다시 시도하세요.

503

인증 확인이 일시적으로 불가능합니다. 키 문제가 아니니 폐기하지 말고 다시 시도하세요.

한도와 응답 시간

참고문헌은 요청당 100건, 본문은 200,000자(영문 A4 약 80쪽)까지입니다.

응답이 동기식이라 참고문헌이 많으면 수십 초가 걸릴 수 있습니다. 클라이언트 타임아웃을 120초 이상으로 두세요.

요청 한도는 계정당 참고문헌 확인 분당 30회, AI 작성 감지와 원고 전체 점검 분당 10회입니다. 넘으면 429를 받습니다.

전체 엔드포인트

MCP 도구는 전부 REST로도 부를 수 있습니다. 경로는 /developer/ 뒤에 묶음과 기능 이름이 붙고(예: /developer/evidence/literature-review), POST 본문에 MCP 도구와 같은 인자를 JSON으로 보내면 같은 결과가 돌아옵니다. 플랜, 요청 한도, 크레딧도 같습니다.

“작업”으로 표시된 경로는 몇 분 걸리는 일을 시작하고 taskId를 바로 돌려줍니다. 결과는 /developer/tasks/get 에 taskId를 보내 읽습니다. 15초에서 30초 간격으로 조회하세요.

POST /developer/search/papers즉시

search_papers

POST /developer/search/library즉시

search_library

POST /developer/search/save-to-library즉시

save_to_library

POST /developer/review/manuscript-check즉시

run_manuscript_check

POST /developer/review/reference-verification즉시

run_manuscript_check

POST /developer/review/ai-detection즉시

run_manuscript_check

POST /developer/review/manuscript즉시

save_manuscript

POST /developer/review/documents즉시

list_documents

POST /developer/review/document/read즉시

read_document

POST /developer/review/document/edit즉시

edit_document

POST /developer/review/start작업

start_review

POST /developer/evidence/literature-review작업

start_literature_review

POST /developer/evidence/systematic-review출시 준비 중

start_systematic_review

POST /developer/evidence/screened-papers출시 준비 중

list_screened_papers

POST /developer/evidence/screening출시 준비 중

update_screening

POST /developer/evidence/systematic-review-report출시 준비 중

start_systematic_review_report

POST /developer/evidence/extract-data출시 준비 중

start_extract_data

POST /developer/evidence/export출시 준비 중

export_evidence

POST /developer/figure/project즉시

open_figure_project

POST /developer/figure/file즉시

upload_figure_file

POST /developer/figure/start작업

start_figure

POST /developer/figure/plot즉시

create_figure_plot

POST /developer/tasks/get즉시

get_task

POST /developer/tasks/list즉시

list_tasks

POST /developer/credits/get즉시

get_credits

MCP

MCP 서버는 원고 점검(run_manuscript_check — 참고문헌 실존 확인과 AI 작성 감지는 checks로 하나씩 돌립니다)에 더해 논문 검색, 원고 검토 7종, 누빈트 문서 목록·읽기와 수정 제안(edit_document — 제안은 누빈트 에디터에 뜨고 사용자가 수락하거나 거절합니다), 문헌 조사, 그림 도구를 제공합니다. 모든 도구는 Starter 요금제부터 동작합니다. 체계적 문헌고찰과 데이터 추출은 출시 준비 중입니다. ChatGPT·Claude는 로그인(OAuth)으로 연결하고 API 키가 필요 없습니다 — MCP 연결 안내를 보세요.

MCP 연결 방법

도구 목록

서버가 지금 내놓는 도구입니다. start_ 로 시작하는 도구는 몇 분 걸리는 작업을 시작하고 바로 돌아오며, 결과는 get_task 로 읽습니다.

search_papers즉시

AI 논문 검색

search_library즉시

AI 논문 검색

save_to_library즉시

AI 논문 검색

run_manuscript_check즉시

AI 논문 검토

save_manuscript즉시

AI 논문 검토

list_documents즉시

AI 논문 검토

read_document즉시

AI 논문 검토

edit_document즉시

AI 논문 검토

start_review작업

AI 논문 검토

start_literature_review작업

누빈트 에비던스

open_figure_project즉시

누빈트 피규어

upload_figure_file즉시

누빈트 피규어

start_figure작업

누빈트 피규어

create_figure_plot즉시

누빈트 피규어

get_task즉시

공통

list_tasks즉시

공통

get_credits즉시

공통

개발 도구에서 API 키로 연결

헤더를 설정할 수 있는 개발 도구는 X-API-Key 로 연결할 수 있습니다. 서버 주소는 같습니다.

터미널에서 한 줄로 추가합니다. 추가한 뒤 /mcp 로 연결 상태를 확인할 수 있습니다.

Claude Code
claude mcp add --transport http nubint https://api.nubint.ai/api/v1/mcp \
  --header "X-API-Key: nbk_live_..."