使用量と料金

使用料金

対話には、ログイン中のユーザーの HarperHarbor credits を使用します。許可されたアプリはユーザーに代わって対話を開始できますが、ユーザーの残高を受け取ったり保管したりすることはありません。

モデルごとの料金は GET /open/v1/models で確認できます。入力、キャッシュされた入力、出力はそれぞれ別の単価で計算されます。確定料金はモデルが報告したトークン使用量に基づき、完了した応答には最低 1 credit がかかります。

credits の仮確保と精算

生成前に、入力と出力上限に必要な credits を仮確保します。そのため、利用可能な残高が確定料金より多く必要になる場合があります。使わなかった分は精算時に解放されます。

料金はモデルの実際の使用量に基づきます。安全フィルターによるブロック、内容を理由とした応答拒否、出力上限への到達、ユーザーによる停止でも、使用量が発生していればその分が課金されます。応答の本文が表示されなくても、料金が発生する場合があります。

プラットフォーム側の不具合には課金しません。デプロイによる中断も含まれます。モデルの使用量が発生していないサービスエラーも無料です。各操作の精算は一度だけで、未使用の仮確保分は解放されます。同じ内容の clientOperationId で再送しても、重複して課金されません。

仮確保に必要な残高がない場合は 402 insufficient_credits が返ります。アプリからアカウント残高へ案内すると、ユーザーが利用可能な credits を確認できます。

確定料金の確認

GET /open/v1/conversation/operations/{operationId} で操作結果を取得し、操作の状態、settled、chargeCredits を合わせて確認してください。残高と利用明細にも対応する記録が残ります。アプリ側で推定したトークン数から確定料金を計算したり、約束したりしないでください。

credits のプランと現在利用できる購入方法は料金ページをご覧ください。

Agent モード

Agent の準備中はモデルを呼び出す前に credits を仮確保し、必要に応じて確保額を追加します。各実行の終了時に、報告された入力、出力、キャッシュ読み取り、キャッシュ書き込みの使用量をまとめて精算します。通常の呼び出しが固定料金のモデルでも、Agent の実行はトークン単位の料金です。モデル一覧の見積もりは一回の対話の範囲を示すもので、複数回呼び出す Agent の料金上限ではありません。

ユーザーの停止やモデルサービスのエラーより前に完了した使用分には課金されます。プラットフォーム側の不具合は無料です。保存済みの準備を続ける場合は、新たに発生した使用分だけが課金されます。再接続や同じ操作の再生では重複課金されません。自動的なメモリの準備は別途精算されます。

利用明細には Agent モードの料金として表示され、実際に使用したモデルも別に記録されます。確定料金は操作結果の settled と chargeCredits で確認してください。