사용자 구독 가져오기

GET

/v1/user/subscription

GET

/v1/user/subscription

curl https://api.elevenlabs.io/v1/user/subscription

{
  "tier": "starter",
  "character_count": 1000,
  "character_limit": 10000,
  "max_character_limit_extension": 10000,
  "max_credit_limit_extension": 10000,
  "can_extend_character_limit": true,
  "allowed_to_extend_character_limit": true,
  "voice_slots_used": 1,
  "professional_voice_slots_used": 0,
  "professional_voice_slots_used_in_workspace": 0,
  "voice_limit": 10,
  "voice_add_edit_counter": 0,
  "professional_voice_limit": 1,
  "can_extend_voice_limit": true,
  "can_use_instant_voice_cloning": true,
  "can_use_professional_voice_cloning": true,
  "current_overage": {
    "amount": "0",
    "currency": "usd"
  },
  "status": "active",
  "open_invoices": [
    {
      "amount_due_cents": 1000,
      "discounts": [
        {
          "discount_percent_off": 20
        }
      ],
      "next_payment_attempt_unix": 1738356858,
      "payment_intent_status": "processing",
      "payment_intent_statusses": [
        "processing",
        "succeeded"
      ],
      "subtotal_cents": 900,
      "tax_cents": 100
    }
  ],
  "has_open_invoices": true,
  "next_character_count_reset_unix": 1738356858,
  "currency": "usd",
  "billing_period": "monthly_period",
  "character_refresh_period": "monthly_period",
  "next_invoice": {
    "amount_due_cents": 1000,
    "discounts": [
      {
        "discount_percent_off": 20
      }
    ],
    "next_payment_attempt_unix": 1738356858,
    "payment_intent_status": "processing",
    "payment_intent_statusses": [
      "processing",
      "succeeded"
    ],
    "subtotal_cents": 900,
    "tax_cents": 100
  },
  "has_used_starter_coupon_on_account": false,
  "has_used_creator_coupon_on_account": false,
  "is_eligible_for_starter_promo": false
}

사용자 구독에 대한 확장 정보를 가져옵니다.

응답

성공 응답

tierstring

사용자 구독의 티어입니다.

character_countinteger

사용자가 사용한 문자 수입니다.

character_limitinteger

현재 청구 기간에 허용되는 최대 문자 수입니다.

max_character_limit_extensioninteger or null

지원 중단됨: max_credit_limit_extension을 사용하세요. 문자 한도를 초과할 수 있는 최대 문자 수입니다. 워크스페이스 관리자가 관리합니다.

max_credit_limit_extensioninteger or "unlimited"

크레딧 한도를 초과할 수 있는 최대 크레딧 수입니다. 워크스페이스 관리자가 관리합니다. "unlimited"는 한도가 없음을, 0은 사용량 기반 청구가 비활성화되었음을 의미합니다.

can_extend_character_limitboolean

워크스페이스에 초과 사용량(사용량 기반 청구)을 사용할 권한이 있는지 여부입니다.

allowed_to_extend_character_limitboolean

지원 중단됨: max_credit_limit_extension != 0을 사용하세요. 사용자가 문자 한도를 확장할 수 있는지 여부입니다.

voice_slots_usedinteger

사용자가 사용한 음성 슬롯 수입니다.

professional_voice_slots_usedinteger

사용 중인 프로페셔널 음성 슬롯 수입니다. 통합 청구의 경우 그룹 내 모든 워크스페이스를 포함한 그룹 전체 수입니다. 현재 워크스페이스만 보려면 professional_voice_slots_used_in_workspace를 확인하세요.

professional_voice_slots_used_in_workspaceinteger

현재 워크스페이스에서 사용 중인 프로페셔널 음성 슬롯 수입니다. 통합 청구의 경우 professional_voice_slots_used는 그룹 내 모든 워크스페이스의 수를 계산하지만, 이 값은 현재 워크스페이스만 계산합니다.

voice_limitinteger

사용자에게 허용되는 최대 음성 슬롯 수입니다.

voice_add_edit_counterinteger

사용자가 사용한 음성 추가/편집 횟수입니다.

professional_voice_limitinteger

사용자에게 허용되는 최대 프로페셔널 음성 수입니다.

can_extend_voice_limitboolean

사용자가 음성 한도를 확장할 수 있는지 여부입니다.

can_use_instant_voice_cloningboolean

사용자가 즉시 음성 복제를 사용할 수 있는지 여부입니다.

can_use_professional_voice_cloningboolean

사용자가 프로페셔널 음성 복제를 사용할 수 있는지 여부입니다.

current_overageobject

현재 사용량 기반 초과 사용 비용입니다.

statusenum

사용자의 구독 상태입니다.

open_invoiceslist of objects

사용자의 미결제 인보이스입니다.

has_open_invoicesboolean

사용자에게 미결제 송장이 있는지 여부입니다.

next_character_count_reset_unixinteger or null선택 사항

다음 문자 수 재설정의 Unix 타임스탬프입니다.

max_voice_add_editsinteger or null선택 사항

사용자에게 허용되는 최대 음성 추가/편집 횟수입니다.

currencyenum or null선택 사항

사용자 구독의 통화입니다.

허용된 값:

billing_periodenum or null선택 사항

사용자 구독의 청구 주기입니다.

허용된 값:

character_refresh_periodenum or null선택 사항

사용자 구독의 문자 갱신 주기입니다.

허용된 값:

next_invoiceobject or null선택 사항

사용자의 다음 인보이스입니다.

pending_changeobject or null선택 사항

사용자에 대한 보류 중인 변경 사항입니다.

has_used_starter_coupon_on_accountboolean선택 사항기본값 false

이 사용자의 인증 계정이 소유한 워크스페이스 중 하나라도 스타터 첫 달 할인 쿠폰을 사용했다면 true입니다.

has_used_creator_coupon_on_accountboolean선택 사항기본값 false

이 사용자의 인증 계정이 소유한 워크스페이스 중 하나라도 크리에이터 첫 달 할인 쿠폰을 사용했다면 true입니다.

is_eligible_for_starter_promoboolean선택 사항기본값 false

결제와 동일한 검사를 기준으로 이 사용자의 인증 계정이 스타터 첫 달 프로모션 대상이면 true입니다. 프로모션 제공 여부는 여전히 starter_discount 기능 플래그가 결정합니다.

오류

422

Unprocessable Entity Error

헤더

응답

오류