> ## 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 = Bitcoinの1/100,000,000。一般的な価格帯での換算:

| 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       | ストリーム全体で自然に蓄積される         |

これらは出発点です。適切な価格とは、呼び出し元がストレスなく支払える金額です。

***

## 低価格から始めて引き上げる

価格の変更はコード1行で済むため、ローンチ時は低価格に設定することをお勧めします:

```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未満（$80k/BTCで約$800）であれば、0.3%の手数料は誤差の範囲内です。Managedを使いながら開発に集中しましょう。取引量が増えたタイミングでSoberanoに切り替えてください — コード1行で完了します。

***

## AIエージェント向けの価格設定

エージェントは人間とは異なる意味で価格に鈍感です — 支払いの痛みを感じることはありませんが、オペレーターが設定した予算制限があります。

**実践的なガイダンス:**

* 一般的なエージェント用途では、1回のコールを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 Networkウォレットで受信を確認する

確認が取れたら、実際の価格を設定してデプロイしてください。