Wan API 문서Wan API 잔액 조회 엔드포인트
GET /v1/balance로 Wan API 계정 잔액과 키의 남은 한도를 확인합니다. 모든 모델에서 사용할 수 있습니다.
이 엔드포인트는 모든 모델에서 사용할 수 있습니다. https://api.wanapi.app에 키를 Authorization: Bearer YOUR_API_KEY로 보내세요. 키를 소유한 계정의 잔액을 반환하며 데이터를 변경하지 않습니다.
GET /v1/balance는 키 계정에서 사용할 수 있는 잔액을 반환합니다. 읽기 전용입니다.
curl https://api.wanapi.app/v1/balance \
-H "Authorization: Bearer $WAN_API_KEY"{
"object": "balance",
"currency": "USD",
"balance": 12.5,
"key_remaining": null
}| 필드 | 의미 |
|---|---|
object | 항상 balance입니다. |
currency | 항상 USD입니다. |
balance | 계정에서 사용할 수 있는 잔액(USD)입니다. Playground와 계정의 모든 API 키가 함께 사용합니다. |
key_remaining | 이 키의 남은 한도(USD)이며, 한도가 없는 키는 null입니다. 키는 두 금액 중 어느 것도 넘겨 사용할 수 없습니다. |
오류
| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | — | API 키가 없거나, 유효하지 않거나, 비활성화되었거나 만료되었습니다. |
| 503 | balance_unavailable | 잠시 후 다시 시도하세요. |