구독 정보 조회

SDK

수동 HTTP 호출보다 안전하고 빠른 통합을 위해 SDK를 사용하세요.

인증된 사용자의 현재 구독 정보를 조회합니다. 구독 중인 플랜명, 크레딧 사용량, 동시 호출 제한, 커스텀 보이스 슬롯 보유 현황을 포함합니다.

TTS 요청 전 남은 크레딧이나 현재 플랜을 확인하거나, POST /v1/voices/clone 으로 새 커스텀 보이스를 만들기 전 사용 가능한 슬롯 수를 확인하는 데 사용하세요. limits.custom_voice_slot 값은 현재 플랜이 동시에 보유할 수 있는 커스텀 보이스 최대 개수이며, 슬롯이 가득 찼다면 DELETE /v1/voices/{voice_id} 로 비워주세요.

GET/v1/users/me/subscription

cURL

curl --request GET \
+  --url https://api.typecast.ai/v1/users/me/subscription \
+  --header 'X-API-KEY: <api-key>'

{
  "plan": "lite",
  "limits": {
    "concurrency_limit": 5,
    "custom_voice_slot": 10
  },
  "credits": {
    "plan_credits": 200000,
    "used_credits": 157300
  }
}

인증

X-API-KEYstringheader필수

인증을 위한 API 키입니다. Typecast API 콘솔에서 API 키를 발급받을 수 있습니다.

응답

200Successful Responseapplication/json

planfree | lite | plus | custom

현재 구독 플랜명

freelitepluscustom

limitsobject

사용 제한 정보

Show nested model

concurrency_limitintegerrequired

허용되는 최대 동시 요청 수

custom_voice_slotinteger

전체 커스텀 보이스 슬롯 한도 (professional 포함)

professional_voice_slotinteger

프리미엄 클로닝 보이스 슬롯 한도

creditsobject

크레딧 사용 정보

Show nested model

plan_creditsintegerrequired

플랜에서 기본으로 제공하는 총 크레딧

used_creditsintegerrequired

사용된 크레딧 수

professional_clone_generationsobject

프리미엄 클로닝 학습 횟수 정보

Show nested model

plan_generationsinteger

플랜 제공 학습 횟수

used_generationsinteger

사용된 학습 횟수

cURL

curl --request GET \
+  --url https://api.typecast.ai/v1/users/me/subscription \
+  --header 'X-API-KEY: <api-key>'

{
  "plan": "lite",
  "limits": {
    "concurrency_limit": 5,
    "custom_voice_slot": 10
  },
  "credits": {
    "plan_credits": 200000,
    "used_credits": 157300
  }
}