콘텐츠로 이동

크레딧 지갑

GET
/api/v1/billing/wallet
curl --request GET \
--url https://dev.api.endueos.com/api/v1/billing/wallet \
--header 'Authorization: Bearer <token>'

내 계정(Default Organization)의 지갑 — endue 허브(Billing API v1) 계좌의 크레딧 잔액을 그대로 비춘다. endue OS 에는 자체 크레딧이 없다 (ENDUE-1322): endue AI 계정의 크레딧(1 크레딧 = US$1)을 그대로 쓰고, OS 가 따로 가입 크레딧을 주지 않는다. 가입 5 크레딧(한 달) · 매주 1 크레딧(무료 플랜, 매주 리셋) 모두 OS 에서도 쓰인다 — OS 사용은 endue AI 실행과 같은 이번 주 사용량부터 쓰고, 그 뒤의 몫만 이 잔액에서 나간다. 이번 주 사용량(매주 1 크레딧)은 이 잔액에 들지 않는다. 충전은 endue 계정 센터에서 한다(purchase_url). 허브를 읽지 못하면 503 WALLET_UNAVAILABLE.

성공.

Media typeapplication/json
object
data
필수

계정당 하나 (프로젝트마다가 아니다). 크레딧이 endue OS 안의 유일한 화폐다. endue OS 에는 자체 크레딧이 없다 (ENDUE-1105 · ENDUE-1322) — 이 지갑은 endue 허브(Billing API v1)의 계좌 잔액(endue AI 계정과 같은 크레딧, 1 크레딧 = US$1)을 그대로 비춘다. OS 는 가입 크레딧을 따로 주지 않는다. 가입 5 크레딧(한 달) · 매주 1 크레딧 모두 OS 에서도 쓰인다 — OS 사용은 이번 주 사용량(매주 1 크레딧, 이 잔액에 들지 않는다)부터 쓰고 그 뒤가 이 잔액에서 나간다. 충전은 endue 계정 센터에서 한다(purchase_url).

object
source

endue — endue 허브 계좌의 크레딧이다. 허브 결제(012) 전의 옛 OS 자체 지갑에는 없었다.

string
허용 값: endue
payer_user_id
Any of:

usr_{Keycloak sub} — ULID 가 아니다.

string
/^usr_.+$/
balance_decimal
string
available_credits
Any of:
string
unposted_estimated_credits
Any of:
string
reserved_credits
string
cost_status
string
balance
필수

잔액 (크레딧). 음수가 될 수 있다 — 그러면 비용을 만드는 동작이 402 INSUFFICIENT_CREDITS 로 막히고 running virtual Device 가 멈춘다.

number format: double
currency
필수
string
허용 값: credit
low_balance
필수

잔액이 100 크레딧 미만이다.

boolean
updated_at
필수
string format: date-time
meta
필수
object
request_id
필수
string
timestamp
필수
string format: date-time
duration

서버 처리 시간(ms).

integer format: int32
예시
{
"data": {
"source": "endue",
"currency": "credit"
}
}

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

이 인증 수단으로는 못 하는 일이다 — FORBIDDEN (예: API 키로 클라우드 기기 만들기). 본문은 오류 봉투.

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.