Obtenir l'abonnement utilisateur

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
}

Récupère des informations détaillées sur l’abonnement de l’utilisateur.

Réponse

Réponse réussie

tierstring

Le niveau de l’abonnement de l’utilisateur.

character_countinteger

Le nombre de caractères utilisés par l’utilisateur.

character_limitinteger

Le nombre maximal de caractères autorisés pendant la période de facturation actuelle.

max_character_limit_extensioninteger or null

Obsolète : utilisez max_credit_limit_extension. Nombre maximal de caractères de dépassement de la limite de caractères. Géré par l’administrateur du Workspace.

max_credit_limit_extensioninteger or "unlimited"

Nombre maximal de crédits de dépassement de la limite de crédits. Géré par l’administrateur du Workspace. "unlimited" signifie qu’il n’y a pas de plafond, 0 signifie que la facturation à l’usage est désactivée.

can_extend_character_limitboolean

Indique si le Workspace est autorisé à dépasser les limites d’utilisation, avec facturation à l’usage.

allowed_to_extend_character_limitboolean

Obsolète : utilisez max_credit_limit_extension != 0. Indique si l’utilisateur est autorisé à étendre sa limite de caractères.

voice_slots_usedinteger

Le nombre d’emplacements de voix utilisés par l’utilisateur.

professional_voice_slots_usedinteger

Le nombre d’emplacements de voix professionnelles utilisés. Pour la facturation consolidée, il s’agit du décompte pour l’ensemble du groupe, tous Workspaces confondus ; consultez professional_voice_slots_used_in_workspace pour le Workspace actuel uniquement.

professional_voice_slots_used_in_workspaceinteger

Le nombre d’emplacements de voix professionnelles utilisés dans le Workspace actuel. Pour la facturation consolidée, professional_voice_slots_used comptabilise tous les Workspaces du groupe, tandis que cette valeur ne comptabilise que le Workspace actuel.

voice_limitinteger

Le nombre maximal d’emplacements de voix autorisés pour l’utilisateur.

voice_add_edit_counterinteger

Le nombre d’ajouts ou de modifications de voix utilisés par l’utilisateur.

professional_voice_limitinteger

Le nombre maximal de voix professionnelles autorisées pour l’utilisateur.

can_extend_voice_limitboolean

Indique si l’utilisateur peut étendre sa limite de voix.

can_use_instant_voice_cloningboolean

Indique si l’utilisateur peut utiliser le clonage instantané de voix.

can_use_professional_voice_cloningboolean

Indique si l’utilisateur peut utiliser le clonage professionnel de voix.

current_overageobject

Coût actuel du dépassement basé sur l’utilisation.

statusenum

L’état de l’abonnement de l’utilisateur.

open_invoiceslist of objects

Les factures ouvertes de l’utilisateur.

has_open_invoicesboolean

Indique si l’utilisateur a des factures impayées.

next_character_count_reset_unixinteger or nullOptionnel

L’horodatage Unix de la prochaine réinitialisation du nombre de caractères.

max_voice_add_editsinteger or nullOptionnel

Le nombre maximal d’ajouts ou de modifications de voix autorisés pour l’utilisateur.

currencyenum or nullOptionnel

Devise de l’abonnement de l’utilisateur.

Valeurs autorisées:

billing_periodenum or nullOptionnel

Période de facturation de l’abonnement de l’utilisateur.

Valeurs autorisées:

character_refresh_periodenum or nullOptionnel

Période de renouvellement des caractères de l’abonnement de l’utilisateur.

Valeurs autorisées:

next_invoiceobject or nullOptionnel

La prochaine facture de l’utilisateur.

pending_changeobject or nullOptionnel

La modification en attente pour l’utilisateur.

has_used_starter_coupon_on_accountbooleanOptionnelPar défaut false

True si un Workspace appartenant au compte d’authentification de cet utilisateur a utilisé le coupon de réduction du premier mois pour Starter.

has_used_creator_coupon_on_accountbooleanOptionnelPar défaut false

True si un Workspace appartenant au compte d’authentification de cet utilisateur a utilisé le coupon de réduction du premier mois pour Creator.

is_eligible_for_starter_promobooleanOptionnelPar défaut false

True si le compte d’authentification de cet utilisateur est éligible à la promotion du premier mois de Starter, selon la même vérification que lors du paiement. L’indicateur de fonctionnalité starter_discount détermine toujours si la promotion est proposée.

Erreurs

422

Unprocessable Entity Error

En-têtes

Réponse

Erreurs