ゲストウォレット

アカウントなしでプレペイド TwexAPI キーを取得：AI エージェントが Stripe カード支払いを生成し、人間が支払いを行い、キーはすべてのエンドポイントおよび MCP で動作します。

ゲストウォレット

ゲストウォレットは、アカウント、サインアップ、メールアドレスが不要なプレペイド TwexAPI APIキーです。AI エージェントが1つのリクエストでウォレットを作成し、APIキーとStripe支払いリンクを受け取ります。人間がそのリンクをカードで支払えば、そのキーはすべてのTwexAPIエンドポイントおよびMCPサーバーで、アカウントキーと同じように動作します。

アクセスメソッドを選択

ウォレットの作成とアクティベート

1. 金額を確認してください。 ウォレットはUSD 10から250までの金額で資金化されます（amount_minorとしてセントで1000から25000）。クレジットは標準的なレートで追加されます（1USDあたり100,000クレジット）、したがってUSD 10は1,000,000クレジットを購入します。リクエストの費用については価格を参照してください。

2. 支払いリンクを作成してください。 Idempotency-Keyヘッダーに新しいUUID v4を送信してください：

curl -sS https://api.twexapi.io/guest-wallets \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen | tr A-Z a-z)" \
  -d '{"amount_minor": 1000, "currency": "usd"}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "wallet_id": "6f1c2a4e-8b3d-4c5e-9a7f-1d2e3f4a5b6c",
    "api_key": "twitterx_...",
    "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_...",
    "checkout_expires_at": "2026-10-29T14:21:01.000Z",
    "status_url": "/guest-wallets/status",
    "poll_after_seconds": 5,
    "purchase": {
      "id": "0b8e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
      "kind": "create",
      "status": "pending",
      "amount_minor": 1000,
      "currency": "usd",
      "credits": 1000000
    }
  }
}

**3. キーを保存してください。**すぐにapi_keyをシークレットストレージに保存してください。それはウォレットの唯一の認証情報であり、TwexAPIはそれを復元することができません。

4. ユーザーに支払いリンクを渡してください。 checkout_urlをユーザーに表示し、彼らに支払いを行うように依頼してください。リンクは一度のみ使用でき、60分後に有効期限が切れます。支払いが確認されるまで、キーはAPIコールで401を返します。

5. キーが使用可能になるまでポーリングしてください。 poll_after_seconds間隔でコールを待ちます：

curl -sS https://api.twexapi.io/guest-wallets/status \
  -H "Authorization: Bearer $GUEST_KEY"

{
  "code": 200,
  "msg": "success",
  "data": {
    "wallet_id": "6f1c2a4e-8b3d-4c5e-9a7f-1d2e3f4a5b6c",
    "key_hint": "twitterx_1a2…9f0e",
    "usable": true,
    "paused": false,
    "available_credits": 1000000,
    "latest_purchase": { "kind": "create", "status": "completed", "credits": 1000000 },
    "poll_after_seconds": null
  }
}

usableがtrueになるまでAPIコールを開始してください。完了した支払いページだけではクレジットが追加されたとは限りません。latest_purchase.statusは支払いが確認されるまでpendingです、その後completedになります。未払いの支払いリンクはexpiredになり、拒否された遅延支払いはfailedになります。poll_after_secondsは待機が完了するとnullになります。

APIの呼び出し

使用可能なゲストキーはすべてのエンドポイントで動作し、アカウントキーと同じレートリミットおよび課金です：

curl -sS https://api.twexapi.io/twitter/advanced_search/page \
  -H "Authorization: Bearer $GUEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["openai"], "sortBy": "Latest"}'

クレジットが切れると、リクエストは403でNo available credits!を返します。ウォレットをチャージして続きを取ります。

ウォレットのチャージ

チャージは同じウォレットとキーにクレジットを追加します。ユーザーと金額を確認し、新しいUUID v4を送信してください：

curl -sS https://api.twexapi.io/guest-wallets/topups \
  -H "Authorization: Bearer $GUEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen | tr A-Z a-z)" \
  -d '{"amount_minor": 2000, "currency": "usd"}'

