クレジット

クレジット残高の確認とチェックアウト開始です。

クレジットエンドポイントは残高確認と購入フロー開始に使います。

1 credit の価格は $0.01 です。チェックアウトには合計 500 credits 以上の購入が必要です。

残高の取得

GET /v1/credits
Authorization: Bearer <token>

ワークスペースの残高を見る場合は workspaceId を使います。

curl "https://api.epismo.ai/v1/credits?workspaceId=$WORKSPACE_ID" \
  -H "authorization: Bearer $EPISMO_TOKEN"

レスポンス:

{
	"balance": 1200,
	"shortfall": 0
}

チェックアウトの開始

POST /v1/credits
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "allocations": [
    { "userId": "user-id", "quantity": 500 }
  ]
}

レスポンスはチェックアウト url を含みます。

各割り当てには、空でない userId と正の整数の quantity が必要です。すべての quantity の合計は 500 以上である必要があります。

クレジットの消費

クレジットは、クレジット対象のリクエストが成功したあとに消費されます。バリデーションで失敗した操作は消費しません。

操作	コスト
`packs.create`	5 credits
`packs.search`	5 credits
`tracks.search`	2 credits
`packs.get`	1 credit
`tracks.get`	1 credit
`tracks.apply`	1 credit
`packs.update/delete/like`	1 credit
`tracks.create/update/delete`	1 credit
`aliases.*`	1 credit
`credits.balance/checkout`	1 credit

GET /v1/packs の読み取りは、アウトライン、指定した blockIds / stepIds、full=true のいずれでも同じ 1 credit です。書き込みエンドポイントは標準呼び出しとして消費します。バリデーションで失敗した操作や成功しなかったリクエストは消費しません。

選択中のコンテキストのクレジットが不足している場合、クレジットが必要な操作は 402 Payment Required を返すことがあります。