개요

분야별 REST API를 제공하는 나두AI API 마켓플레이스입니다(제약 CSO 등 카테고리별 제공). 계정당 API 키를 발급받아 각 API를 호출합니다. API별 상세 스펙은 좌측 API 레퍼런스에서 확인하세요.

시작하기

1. 회원가입 후 로그인합니다.
2. 대시보드 → API 키에서 키(pk_live_…)를 발급합니다. 발급 시 한 번만 표시되니 안전하게 보관하세요.
3. 좌측 API 레퍼런스에서 원하는 API의 엔드포인트·요청·응답을 확인하고 호출합니다.

인증

모든 요청에 API 키를 헤더로 전달합니다. 키가 없거나 무효면 401이 반환됩니다.

x-api-key: pk_live_xxxxxxxxxxxxxxxxxxxxxxxx

과금

• 성공 호출당 API별 단가가 과금됩니다(계정×API별 무료 제공량 소진 후).
• 실패(5xx) 호출은 과금되지 않습니다(자동 환불).
• 무료 제공량을 초과하고 잔액이 부족하면 402가 반환되며, 대시보드의 사용 신청으로 유료 사용을 신청할 수 있습니다.
• 가격은 변경될 수 있으며, 각 호출은 호출 시점 단가로 과금·기록됩니다.

충전 잔액 조회

현재 계정의 선불 충전 잔액을 조회합니다. 특정 API(상품)와 무관한 계정 단위 조회이며 과금되지 않습니다. 인증은 다른 API와 동일하게 x-api-key 헤더를 사용합니다.

응답 (200 OK)

예시 (cURL)

curl https://marketapi.nadoo.ai/api/v1/balance \
  -H "x-api-key: pk_live_xxxxxxxx"

# 응답
{ "balanceKrw": 49800, "lowBalanceThresholdKrw": 5000,
  "updatedAt": "2026-08-06T02:31:00.000Z" }

공통 에러

에러 응답 본문: { "error": "<code>", "message"?: "..." }