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

# Tarife, Nutzung und Credits in der CLI

> Tarife und Add-ons durchsuchen und Abonnementstatus, Nutzung und Empfehlungscode über die Social-media-studio-CLI prüfen.

Mit den Abrechnungsbefehlen durchsuchst du den öffentlichen Tarifkatalog und prüfst im Terminal dein eigenes Abonnement, deine Nutzung und deine Empfehlungs-Credits.

Diese Seite enthält zwei Befehlsgruppen:

* **`billing:*`** — der öffentliche Tarifkatalog: Abonnement-Tarife, Merkmalsmatrizen je Tarif und Add-on-SKUs. Diese Endpunkte sind öffentlich und funktionieren ohne Authentifizierung.
* **`settings:*`** (abrechnungsbezogen) — dein eigener Abonnementstatus, deine Nutzungsaufschlüsselung und dein Empfehlungscode. Diese erfordern einen gültigen API-Schlüssel (siehe [API-Schlüssel](/de/cli/api-keys.md)).

> [!NOTE]
>
> Jeder Befehl akzeptiert die globalen Flags `--json` (Standard), `--table`, `--verbose`, `--api-key <key>` und `--api-url <url>`. Du kannst außerdem `SOME_API_KEY` / `SOME_API_URL` in der Umgebung setzen. Keiner der Abrechnungsbefehle definiert eigene Flags.

## settings:billing

Ruft Abonnementstatus und Tarifinfos ab — deinen aktuellen Tarif, den Abonnementstatus und Details zur Verlängerung.

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

```bash Beispiele theme={null}
# Vollständige Abonnementinfos
so-me settings:billing

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

# Kompakte Tabelle
so-me settings:billing --table
```

## settings:usage

Ruft die Nutzungsaufschlüsselung für den aktuellen Abrechnungszeitraum ab (Beiträge, Biolinks, Social-Konten, Medienspeicher, Teammitglieder sowie KI-Text-/Bild-/Video-Credits).

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

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

# Genutzte Beiträge im Verhältnis zum Limit
so-me settings:usage | jq '.tenant.posts'

# Nutzung der KI-Text-/Bild-/Video-Credits
so-me settings:usage | jq '{text: .tenant.aiText, image: .tenant.aiImage, video: .tenant.aiVideo}'

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

## settings:referral-code

Ruft deinen Empfehlungscode und die Summen ab (Empfehlungen insgesamt, verdiente Credits).

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

```bash Beispiele theme={null}
# Vollständiges Objekt
so-me settings:referral-code

# Nur der Code
so-me settings:referral-code | jq -r '.code'

# Einladungslink (mit deiner öffentlichen Website kombinieren)
echo "https://so-me.studio/signup?ref=$(so-me settings:referral-code | jq -r '.code')"
```

## billing:plans

Listet alle verfügbaren Abonnement-Tarife auf. Zurückgegeben werden nur sichtbare Tarife, die keine Add-ons sind, sortiert nach ihrer Anzeigereihenfolge. Jeder Tarif enthält sowohl die monatliche als auch die jährliche Preisgestaltung (`monthlyPrice`, `yearlyPrice`), die zugehörigen Lemon-Squeezy-Variant-IDs (`monthlyVariantId`, `yearlyVariantId`), den Anzeigenamen und die Beschreibung.

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

```bash Beispiele theme={null}
# Alle Tarife als JSON
so-me billing:plans

# Kompakte Tabelle
so-me billing:plans --table

# Liste aus Name + monatlichem/jährlichem Preis
so-me billing:plans | jq -r '.[] | "\(.name)\t$\(.monthlyPrice)/mo\t$\(.yearlyPrice)/yr"'

# Nur die monatlichen Lemon-Squeezy-Variant-IDs
so-me billing:plans | jq -r '.[] | "\(.name): \(.monthlyVariantId)"'
```

## billing:plan-features

Ruft die Merkmalsliste (Beitragslimits, Anzahl der Plätze, Speicher, KI-Credits usw.) für einen bestimmten Tarif ab. Aktive Merkmale werden zuerst zurückgegeben, gefolgt von `coming_soon`-Merkmalen; inaktive Merkmale werden ausgelassen.

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

**name** `string` *required*

Interne Tarifkennung: `solo` (Lite), `team` (Standard), `scale` (Advanced) oder `lifetime` (Lifetime). Die Kennung `hobby` gehört zu einem eingestellten Legacy-Tarif, der nicht mehr verfügbar ist.

```bash Beispiele theme={null}
# Merkmale für Lite
so-me billing:plan-features solo

# Merkmale für Advanced
so-me billing:plan-features scale

# Beiträge pro Monat über alle Tarife vergleichen
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

# Als Tabelle
so-me billing:plan-features team --table
```

> [!NOTE]
>
> Tarifkennungen werden exakt abgeglichen (Groß-/Kleinschreibung beachten). Eine unbekannte Kennung liefert eine leere Liste statt eines Fehlers. Verwende `solo` für Lite, `team` für Standard, `scale` für Advanced oder `lifetime` für Lifetime. `hobby` ist ein eingestellter Legacy-Tarif und nicht zum Kauf verfügbar.

## billing:addons

Listet verfügbare Add-on-Tarife auf. Add-ons sind die Tarife mit einem `addonType` — `MEMBER` (zusätzliche Team-Plätze), `TENANT` (zusätzliche Workspaces) oder `AI_CREDIT` (KI-Credit-Pakete).

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

```bash Beispiele theme={null}
# Alle Add-ons
so-me billing:addons

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

# Nur Add-ons für zusätzliche Workspaces
so-me billing:addons | jq '.[] | select(.addonType == "TENANT")'

# Nur KI-Credit-Pakete
so-me billing:addons | jq '.[] | select(.addonType == "AI_CREDIT")'
```


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