개발자 문서

인증

API 키는 파트너 문의 후 발급합니다. 모든 요청은 HTTPS 이며 키는 Authorization 헤더로 보냅니다.

• 키 단위 요율 제한: 분당 60회 · 일 10,000회 (기본, 계약에 따라 상향)
• 키 회전: 새 키 발급 후 7일 동안 구 키 병행 유효
• 출처 표기: 기상산업진흥법에 따라 결과 노출 시 '자료: 웰비안 AI · 케이웨더' 표기 필요

GET /v1/forecast/point?lat=37.5665&lon=126.9780&horizon=60d
Authorization: Bearer <API_KEY>
Accept: application/json

추론 API

지점 · 읍면동 · 1.5km 격자 단위로 예보, 지수, 위험 지수를 돌려줍니다. 갱신 주기는 상품에 따릅니다.

• /v1/forecast/point - 60일(6시간) · 15일(6시간) · 3일(1시간) · 초단기(10분) 예보, horizon 으로 선택
• /v1/index/{life|heat|heating|sales|construction} - 생활 · 폭염 · 난방 · 판매영향 · 작업기상 지수
• /v1/risk/{heat|rain|wind|snow} - 단계(1~4) · 시작/종료 시각 · 근거 변수
• /v1/nowcast/precip - 레이더 강수 2시간(10분) · 12시간(1시간), 1km
• 응답: JSON, 시각은 ISO 8601(KST), 단위는 SI(°C · mm · m/s)

{
  "point": { "lat": 37.5665, "lon": 126.9780, "grid": "1.5km" },
  "issued_at": "2026-09-30T06:00:00+09:00",
  "horizon": "60d",
  "series": [ { "t": "2026-09-30T12:00:00+09:00", "temp": 24.1, "rain_mm": 0.0, "wind_ms": 2.3, "pop": 10 } ],
  "source": ["kweather", "nvidia-earth2/fcn3", "wellbian-sensors"]
}

에이전트 연동

60일 예보 에이전트는 딥링크로 바로 붙일 수 있습니다. 위젯 · 웹훅은 준비 중입니다.

• 딥링크: /agent?q=<질문>&lat=<위도>&lon=<경도>&domain=<golf|hiking|fishing|travel|fashion|air>
• 판정 결과 구조: 판정 헤드라인 → 조건 칩 → 타임라인 → 지표 카드 → 특보 배너 (앱과 동일)
• 알림 웹훅: 조건 변화 시 POST <your_url> (준비 중)
• 채팅 위젯: 스크립트 한 줄 임베드 (준비 중)

https://wellbianai.io/agent?q=%EC%9D%B4%EB%B2%88%20%EC%A3%BC%EB%A7%90%20%EB%B6%81%ED%95%9C%EC%82%B0%20%EB%93%B1%EC%82%B0&lat=37.66&lon=126.98&domain=hiking

이용권 NFT

AI 팩토리 이용권은 XRPL 발행 유틸리티 NFT 로, 콘텐츠 결제 전용입니다. 투자 · 수익 약속이 없습니다.

• 발행: 4,000장 · 유효 3년 · 택슨 4026
• 혜택: 이용권 보유 지갑은 추론 API · 에이전트 콘텐츠를 이용권으로 결제
• 확인: 지갑 서명(XRPL) 으로 보유 여부 검증 후 API 키에 연결
• 구매: wellbian.io/products/ai-factory-pass

데이터 출처 · 품질

결과에는 항상 source 배열이 붙습니다. 실황은 기상청 자료를 재제공하고, 미세먼지 실황은 웰비안 · 케이웨더 자체 측정망 기준입니다.

• kweather - 케이웨더 전문예보관 · 수치예보
• nvidia-earth2/{fcn3|atlas|corrdiff|stormscope} - AI 팩토리 산출물
• wellbian-sensors - 웰비안 측정망(ARC-600DA 등) 실측
• kma - 기상청 관측 · 특보 재제공