⚡ PowerPin 개발자·파트너 API

기상청보다 정확한
발전량 예측, 이제 API로

PowerPin은 태양광·풍력 발전량을 기상청보다 정확하게 예측해 재생에너지 사업자의 수익을 키우는 서비스예요.

이 API로 그 예측을 내 시스템에 바로 연동하세요 — 시간별 발전량부터 SMP+REC 수익·KPX 예측오차율·ESS 차익까지 한 번의 호출로 받아가요.

46%

기상청 모델보다 덜 틀려요

6곳

전국 지점 검증 · 총 1,343시간

18.4%

평균 오차 (기상청 34.3%)

왜 PowerPin API인가요?

① 기상청보다 정확

여러 나라 기상모델·위성을 AI가 합치고, 발전소 위치의 실측으로 예보 치우침을 보정해요. 정확도는 백테스트로 공개해요.

② 한 번의 호출로 수익까지

발전량뿐 아니라 KPX 예측오차율, SMP+REC 예상 매출, 계약시장 입찰가, ESS 차익을 같은 키로 받아요.

③ 5분이면 연동

SDK 설치 없이 HTTP만 있으면 돼요. 키를 헤더에 넣고 호출 한 줄이면 끝. 실측을 올리면 그 발전소에 맞게 더 정확해져요.

호출 한 줄이면 돼요

키를 Authorization: Bearer 또는 X-API-Key 헤더에 넣고 호출하세요.

# 내일 발전량 예측 가져오기

curl -H "X-API-Key: pp_live_..." \
  https://powerpin.ai/api/v1/plants/12/forecast

# 응답 (요약)

{
  "points": [
    { "hour_kst": "13:00",
      "p50_kw": 410.2, "p10_kw": 360.1, "p90_kw": 455.8 }, ...
  ],
  "day": { "expected_mwh": 2.73 },
  "learning": { "active": true, "improvement_pct": 12.4 }
}

GET/api/v1/me

키가 잘 되는지 확인해요. 내 계정과 자산 개수를 줘요.

GET/api/v1/plants

이 키로 볼 수 있는 자산(발전소·ESS) 목록. 여기서 각 자산의 id를 확인해요.

GET/api/v1/plants/{id}/forecast

시간별 발전량 예측(P10·P50·P90) + 하루 합계 + 출력제어 위험. 발전 자산 전용(ESS는 400).

GET/api/v1/plants/{id}/error-rate

KPX 예측오차율(전국 예측제도, 직전 3개월). 실측이 쌓일수록 채워져요.

GET/api/v1/plants/{id}/revenue

SMP+REC 예상 매출 · 채널(현물·고정가격계약·한국형FIT) 비교·추천.

GET/api/v1/plants/{id}/contract-bid

2027 계약시장 입찰가 추천(낙찰확률×수익 기대값 최대).

GET/api/v1/plants/{id}/ess

ESS 충방전 스케줄·차익·SOC·계약시장. ESS 자산 전용(발전 자산은 400).

POST/api/v1/plants/{id}/actuals

실측 발전량 업로드 → 자가학습으로 그 발전소 예측이 더 정확해져요.

📖 API 레퍼런스 — 파라미터·응답·직접 호출 키만 넣으면 브라우저에서 바로 호출해볼 수 있어요.

{id}가 뭐예요? 발전소·ESS 자산마다 자동으로 매겨지는 고유 번호예요(자산별로 달라요). 먼저 GET /api/v1/plants를 부르면 내 자산 목록과 각 자산의 id가 나와요. 그 번호를 {id} 자리에 넣어 호출하세요. 예: /api/v1/plants/12/forecast

시작하기 — 3단계

1. 키 발급

가입 후 설정 → 개발자 API에서 ‘키 발급’을 누르면 pp_live_… 키가 나와요. 발급할 때 딱 한 번만 보여요.

2. 인증

요청 헤더에 키를 넣어요 — Authorization: Bearer <키> 또는 X-API-Key: <키> 둘 다 돼요.

3. 호출

SDK 설치 없이 HTTP만 있으면 끝. 실측을 올리면 그 발전소에 맞게 예측이 더 정확해져요.

# 1) 키 확인 2) 내 자산 목록(여기서 id 확인) 3) 특정 자산 예측 4) 실측 올리기

curl -H "X-API-Key: $POWERPIN_KEY" https://powerpin.ai/api/v1/me
curl -H "X-API-Key: $POWERPIN_KEY" https://powerpin.ai/api/v1/plants
curl -H "X-API-Key: $POWERPIN_KEY" "https://powerpin.ai/api/v1/plants/12/forecast?horizon=day_ahead"
curl -X POST -H "X-API-Key: $POWERPIN_KEY" -H "Content-Type: application/json" \
  -d '{"items":[{"ts":"2026-06-06T13:00","kw":820.5}]}' https://powerpin.ai/api/v1/plants/12/actuals

인증이 안 되면 401을 줘요. 헤더와 키를 확인하세요.
자산 종류에 맞는 엔드포인트를 쓰세요 — 발전(태양광·풍력)은 /forecast, 배터리는 /ess. 잘못 쓰면 400으로 안내해요.
수익·입찰가·정산 수치는 가정값을 포함한 추정이에요. 실제 제도값과 다를 수 있어요.
예측은 1시간 동안 캐시돼요. 같은 자산을 자주 불러도 부담이 적어요.
베타 기간이라 요청 한도·세부 응답은 바뀔 수 있어요. 바뀌면 미리 알려드려요.

누구를 위한 API인가요?

전력중개사업자 · VPP

회원 발전소 수백 곳의 예측·예측오차율을 한 번에 받아 자동 제출·정산에 연결해요.

EPC · O&M · 연동 솔루션

기존 모니터링/관제 화면에 '내일 발전량'과 수익 추정을 그대로 얹어요.

개별 발전소 사업자

내 발전소 예측을 스프레드시트·자체 시스템으로 자동으로 끌어가요.

자주 묻는 질문

정말 기상청보다 정확한가요?

2026년 5월 18일~2026년 6월 3일 (약 16일간) 서울·인천·대관령(강원)·포항(경북)·부산(경남)·제주(고산) 전국 6개 지점에서 총 1,343시간의 실제 날씨로 백테스트했어요. 평균 오차(nMAE)가 18.4%로, 기상청 모델(KIM) 34.3%보다 약 46% 덜 틀렸어요. 검증 방법과 지점별 성적은 문서와 'AI 예측 기술'에서 공개해요.

어떻게 인증하나요?

발급받은 키를 요청 헤더에 넣어요 — 'Authorization: Bearer <키>'(표준) 또는 'X-API-Key: <키>' 둘 다 돼요. SDK 설치 없이 HTTP만 있으면 끝이에요.

요금은 어떻게 되나요?

베타 기간 동안 가입 후 키를 만들어 바로 써볼 수 있어요. 신용카드 없이 3초면 가입돼요.

어떤 데이터를 쓰나요?

기상청 KIM·위성(천리안2A)·여러 나라 기상모델을 AI가 합치고, 발전소 위치의 실측으로 치우침을 보정해요.

지금 키 하나로 시작하세요

가입하고 설정 → 개발자 API에서 키를 만들면 바로 호출할 수 있어요.

API 키 발급하러 가기

기상청보다 정확한발전량 예측, 이제 API로