クレジット
各操作のコストと消費の仕組みです。
クレジットは、プレイブック、案件、タスク、記録、改善提案に対する成功した操作を計測します。失敗または不正な呼び出しは課金されません。ワークスペースでは、席数にかかわらず一つの残高を共有します。
クレジット区分
- 0 credits — Explore: 公開プレイブックの一覧・単体取得。Web、CLI、API はログインの有無にかかわらず無料です。MCP は常にログインが必須ですが、公開プレイブックの取得自体は 0 credits のままです。
- 1 credit — Use: 非公開データの閲覧・一覧、バージョン、下書き、スター、Alias、記録。
- 2 credits — Coordinate: アクセス、担当、引き継ぎ、ライフサイクル、解決結果の変更。
- 5 credits — Create: 作成・公開、案件開始、タスク・提案作成、Alias 設定、関連度検索。
Web、CLI、API での公開アクセスには fair-use の rate limit があります。CLI はランダムな anonymous ID を保存して送信します。API クライアントも、応答の X-Epismo-Anonymous-Id を保存し、次回以降のリクエストで送信できます。この ID は analytics と rate limit のためのもので、認証や権限には使いません。
サーフェス別の課金ルール
- 公開プレイブックの list/get: すべてのサーフェスで無料。未ログイン時は公開データだけを返します。
- 検索: 常に 5 credits で、認証が必要です。無料の公開ブラウジングには含まれません。
- Web UI: 通常のページ表示、詳細・一覧の閲覧は無料です。検索と書き込みは通常料金です。
- API / CLI / MCP: 非公開データの読み取りと認証済み操作は、下表の操作料金です。
操作別クレジット一覧
プレイブック
| 操作 | コスト |
|---|---|
playbook create（新規作成） |
5 credits |
playbook version publish、playbook draft publish（バージョン公開） |
5 credits |
playbook search（セマンティック・キーワード検索） |
5 credits |
playbook access set（アクセス変更） |
2 credits |
playbook archive、playbook version archive（アーカイブ） |
2 credits |
playbook share（共有設定） |
2 credits |
playbook list（非公開一覧取得） |
1 credit |
playbook get（非公開詳細取得） |
1 credit |
playbook version list（バージョン一覧） |
1 credit |
playbook version get（バージョン詳細） |
1 credit |
playbook draft get、draft save、draft discard（下書き操作） |
1 credit |
playbook star、unstar（スター追加・解除） |
1 credit |
playbook starred（スター一覧） |
1 credit |
playbook creator stats（作成者統計） |
1 credit |
playbook list（公開一覧取得） |
無料（0 credits） |
playbook get（公開詳細取得） |
無料（0 credits） |
playbook get は、仕事を継続するための集約取得です。プレイブック本体と、その未解決の提案（open・applied・declined）、最近の Version、そのプレイブックを指すエイリアスを返します。API / CLI / MCP ではこれらの補助取得を個別課金せず、同じ playbook get にまとめます（公開なら無料、非公開なら 1 credit）。通常の Web 詳細画面はどちらの場合も無料です。
プレイブックの Alias
| 操作 | コスト |
|---|---|
playbook alias set（エイリアス設定） |
5 credits |
playbook alias delete（エイリアス削除） |
2 credits |
playbook alias list（エイリアス一覧） |
1 credit |
playbook alias resolve、参照解決 |
1 credit |
プレイブックの提案（改善提案）
| 操作 | コスト |
|---|---|
playbook suggestion create（改善提案作成） |
5 credits |
suggestion update（改善提案更新） |
2 credits |
suggestion resolve（改善提案解決） |
2 credits |
playbook suggestion list（プレイブック内の提案一覧） |
1 credit |
suggestion list（送信した提案一覧） |
1 credit |
suggestion get（詳細取得） |
1 credit |
案件
| 操作 | コスト |
|---|---|
case start（開始・新規作成） |
5 credits |
case update（内容更新） |
2 credits |
case assign（担当者変更） |
2 credits |
case acl（権限変更） |
2 credits |
case handoff create（引き継ぎ接続） |
2 credits |
case close（完了・クローズ） |
2 credits |
case reopen（再オープン） |
2 credits |
case list（一覧取得） |
1 credit |
case handoff graph（引き継ぎグラフ取得） |
1 credit |
case handoff candidates（引き継ぎ候補一覧） |
1 credit |
case get（詳細閲覧） |
1 credit |
case get は、仕事を継続するための集約取得です。案件本体、現在のタスク、その案件と祖先案件の記録、直接つながる引き継ぎ関係に加え、読み取り権限が残っていれば開始元のプレイブックと固定した Version も返します。API / CLI / MCP では内部の補助取得を個別課金せず、案件 get 1回分の 1 credit にまとめます。通常の Web 詳細画面は無料です。
タスク
| 操作 | コスト |
|---|---|
case task create（タスク作成） |
5 credits |
task update（内容更新） |
2 credits |
task assign（担当者変更） |
2 credits |
task close（完了・クローズ） |
2 credits |
task reopen（再オープン） |
2 credits |
case task list（案件内のタスク一覧） |
1 credit |
task list（担当タスク一覧） |
1 credit |
task get（詳細取得） |
1 credit |
記録
| 操作 | コスト |
|---|---|
case record list（案件タイムライン一覧） |
1 credit |
case record append（案件記録追記） |
1 credit |
残高が不足している場合
価値の高い操作は実行前に残高を確認します。個人またはワークスペースの残高が不足している場合、402 Payment Required で失敗し、課金されません。低コストの利用は shortfall として記録され、次回付与分から回収される場合があります。クレジット管理から追加購入するか、別の context に切り替えてください。