> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ценообразование вашего API

> Как подходить к ценообразованию — что брать, как sats переводятся в доллары, и стратегии для разных сценариев использования.

## Справочная таблица satoshi

1 sat = 1/100,000,000 от Bitcoin. При распространённых ценовых уровнях:

| Цена BTC  | 1 sat    | 10 sats | 100 sats | 1,000 sats |
| --------- | -------- | ------- | -------- | ---------- |
| \$50,000  | \$0.0005 | \$0.005 | \$0.05   | \$0.50     |
| \$80,000  | \$0.0008 | \$0.008 | \$0.08   | \$0.80     |
| \$100,000 | \$0.001  | \$0.01  | \$0.10   | \$1.00     |

Lightning Network-платежи не имеют минимального порога комиссии. Платёж в 1 sat обходится отправителю \~$0.0005 — невозможно в Stripe (минимум $0.30).

***

## Ценообразование по сценариям использования

| Сценарий использования                          | Рекомендуемая цена | Обоснование                                                  |
| ----------------------------------------------- | ------------------ | ------------------------------------------------------------ |
| Простой запрос данных (погода, обменный курс)   | 1–10 sats          | Достаточно дёшево, чтобы быть незаметным, но всё же значимым |
| Премиальный API-вызов (LLM-инференс, поиск)     | 10–100 sats        | Покрывает стоимость вычислений, фильтрует злоупотребления    |
| Доступ к документу / файлу                      | 50–500 sats        | Отражает ценность контента                                   |
| Ценный отчёт или набор данных                   | 500–5,000 sats     | Конкурирует с микротранзакциями на $0.50–$5                  |
| Потоковая передача в реальном времени (за чанк) | 1–5 sats           | Естественно накапливается в процессе стриминга               |

Это отправные точки. Правильная цена — та, которую ваши пользователи готовы платить без трений.

***

## Начните с низкого, поднимайте постепенно

Поскольку смена тарифа — это одна строка кода, при запуске лучше ошибиться в сторону низких цен:

```typescript theme={null}
l402({ priceSats: 10, lightning }) // начните здесь
l402({ priceSats: 100, lightning }) // повышайте, если спрос сохраняется
```

Данные о платежах в панели управления VS Code показывают объём вызовов и выручку — используйте их для калибровки.

***

## Managed vs Soberano при масштабировании

Комиссия в 0.3% за Managed имеет значение только при больших объёмах:

| Месячный объём  | Комиссия Managed     | Экономия с Soberano |
| --------------- | -------------------- | ------------------- |
| 1,000 sats      | 3 sats               | Незначительно       |
| 100,000 sats    | 300 sats (\~\$0.24)  | Небольшая           |
| 10,000,000 sats | 30,000 sats (\~\$24) | Стоит переходить    |

**Практическое правило:** если вы обрабатываете менее 1M sats/месяц (\~$800 при $80k/BTC), комиссия в 0.3% — это шум. Оставайтесь на Managed и сосредоточьтесь на разработке. Переходите на Soberano, когда объёмы оправдают это — это одна строка кода.

***

## Ценообразование для AI-агентов

Агенты нечувствительны к цене иначе, чем люди — они не ощущают боли от платежа, но у них есть бюджетные ограничения, установленные их операторами.

**Практические рекомендации:**

* Держите цены ниже 100 sats за вызов для общего использования агентами — это вписывается в типичные бюджеты за сессию
* Для высокоценных инструментов агентов (выполнение кода, анализ документов) приемлемо 100–1,000 sats
* Используйте `priceSats` динамически, если ваша стоимость зависит от размера входных данных:

```typescript theme={null}
app.post("/analyze", (req, res, next) => {
  const sats = Math.ceil(req.body.text.length / 100); // 1 sat per 100 chars
  l402({ priceSats: sats, lightning })(req, res, next);
}, handler);
```

***

## Многоуровневый доступ с несколькими эндпоинтами

Разграничивайте ценовые уровни, направляя запросы на разные эндпоинты:

```typescript theme={null}
// Бесплатный уровень — базовые данные
app.get("/data/basic", handler);

// Платный уровень — полный набор данных, 10 sats
app.get("/data/premium", l402({ priceSats: 10, lightning }), handler);

// Высокоценный уровень — данные в реальном времени, 100 sats
app.get("/data/realtime", l402({ priceSats: 100, lightning }), handler);
```

Каждый эндпоинт генерирует собственный инвойс. Пользователи платят за каждый вызов — никаких подписок.

***

## Тестирование ценообразования

Перед запуском протестируйте полный процесс оплаты с реальным кошельком:

1. Установите `priceSats: 1` (1 sat ≈ \$0.0008 — достаточно дёшево для свободного тестирования)
2. Используйте [Wallet of Satoshi](https://walletofsatoshi.com) или [Blink](https://dashboard.blink.sv) на телефоне
3. Вызовите ваш эндпоинт, отсканируйте QR инвойса, убедитесь в ответе 200 OK
4. Проверьте [панель управления VS Code](https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402) или ваш Lightning-кошелёк для подтверждения получения

После подтверждения установите реальную цену и разверните приложение.