今すぐ始める

Credits

CLI で credit balance を確認し checkout を開始します。

Credit は、価値の高い agent context の取得や処理に使われる quota です。CLI は現在の personal/workspace context に対して balance と checkout command を提供します。

1 credit の price は $0.01 です。Checkout は allocations 合計で最低 500 credits が必要です。

Check balance

epismo credit balance

Selected workspace によって返される balance が決まります。Workspace が選択されていなければ personal space を使います。EPISMO_TOKEN が設定されている場合、token に埋め込まれた workspace が balance context を決めます。

Response は次の field を含みます。

Field Meaning
balance Selected context で利用可能な credits
shortfall Credit requirement に対して不足している amount

Start checkout

epismo credit checkout --allocations '[{"userId":"<user-id>","quantity":500}]'

Command は checkout URL を含む情報を返します。Workspace context では allocations はその workspace に紐づきます。

各 allocation は non-empty userId と positive integer quantity を要求します。

Avoid accidental credit usage

  • Agent usage、pack search、track search、pack read は credit を消費します。
  • epismo pack search と epismo track search は、検索対象の context を探すために credit を消費します。
  • epismo pack get は outline、selected block/step、full read のいずれでも credit を消費します。
  • 大きな pack では --full の前に outline read を使い、後続の agent context を小さく保ちます。
  • CI では workspace-scoped token を使い、意図した workspace に credit usage を紐づけます。
  • 多数の search/detail get を実行する job や large agent context を hydrate する前に balance を確認します。

Selected context の balance が不足している場合、credit-gated operation は 402 Payment Required を返すことがあります。Read 後の credit consumption は fail-open です。Credit-gated read が成功し consumption が失敗した場合でも response は返され、失敗は server-side に記録されます。