Leyve Docs

다크모드

AI 크레딧·원가 계량 백엔드 계약 ​

Prototype은 useAiCredits로 상품·예산·경고 UX를 검증한다. 운영 청구 원장은 반드시 서버 권위 데이터로 교체한다.

2026-08-11 정합 — 선결제 잔액과의 관계 본 문서의 월 정액 플랜 크레딧은 billing-prepaid-balance.md의 선결제 잔액과 충돌하지 않고 층으로 쌓인다. 플랜 포함 크레딧은 funding_lots(kind=GRANT, reason=plan_allowance, expires_at=해당 월 말일)로 표현되고, 소진되면 funding_lots(kind=PAID)(선결제 잔액)를 차감하며, 그것마저 없으면 차단한다. 선결제 잔액의 소진 순서(GRANT 먼저, 만료 임박 순)가 그대로 적용되므로 별도 규칙이 필요 없다. 미확정: 플랜 포함 크레딧 잔량의 월말 이월 여부. expires_at = 월말로 두면 소멸이다.

원칙 ​

  • 로컬 규칙·Docs·기능 찾기: 0크레딧
  • 외부 AI 호출: Organization 공유 크레딧 차감
  • 저장·발송·확정: AI 응답과 분리하고 사용자 승인 필요
  • 요청 ID를 멱등키로 사용해 재시도 중복 과금 방지
  • 공급자 실패·타임아웃은 환불 이벤트를 append-only로 기록

서버 원장 필드 ​

organization_id, workspace_id, actor_id, request_id, feature, provider, model, input_tokens, output_tokens, provider_cost, credits, status, refund_for, created_at

클라이언트가 보낸 토큰·비용·크레딧은 신뢰하지 않는다. Edge Function이 공급자 응답의 usage를 정규화해 원장에 기록한 뒤 잔여량을 반환한다.

상품 ​

  • Free: 월 100크레딧
  • 기본 상품: 월 300크레딧
  • AI Standard: 월 2,000크레딧
  • AI Pro: 월 8,000크레딧

요금과 크레딧 환산율은 운영 사용량 1~2개월을 수집한 뒤 조정한다. 외부 공급자 원가는 Leyve 상품료와 분리해 내부 손익에서 추적한다.

UI Select 정합 2026-07-19 KST ​

Organization 계정의 상품 선택기를 EDS native Select 공식 anatomy로 정리했다. planKey 값, 변경 이벤트, 상품·원장 API 계약에는 변화가 없다.