Offres, utilisation et crédits depuis la CLI

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).

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.

so-me settings:billing

Exemples

# 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).

so-me settings:usage

Exemples

# 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).

so-me settings:referral-code

Exemples

# 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.

so-me billing:plans

Exemples

# 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.

so-me billing:plan-features <name>

string

requis

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.

Exemples

# 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

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).

so-me billing:addons

Exemples

# 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")'

Premiers pas

Publication

AI Studio

Boîte de réception et engagement

Statistiques

Biolink

Équipe et collaboration

Paramètres et facturation

Webhooks

Assistance

Offres, utilisation et crédits depuis la CLI

settings:billing

settings:usage

settings:referral-code

billing:plans

billing:plan-features

billing:addons

​settings:billing

​settings:usage

​settings:referral-code

​billing:plans

​billing:plan-features

​billing:addons

settings:billing

settings:usage

settings:referral-code

billing:plans

billing:plan-features

billing:addons