> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 구독 정보 조회

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

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



## OpenAPI

````yaml /ko/api-reference/openapi.json get /v1/users/me/subscription
openapi: 3.1.0
info:
  title: Typecast API
  version: 0.1.2
  x-logo:
    url: https://typecast.ai/_ipx/_/image/logo/tc_logo.webp
servers:
  - url: https://api.typecast.ai
    description: 프로덕션 서버
security:
  - ApiKeyAuth: []
paths:
  /v1/users/me/subscription:
    get:
      tags:
        - Subscription
      summary: 구독 정보 조회
      description: >-
        인증된 사용자의 현재 구독 정보를 조회합니다. 구독 중인 플랜명, 크레딧 사용량, 동시 호출 제한, 커스텀 보이스 슬롯 보유
        현황을 포함합니다.


        TTS 요청 전 남은 크레딧이나 현재 플랜을 확인하거나, `POST /v1/voices/clone` 으로 새 커스텀 보이스를
        만들기 전 사용 가능한 슬롯 수를 확인하는 데 사용하세요. `limits.custom_voice_slot` 값은 현재 플랜이
        동시에 보유할 수 있는 커스텀 보이스 최대 개수이며, 슬롯이 가득 찼다면 `DELETE /v1/voices/{voice_id}`
        로 비워주세요.
      operationId: get_my_subscription_v1_users_me_subscription_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubscriptionResponse'
              example:
                plan: lite
                credits:
                  plan_credits: 200000
                  used_credits: 157300
                limits:
                  concurrency_limit: 5
                  custom_voice_slot: 10
        '401':
          description: Unauthorized - Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Invalid API key
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: Too many requests
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                detail: An unexpected error occurred
components:
  schemas:
    SubscriptionResponse:
      type: object
      properties:
        plan:
          $ref: '#/components/schemas/PlanTier'
          description: 현재 구독 플랜명
        credits:
          $ref: '#/components/schemas/Credits'
          description: 크레딧 사용 정보
        limits:
          $ref: '#/components/schemas/Limits'
          description: 사용 제한 정보
      required:
        - plan
        - credits
        - limits
      title: SubscriptionResponse
      description: 구독 정보 응답 모델
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: 문제를 설명하는 오류 메시지
      required:
        - detail
      example:
        detail: An error occurred processing the request
    PlanTier:
      type: string
      enum:
        - free
        - lite
        - plus
        - custom
      title: PlanTier
      description: |-
        API 플랜.

        사용 가능한 값:
        - **free**: 제한된 크레딧의 무료 등급
        - **lite**: 중간 수준 크레딧의 라이트 플랜
        - **plus**: 높은 크레딧의 플러스 플랜
        - **custom**: 커스텀 엔터프라이즈 플랜
    Credits:
      type: object
      properties:
        plan_credits:
          type: integer
          title: Plan Credits
          description: 플랜에서 기본으로 제공하는 총 크레딧
        used_credits:
          type: integer
          title: Used Credits
          description: 사용된 크레딧 수
      required:
        - plan_credits
        - used_credits
      title: Credits
      description: 크레딧 사용 정보
    Limits:
      type: object
      properties:
        concurrency_limit:
          type: integer
          title: Concurrency Limit
          description: 허용되는 최대 동시 요청 수
        custom_voice_slot:
          type: integer
          minimum: 0
          title: Custom Voice Slot
          description: 퀵클로닝 슬롯 한도
          default: 0
      required:
        - concurrency_limit
      title: Limits
      description: 사용 제한 정보
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: 인증을 위한 API 키. 타입캐스트 API 콘솔에서 API 키를 생성할 수 있습니다.

````