クレジット
CLI でクレジットの残高を確認しチェックアウトを開始します。
クレジットは、API、MCP、CLI の操作で使われる割り当て量です。CLI は現在の個人用 / ワークスペースコンテキストに対して残高とチェックアウトのコマンドを提供します。
1 credit の価格は $0.01 です。チェックアウトは割り当て合計で最低 500 credits が必要です。
残高の確認
epismo credit balance選択中のワークスペースによって返される残高が決まります。ワークスペースが選択されていなければ個人スペースを使います。EPISMO_TOKEN が設定されている場合、トークンに埋め込まれたワークスペースが残高のコンテキストを決めます。
レスポンスは次の項目を含みます。
| 項目 | 意味 |
|---|---|
balance |
選択中のコンテキストで利用可能なクレジット |
shortfall |
必要なクレジットに対して不足している量 |
チェックアウトの開始
epismo credit checkout --allocations '[{"userId":"user-id","quantity":500}]'コマンドはチェックアウト URL を含む情報を返します。ワークスペースのコンテキストでは割り当てはそのワークスペースに紐づきます。
各割り当ては、空でない userId と正の整数の quantity を要求します。
コマンドごとの消費
| コマンド | コスト |
|---|---|
epismo pack create |
5 credits |
epismo pack search |
5 credits |
epismo track search |
2 credits |
epismo pack get |
1 credit |
epismo pack update |
1 credit |
epismo pack delete |
1 credit |
epismo pack like |
1 credit |
epismo track create |
1 credit |
epismo track update |
1 credit |
epismo track get |
1 credit |
epismo track apply |
1 credit |
epismo track delete |
1 credit |
epismo alias upsert |
1 credit |
epismo alias list |
1 credit |
epismo alias delete |
1 credit |
epismo credit balance |
1 credit |
epismo credit checkout |
1 credit |
epismo pack getはアウトライン、指定ブロック / ステップ、全文の読み取りのいずれでも同じ 1 credit を消費します。- 大きなパックでは
--fullの前にアウトライン読み取りを使い、後続のエージェントコンテキストを小さく保ちます。 - CI ではワークスペース単位のトークンを使い、意図したワークスペースにクレジット使用を紐づけます。
- 多数の検索 / 詳細取得を実行するジョブや、大きなコンテキストを読み込む前に残高を確認します。
関連する挙動
選択中のコンテキストの残高が不足している場合、クレジットが必要な操作は 402 Payment Required を返すことがあります。Epismo は操作が成功したときにだけクレジットを消費するため、バリデーションで失敗した操作や成功しなかったリクエストには課金されません。