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

# Offres, utilisation et crédits depuis la CLI

> Parcourez les offres et modules complémentaires, et consultez le statut de votre abonnement, votre utilisation et votre code de parrainage depuis la CLI Social media studio.

Les commandes de facturation vous permettent de parcourir le catalogue public des offres et de consulter votre propre abonnement, votre utilisation et vos crédits de parrainage depuis le terminal.

Cette page présente deux groupes de commandes :

* **`billing:*`** — le catalogue public des offres : offres d'abonnement, matrices de fonctionnalités par offre et références des modules complémentaires. Ces endpoints sont publics et fonctionnent sans authentification.
* **`settings:*`** (liées à la facturation) — le statut de votre abonnement, le détail de votre utilisation et votre code de parrainage. Elles nécessitent une clé d'API valide (voir [Clés d'API](/fr/cli/api-keys.md)).

> [!NOTE]
>
> Chaque commande accepte les options globales `--json` (par défaut), `--table`, `--verbose`, `--api-key <key>` et `--api-url <url>`. Vous pouvez aussi définir `SOME_API_KEY` / `SOME_API_URL` dans l'environnement. Aucune des commandes de facturation ne définit d'options propres.

## settings:billing

Récupère le statut de l'abonnement et les informations sur l'offre — votre offre actuelle, le statut de l'abonnement et les détails de renouvellement.

```bash theme={null}
so-me settings:billing
```

```bash Exemples theme={null}
# Full subscription info
so-me settings:billing

# Just plan name + status
so-me settings:billing | jq '{plan: .plan.name, status: .plan.subscriptionStatus}'

# Compact table
so-me settings:billing --table
```

## settings:usage

Récupère le détail de l'utilisation pour la période de facturation en cours (publications, biolinks, comptes sociaux, stockage de médias, membres de l'équipe et crédits IA texte/image/vidéo).

```bash theme={null}
so-me settings:usage
```

```bash Exemples theme={null}
# JSON
so-me settings:usage

# Posts used vs limit
so-me settings:usage | jq '.tenant.posts'

# AI text/image/video credit usage
so-me settings:usage | jq '{text: .tenant.aiText, image: .tenant.aiImage, video: .tenant.aiVideo}'

# Table
so-me settings:usage --table
```

## settings:referral-code

Récupère votre code de parrainage et les totaux associés (nombre total de parrainages, crédits gagnés).

```bash theme={null}
so-me settings:referral-code
```

```bash Exemples theme={null}
# Full object
so-me settings:referral-code

# Just the code
so-me settings:referral-code | jq -r '.code'

# Share link (combine with your public site)
echo "https://so-me.studio/signup?ref=$(so-me settings:referral-code | jq -r '.code')"
```

## billing:plans

Liste toutes les offres d'abonnement disponibles. Seules les offres visibles qui ne sont pas des modules complémentaires sont renvoyées, triées selon leur ordre d'affichage. Chaque offre porte à la fois ses tarifs mensuel et annuel (`monthlyPrice`, `yearlyPrice`), les ID de variantes Lemon Squeezy correspondants (`monthlyVariantId`, `yearlyVariantId`), son nom d'affichage et sa description.

```bash theme={null}
so-me billing:plans
```

```bash Exemples theme={null}
# All plans as JSON
so-me billing:plans

# Compact table
so-me billing:plans --table

# Name + monthly/yearly price list
so-me billing:plans | jq -r '.[] | "\(.name)\t$\(.monthlyPrice)/mo\t$\(.yearlyPrice)/yr"'

# Just the monthly Lemon Squeezy variant IDs
so-me billing:plans | jq -r '.[] | "\(.name): \(.monthlyVariantId)"'
```

## billing:plan-features

Récupère la liste des fonctionnalités (limites de publications, nombre de places, stockage, crédits IA, etc.) d'une offre donnée. Les fonctionnalités actives sont renvoyées en premier, suivies des fonctionnalités `coming_soon` ; les fonctionnalités inactives sont omises.

```bash theme={null}
so-me billing:plan-features <name>
```

**name** `string` *required*

Identifiant interne de l'offre : `solo` (Lite), `team` (Standard), `scale` (Advanced) ou `lifetime` (Lifetime). L'identifiant `hobby` correspond à une ancienne offre retirée qui n'est plus disponible.

```bash Exemples theme={null}
# Features for Lite
so-me billing:plan-features solo

# Features for Advanced
so-me billing:plan-features scale

# Compare posts-per-month across plans
for p in solo team scale lifetime; do
  echo -n "$p: "
  so-me billing:plan-features $p | jq -r '.[] | select(.name == "Posts/month") | .numericValue'
done

# As a table
so-me billing:plan-features team --table
```

> [!NOTE]
>
> Les identifiants d'offre sont comparés exactement (sensibles à la casse). Un identifiant inconnu renvoie une liste vide plutôt qu'une erreur. Utilisez `solo` pour Lite, `team` pour Standard, `scale` pour Advanced ou `lifetime` pour Lifetime. `hobby` est une ancienne offre retirée et ne peut plus être souscrite.

## billing:addons

Liste les offres de modules complémentaires disponibles. Les modules complémentaires sont les offres qui portent un `addonType` — `MEMBER` (places d'équipe supplémentaires), `TENANT` (espaces de travail supplémentaires) ou `AI_CREDIT` (packs de crédits IA).

```bash theme={null}
so-me billing:addons
```

```bash Exemples theme={null}
# All add-ons
so-me billing:addons

# Add-on table
so-me billing:addons --table

# Extra-workspace add-ons only
so-me billing:addons | jq '.[] | select(.addonType == "TENANT")'

# AI credit packs only
so-me billing:addons | jq '.[] | select(.addonType == "AI_CREDIT")'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.