レスポンスには新しいcheckout_urlがあります。ユーザーにそれを渡し、latest_purchase.statusがcompletedになるまで同じステータスエンドポイントをポーリングしてください。

キーなしのリクエスト

TwexAPIのエンドポイントに認証情報がなくリクエストを行うと、403でWWW-Authenticate: Bearer realm="twexapi"ヘッダーが返されます。一般的なcode、msg、dataフィールドに続いてauth_optionsオブジェクトが追加され、アクセス方法がリストされています、其中包括ゲストウォレットの作成方法：

{
  "code": 403,
  "msg": "Not authenticated",
  "data": [],
  "auth_options": {
    "account": { "scheme": "Bearer", "dashboard": "https://twexapi.io/dashboard" },
    "guest_wallet": {
      "method": "POST",
      "url": "https://api.twexapi.io/guest-wallets",
      "idempotency_header": "Idempotency-Key",
      "body": { "amount_minor": 1000, "currency": "usd" },
      "amount_minor_min": 1000,
      "amount_minor_max": 25000,
      "status_url": "https://api.twexapi.io/guest-wallets/status"
    },
    "pay_per_request": { "scheme": "Payment", "endpoints": ["POST /twitter/advanced_search/page", "..."] },
    "mcp": { "url": "https://api.twexapi.io/mcp", "pay_per_call_url": "https://api.twexapi.io/mcp/pay" },
    "docs": "https://twexapi.io/llms.txt"
  }
}

auth_optionsはエージェントが何が可能かを教えます。これはお金を費やす許可ではありません：エージェントはユーザーが金額に同意する前にウォレットを作成する必要があります。

MCPでゲストキーの使用

ウォレットが使用可能になるまで待ち、MCPクライアントをhttps://api.twexapi.io/mcpに接続し、Authorization: Bearerヘッダーにゲストキーを設定して、MCP概要に説明されているように使用してください。ウォレットの作成、チャージ、ステータスの確認はRESTのみで行います；これらのためにMCPツールはありません。

エラー

一貫性と安全なリトライ

すべての作成およびチャージリクエストには、独自のUUID v4がIdempotency-Keyに必要です。リクエストがタイムアウトすると、同じキーで変更なしに再送信してください：元の結果がIdempotent-Replayed: trueヘッダーでマークされ、2つ目のチェックアウトは行われません。異なる金額や異なるリクエストに対してキーを再利用すると422が返されます。

ウォレットアクセスの保護

• ゲストキーやIdempotency-Keyの値はURL、ログ、チャットトランザクションに含めないでください。作成リクエストに対してそのIdempotency-Keyを再利用すると、APIキーが再び返されます。
• レスポンスはCache-Control: no-store, privateで送信されます。それらをキャッシュしないでください。
• ステータスエンドポイントのusableに依存して、APIコールを行う前に支払いページに依存しないでください。
• 支払いが争議になる場合、ウォレット全体が停止中(paused: true)になり、キーは解決されるまで動作しません。

FAQ

TwexAPI Twitter APIをアカウントなしで使用できますか？

はい。ゲストウォレットはサインアップなしでプレペイドAPIキーを提供し、MPPはエージェントがTempoウォレットを持っている場合にリクエストごとに支払うためにキーを提供します。

AIエージェントはTwexAPIを自分で支払うことができますか？

いいえ。ゲストウォレットを使用する場合、Stripe支払いリンクに対して常に人間の支払いが必要です。エージェントがUSDCをTempo上に保持している場合にリクエストごとに支払うためにMPPを使用できます。

ゲストキーは特定のエンドポイントに限られていますか？

いいえ。支払いが完了すると、ゲストキーはすべてのエンドポイントおよびMCPサーバーで、アカウントキーと同じ価格とレートリミットで動作します。

ゲストウォレットを後にアカウントに変換できますか？

いいえ。まだ変換できません。ゲストキーを使用し、新しい作業に使用するか、新しいアカウントを作成して新しいキーを使用してください。

次のステップ

• 認証でアカウントAPIキーの設定
• マシン支払いプロトコルでリクエストごとにアクセス
• MCP概要でAIクライアントからキーの使用
• 価格でクレジットのリクエストごとの費用