安全性と請求

ケイパビリティの価格、支払い、可用性、安全な再試行を説明します。

ケイパビリティの呼び出しは、Xenodia の共通アカウント、残高、リクエスト履歴を使用します。呼び出す前に、最新の説明から価格と利用可能な支払い方法を確認してください。

支払いモード

モード	意味
`owner_only`	オーナーアカウントが支払います。
`self_only`	呼び出し元アカウントが支払います。
`self_then_owner`	呼び出し元の残高を優先し、許可されている場合はオーナー残高を利用します。

レスポンスの billing には、実際の支払者と最終金額が示されます。

価格は micro USDC です。10000 は 0.01 USDC、1000000 は 1 USDC です。複数操作を持つ場合は、呼び出し前に operations[].pricing.unit_price_micro_usdc を確認してください。

状況	資金の扱い
呼び出し前に操作が利用不可	資金はロックされません。
受理されたリクエストが完了できない	一時的な予約は解放されるか、返された請求状態に従って確認対象になります。
有料呼び出しが成功	最終金額が請求概要に表示されます。
同じ request key と同じ内容で再送	保存済み結果が返り、同じ意図への二重請求を防ぎます。

有料および非同期操作では Idempotency-Key を送信します。同じ内容の同一リクエストを再試行する場合だけ同じ key を使い、新しい依頼には新しい key を使います。内容が競合する場合は 409 idempotency_conflict が返ります。

状態	意味
`active`	現在呼び出し可能です。
`unavailable`	Xenodia は現在この操作の新規呼び出しを受け付けていません。公開メッセージと再試行案内に従ってください。

カタログ確認後に可用性が変わる場合があります。呼び出しレスポンスを必ず処理し、request_id を保持してください。

有料または重要な呼び出しでは、request ID、ケイパビリティ slug、操作、バージョン、請求状態、最終金額、依頼内容を説明するための入力概要を保持してください。