获取用户订阅

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 if this user’s auth account qualifies for the Starter first-month promo, using the same check as checkout. The starter_discount feature flag still decides whether the promo is offered.

错误

422

Unprocessable Entity Error

请求头

响应

错误