エージェントには予算を。API サブスクリプションの山ではなく。

チームが使う理由

実際の活用例

どれくらい節約できる？

ご自身の数値を入力してください。計算はブラウザ内で行われます。

機能

成功時のみ課金

料金は呼び出し前に確保され、API が 2xx ステータスで応答したときにだけ課金されます。エラー、タイムアウト、到達できない API には料金がかかりません。

二重課金なし

すべての呼び出しに Idempotency-Key が付きます。完了した呼び出しを再試行すると、24 時間以内なら元のレスポンスが返され、二重に課金されることはありません。

制限時間を厳守

各ルートには応答の制限時間（SLA）があります。API が時間内に応答しなければ、呼び出しは打ち切られて 504 が返り、課金されません。

API キーは私たちが保管

宛先 API のキーは暗号化して保管し、送信時に各リクエストへ付加します。エージェントがキーを持つことはなく、エージェント自身のキーが転送されることもありません。

見える料金

各ルートは、使う前に 1 回あたりの料金を表示します。料金は私たちが設定するため、クライアントが課金額を変えることはできません。

すべての呼び出しを記録

各呼び出しは、ステータス、API のレスポンスコード、所要時間とともに記録されます。すべての課金はウォレットの履歴にも表示されます。

仕組み

1. ルートを選びます。GET /v1/routes で、利用できる API とその料金、制限時間を一覧できます。
2. AgentPay 経由で呼び出します。キーと Idempotency-Key を付けて、agentpay.myuiaf.com/v1/proxy/<route>/<path> にリクエストを送ります。
3. API の応答を受け取ります。レスポンスはそのまま返り、課金額と残高を示すヘッダーが付きます。

試してみる

# See the routes you can call and their prices
curl https://agentpay.myuiaf.com/v1/routes \
  -H "X-Agent-API-Key: fv1.acme-bot.k1.xxxxx"

# Call one. Use a new Idempotency-Key for each new call.
curl -X POST https://agentpay.myuiaf.com/v1/proxy/rt_weather/forecast \
  -H "X-Agent-API-Key: fv1.acme-bot.k1.xxxxx" \
  -H "Idempotency-Key: 7f3c9a1e-forecast-honolulu" \
  -H "content-type: application/json" \
  -d '{"city":"Honolulu","days":3}'

HTTP/2 200
x-agentpay-call-id: 001762570000000-a1b2c3
x-agentpay-charged-usd: 0.03
x-agentpay-available-usd: 4.97
x-agentpay-ttfb-ms: 171
x-agentpay-total-ms: 184

{ ...the API's own response... }

上記のルート名は例です。現在利用できるルートは GET /v1/routes で確認してください。

料金

呼び出しは、Freshness Validator と同じプリペイドクレジットから支払われます。クレジットパックを購入するか、エージェントに自分で購入させてください。失敗、タイムアウト、再試行した呼び出しは無料です。

レート制限

Freshness Validator の呼び出しとは別にカウントされるため、一方のサービスがもう一方を遅くすることはありません。

よくある質問

エージェントが支払うべき API をお持ちですか？

AgentPay への API の追加は個別に行っています。API を運営していてエージェントに呼び出しごとに支払ってほしい場合や、まだ掲載されていない API が必要な場合は、お知らせください。

Freshness Validator と連携

同じキーとウォレットは Freshness Validator でも使えます。エージェントが知っている情報が情報源で変わったときに知らせます。