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

# ゲストウォレット

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

:::warning
ゲストウォレットは常に人間の支払いが必要です。エージェントが支払いリンクを作成し、リンクを渡しますが、カード詳細は入力されません。ユーザーが金額を確認した後にウォレットを作成してください。
:::

## アクセスメソッドを選択

| メソッド | アカウント | 認証情報 | 覆盖範囲 | 支払い |
|---|---|---|---|---|
| [アカウントAPIキー](/ja/authentication) | はい | `Authorization: Bearer <APIキー>` | すべてのエンドポイントおよびMCP | ダッシュボード：カード、PayPal、暗号通貨 |
| [MCPサインイン](/ja/mcp/oauth) | はい | MCPクライアント内のOAuth | MCPツール | アカウントのクレジット |
| ゲストウォレット | いいえ | `Authorization: Bearer <ゲストキー>` | すべてのエンドポイントおよびMCP | カード、Stripe Checkoutを通じてプレペイド |
| [MPP](/ja/mpp/machine-payments-protocol) | いいえ | `Authorization: Payment <認証情報>` | 12のページ化された読み取りエンドポイント | Tempo上のUSDC、リクエストごと |
Use a guest wallet when an agent needs a normal API key for a person who doesn't want an account. Use MPP when the agent has its own wallet and pays per request. Use an account key for anything long-lived.

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

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

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

```bash
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"}'
```

```json
{
  "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`間隔でコールを待ちます：

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

```json
{
  "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の呼び出し

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

```bash
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を送信してください：

```bash
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`オブジェクトが追加され、アクセス方法がリストされています、其中包括ゲストウォレットの作成方法：

```json
{
  "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概要](/ja/mcp/overview)に説明されているように使用してください。ウォレットの作成、チャージ、ステータスの確認はRESTのみで行います；これらのためにMCPツールはありません。

## エラー

| ステータス | 意味 | どうすればよいですか |
|---|---|---|
| `400` | `Idempotency-Key`が欠けているか無効、`amount_minor`が1000から25000の範囲外、または`usd`以外の通貨 | リクエストを修正してください |
| `401` | ベアアー・キーが欠けているかゲストウォレットのキーではありません | ステップ2からゲストキーを送信してください |
| `403` | ウォレットが停止中 | サポートに連絡してください |
| `409` | リトライされたチェックアウトリクエストが有効期限に近すぎて完了できない | 新しい`Idempotency-Key`でリトライしてください |
| `422` | `Idempotency-Key`がすでに異なるリクエストで使用されています | 新しいUUID v4を使用してください |
| `429` | 1時間以内に1つのIPアドレスからウォレットが多く作成されました | 待ち、再試行してください |

## 一貫性と安全なリトライ

すべての作成およびチャージリクエストには、独自の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](/ja/mpp/machine-payments-protocol)はエージェントがTempoウォレットを持っている場合にリクエストごとに支払うためにキーを提供します。

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

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

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

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

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

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

## 次のステップ

- [認証](/ja/authentication)でアカウントAPIキーの設定
- [マシン支払いプロトコル](/ja/mpp/machine-payments-protocol)でリクエストごとにアクセス
- [MCP概要](/ja/mcp/overview)でAIクライアントからキーの使用
- [価格](/ja/guides/pricing)でクレジットのリクエストごとの費用