메인 콘텐츠로 건너뛰기

엔드포인트

GET /v1/credits

개요

현재 테넌트의 크레딧 잔액을 조회합니다. 키 타입에 관계없이 사용할 수 있는 공통 엔드포인트입니다.

요청

curl https://api.ones1ght.com/v1/credits \
  -H "Authorization: Bearer $API_KEY"

응답

{
  "success": true,
  "data": {
    "balance": 150.00
  }
}
필드설명
balance사용 가능한 크레딧 잔액 (USD)

채팅 응답의 크레딧 정보

POST /v1/chat/{persona_id} 응답에도 크레딧 정보가 포함됩니다:
{
  "success": true,
  "data": {
    "thread_id": "thr_xxx",
    "assistant_message": { ... },
    "credits": {
      "used": 289,
      "balance": 149.50
    }
  }
}
필드설명
credits.used이번 요청에서 사용된 토큰 수
credits.balance요청 후 남은 크레딧 잔액 (USD)
크레딧이 소진되면 채팅 API 호출 시 402 Payment Required가 반환됩니다.