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

# Planes, uso y créditos desde la CLI

> Consulta planes y complementos, y revisa el estado de tu suscripción, tu uso y tu código de referido desde la CLI de Social media studio.

Los comandos de facturación te permiten explorar el catálogo público de planes e inspeccionar tu propia suscripción, tu uso y tus créditos de referidos desde la terminal.

Esta página tiene dos grupos de comandos:

* **`billing:*`**: el catálogo público de planes: planes de suscripción, matrices de funciones por plan y SKU de complementos. Estos endpoints son públicos y funcionan sin autenticación.
* **`settings:*`** (relacionados con la facturación): el estado de tu suscripción, el desglose de uso y tu código de referido. Requieren una clave de API válida (consulta [Claves de API](/es/cli/api-keys.md)).

> [!NOTE]
>
> Todos los comandos aceptan las opciones globales `--json` (por defecto), `--table`, `--verbose`, `--api-key <key>` y `--api-url <url>`. También puedes definir `SOME_API_KEY` / `SOME_API_URL` en el entorno. Ninguno de los comandos de facturación define opciones propias.

## settings:billing

Obtiene el estado de la suscripción y la información del plan: tu plan actual, el estado de la suscripción y los datos de renovación.

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

```bash Ejemplos 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

Obtiene el desglose de uso del periodo de facturación actual (publicaciones, biolinks, cuentas sociales, almacenamiento multimedia, miembros del equipo y créditos de IA para texto, imagen y vídeo).

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

```bash Ejemplos 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

Obtiene tu código de referido y los totales (referidos totales, créditos ganados).

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

```bash Ejemplos 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

Lista todos los planes de suscripción disponibles. Solo se devuelven los planes visibles que no son complementos, ordenados por su orden de visualización. Cada plan incluye precios mensual y anual (`monthlyPrice`, `yearlyPrice`), los ID de variante de Lemon Squeezy correspondientes (`monthlyVariantId`, `yearlyVariantId`), el nombre visible y la descripción.

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

```bash Ejemplos 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

Obtiene la lista de funciones (límites de publicaciones, número de puestos, almacenamiento, créditos de IA, etc.) de un plan concreto. Las funciones activas se devuelven primero, seguidas de las funciones `coming_soon`; las funciones inactivas se omiten.

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

**name** `string` *required*

Identificador interno del plan: `solo` (Lite), `team` (Standard), `scale` (Advanced) o `lifetime` (Lifetime). El identificador `hobby` pertenece a un plan heredado retirado que ya no está disponible.

```bash Ejemplos 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]
>
> Los identificadores de plan se comparan de forma exacta (distinguen mayúsculas y minúsculas). Un identificador desconocido devuelve una lista vacía en lugar de un error. Usa `solo` para Lite, `team` para Standard, `scale` para Advanced o `lifetime` para Lifetime. `hobby` es un plan heredado retirado y no está disponible para su compra.

## billing:addons

Lista los planes de complemento disponibles. Los complementos son los planes que tienen un `addonType`: `MEMBER` (puestos de equipo adicionales), `TENANT` (espacios de trabajo adicionales) o `AI_CREDIT` (paquetes de créditos de IA).

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

```bash Ejemplos 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.