결제 및 크레딧

API 버전 2026-10-virile-dragon

두 가지 결제 방식

클라이언트는 두 가지 방식 중 하나로 과금되며, 그 방식은 만들 때 고정됩니다. allowance 클라이언트는 소유자의 요금제 사용 한도, 즉 앱과 같은 사용 한도를 소모하며, 카드에 요금을 청구하지 않습니다. metered 클라이언트는 사용 한도를 소모하지 않습니다. 대신 호출할 때마다 크레딧이 들고, 그 요금은 사용량 기반 과금 구독에 등록된 카드로 청구됩니다. 앱이 인가 코드로 받은 토큰을 사용해 다른 사용자를 대신해 하는 호출은 클라이언트의 방식과 관계없이 항상 그 사용자의 사용 한도를 소모합니다.

호출당 크레딧

metered 클라이언트의 호출 한 번에는 그 스코프에 매겨진 만큼의 크레딧이 들며, 아래 표에 나와 있습니다. 0크레딧인 스코프는 비용이 들지 않습니다. GET /v1/usage가 보고하는 units는 이 가중치로 크레딧으로 환산됩니다. 호출은 클라이언트가 어느 버전에 고정되어 있든, 호출한 날에 적용되는 가중치로 과금됩니다. 이전 버전 레퍼런스의 표는 그 버전이 게시될 때의 가중치를 기록한 것이지, 오늘 호출 한 번의 비용이 아닙니다.

스코프
`vocab:generate`	어휘 목록을 생성합니다.	어휘 목록 생성
`lesson_plans:read`	내 수업 계획을 읽고 진행 상황에 다시 연결합니다.	수업 계획 가져오기 수업 계획에 다시 연결
`lesson_plans:write`	수업 계획을 만듭니다.	수업 계획 만들기
`tutor:converse`	튜터와 대화합니다. 유료 요금제가 필요합니다.	튜터에게 한 턴 보내기
`usage:read`	남은 사용 한도 또는 `metered` 클라이언트의 이번 달 사용량을 확인합니다.	남은 사용 한도 가져오기
`events:read`	내 계정에 관한 이벤트를 읽고, 이벤트를 받을 엔드포인트를 등록합니다.	이벤트 목록 이벤트 스트리밍
`events:write`	게임이나 연동에서 Lingara로 이벤트를 보냅니다.	이벤트 보내기
`embed:mint`	게임이나 사이트의 플레이어를 위한 단기 토큰을 발급하고 플레이어를 삭제합니다. 사용량 기반 과금 클라이언트 전용입니다.	플레이어용 토큰 발급 플레이어 삭제 플레이어와 Lingara 계정의 연결 해제
`embed:play`	플레이어를 대신해 행동합니다: 연습 결과를 보내고 NPC 대화를 진행합니다.	플레이어를 Lingara 계정에 연결 NPC에게 대사 보내기

가격

1크레딧의 가격은 US$0.004입니다. 사용량은 매월 1일(UTC)에 시작하는 각 달력 월 단위로, 사용량 기반 과금 구독에 등록된 카드로 매월 청구됩니다.

지출 한도

계정에는 크레딧 단위의 월 한도가 있고, 각 metered 클라이언트는 그보다 낮은 자체 한도를 가질 수 있습니다. 둘 다 연동 페이지에서 설정하세요. 클라이언트 또는 계정이 한도에 도달하면, 다음 달이 시작되거나 한도가 올라갈 때까지 클라이언트의 호출이 402와 코드 spend_cap_reached로 거부됩니다.

사용량 기반 과금이 활성화되지 않았을 때

사용량 기반 과금이 활성화되지 않은 동안, 즉 설정하기 전, 결제가 연체된 동안, 해지한 후에는 metered 클라이언트의 호출이 402와 코드 metered_billing_inactive로 거부됩니다. 사용량 기반 과금은 연동 페이지(app.getlingara.com/admin)에서 설정, 관리, 해지할 수 있습니다. 관리하면 Stripe의 결제 포털이 열리며, 그곳에서 카드를 변경하고 청구서를 볼 수 있습니다.

번역본과 영어 참조 문서의 내용이 다른 경우, 영어 참조 문서가 올바른 것으로 봅니다.