사용자 가져오기

GET

/v1/user

GET

/v1/user

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

{
  "user_id": "1234567890",
  "subscription": {
    "tier": "trial",
    "character_count": 17231,
    "character_limit": 100000,
    "max_character_limit_extension": 10000,
    "max_credit_limit_extension": 10000,
    "can_extend_character_limit": false,
    "allowed_to_extend_character_limit": false,
    "voice_slots_used": 1,
    "professional_voice_slots_used": 0,
    "professional_voice_slots_used_in_workspace": 0,
    "voice_limit": 120,
    "voice_add_edit_counter": 212,
    "professional_voice_limit": 1,
    "can_extend_voice_limit": false,
    "can_use_instant_voice_cloning": true,
    "can_use_professional_voice_cloning": true,
    "current_overage": {
      "amount": "0",
      "currency": "usd"
    },
    "status": "free",
    "next_character_count_reset_unix": 1738356858,
    "max_voice_add_edits": 230,
    "currency": "usd",
    "billing_period": "monthly_period",
    "character_refresh_period": "monthly_period"
  },
  "is_onboarding_completed": true,
  "is_onboarding_checklist_completed": true,
  "created_at": 1753999199,
  "seat_type": "workspace_member",
  "is_new_user": false,
  "can_use_delayed_payment_methods": false,
  "show_compliance_terms": false,
  "first_name": "John",
  "is_api_key_hashed": false
}

사용자 정보를 가져옵니다.

응답

성공 응답

user_idstring

사용자의 고유 식별자입니다.

subscriptionobject

사용자 구독의 세부 정보입니다.

is_onboarding_completedboolean

사용자의 온보딩이 완료되었는지 여부입니다.

is_onboarding_checklist_completedboolean

사용자의 온보딩 체크리스트가 완료되었는지 여부입니다.

created_atinteger

사용자 생성의 Unix 타임스탬프입니다. Unix 타임스탬프가 추가되기 전에 사용자가 생성된 경우 0입니다.

seat_typeenum

사용자의 시트 유형입니다.

허용된 값:

is_new_userbooleanDeprecated

사용자가 신규 사용자인지 여부입니다. 이 필드는 더 이상 사용되지 않으며 향후 제거됩니다. 대신 ‘created_at’을 사용하세요.

can_use_delayed_payment_methodsbooleanDeprecated

이 필드는 더 이상 사용되지 않으며 향후 주요 버전에서 제거됩니다. 대신 subscription.trust_on_invoice_creation을 사용하세요.

show_compliance_termsboolean선택 사항기본값 false

온보딩 중 준수 약관(서비스 약관, 개인정보 처리방침, 생체 정보 동의)을 표시할지 여부입니다. 마케팅 사이트에서 가입하는 사용자에게 설정합니다.

first_namestring or null선택 사항

사용자의 이름입니다.

is_api_key_hashedboolean선택 사항기본값 false

사용자의 API 키가 해시되었는지 여부입니다.

xi_api_key_previewstring or null선택 사항

사용자 API 키의 미리보기입니다.

referral_link_codestring or null선택 사항

사용자의 추천 링크 코드입니다.

partnerstack_partner_default_linkstring or null선택 사항

사용자의 Partnerstack 파트너 기본 링크입니다.

오류

422

Unprocessable Entity Error

헤더

응답

오류