Misafir Cüzdanlar

Hesap açmadan TwexAPI anahtarı alın: bir AI agenti Stripe kart ödeme sayfası oluşturur, bir kişi ödeme yapar ve anahtar her yerde ve MCP'de çalışır.

Misafir Cüzdanlar

Misafir cüzdan, hesap, kayıt veya e-posta gerektirmeyen bir önceden ödenmiş TwexAPI anahtarıdır. Bir AI agenti bir istekle cüzdanı oluşturur ve bir API anahtarı ve Stripe ödeme bağlantısı alır. Bir kişi bu bağlantıyı kartla öder ve anahtar ardından her TwexAPI noktasında ve MCP sunucusunda, hesap anahtarları gibi çalışır.

Erişim yöntemi seçin

Bir agenti, bir kişinin hesabı olmayan biri için normal bir API anahtarı gerektiğinde misafir cüzdanı kullanın. Agenti kendi cüzdanına sahipse ve her istek başına ödeme yaparsa MPP kullanın. Uzun süreli her şey için hesap anahtarını kullanın.

Cüzdan oluşturun ve etkinleştirin

1. Miktarı onaylayın. Bir cüzdan, amount_minor olarak gönderilen USD 10 ila 250 arasında (1000 ila 25000) finanse edilir. Krediler, 100,000 Kredi başına USD’ye standart oranda eklenir, bu yüzden USD 10 1,000,000 Kredi satın alır. İstek maliyetleri hakkında Fiyatlandırma sayfasını görüntüleyin.

2. Ödeme sayfasını oluşturun. Idempotency-Key başlığına yeni bir UUID v4 gönderin:

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. Anahtarı saklayın. api_key’i hemen gizli bir depoda saklayın. Bu, cüzdanın tek kimlik bilgisi ve TwexAPI’nin size geri getiremeyeceği biridir.

4. Kullanıcıya ödeme bağlantısını verin. Kullanıcıya checkout_url’yi gösterin ve ondan ödeme yapmasını isteyin. Bağlantı bir kez kullanılabilir ve 60 dakika sonra süresi dolar. Ödeme onaylanana kadar API çağrıları 401 döner.

5. Anahtar kullanılabilir hale kadar bekleme. poll_after_seconds arasında çağrılar yapın:

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 olduğunda API’yi aramaya başlayın. Tamamlanmış bir ödeme sayfası yalnızca Kredilerin eklendiğini belirtmez. latest_purchase.status ödeme onaylanana kadar pending kalır, ardından completed olur. Ödenmemiş bir ödeme expired olur ve reddedilen gecikmiş bir ödeme failed olur. poll_after_seconds bir şey beklemediğinde null olur.

API’yi çağırın

Kullanılabilir bir misafir anahtarı her noktada çalışır ve hesap anahtarları gibi aynı hız sınırları ve faturalandırma ile:

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

Krediler tükendiğinde istekler 403 ile No available credits! döner. Cüzdanı yükseltmek için devam etmek için cüzdanı yükseltin.

Cüzdanı yükseltin

Yükseltmeler, aynı cüzdana ve anahtara Krediler ekler. Kullanıcıya tekrar miktarı onaylayın, ardından yeni bir UUID v4 gönderin:

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

Cevap, yeni bir checkout_url içerir. Kullanıcıya bu bağlantıyı verin, ardından aynı durum endpoint’ine kadar latest_purchase.status completed olana kadar bekleme yapın.

Anahtar olmayan istekler

Herhangi bir TwexAPI noktasına kimlik bilgisi olmayan bir istek 403 ile WWW-Authenticate: Bearer realm="twexapi" başlığı döner. Normal code, msg ve data alanları, erişim sağlama yollarını içeren auth_options nesnesi ile takip edilir, bu da misafir cüzdanı oluşturmayı da içerir:

{
  "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, bir agentinin ne olabileceğini belirtir. Bu, harcama izni değildir: agente yine de kullanıcıdan bir miktar için onay alınması gerekmektedir.

MCP ile misafir anahtarı kullanımı

Cüzdan kullanılabilir hale geldikten sonra, MCP istemcisini https://api.twexapi.io/mcp ile bağlayın ve Authorization: Bearer başlığına misafir anahtarını ekleyin, MCP genel bakış sayfasında açıklandığı gibi. Cüzdan oluşturma, yükseltme ve durum kontrolü REST-üzerine yalnızca; MCP araçları için bunlar yoktur.

Hatalar

Tutarlılık ve güvenli yeniden denemeler

Her oluşturma ve yükseltme talebi için Idempotency-Key’e kendi UUID v4’sini gerektirir. Bir istek zaman aşımına uğradığında, aynı anahtarla değişmeden yeniden gönderin: eski sonuç alırsınız ve ikinci bir ödeme sayfası oluşturulmaz. Farklı bir miktar veya farklı bir istek için bir anahtar yeniden kullanıldığında 422 döner.

Cüzdan erişimini koruyun

• Misafir anahtarı ve Idempotency-Key değerlerini URL’ler, günlükler ve sohbet transkryplerinden çıkarmak. Bir oluşturma talebi, Idempotency-Key ile tekrar oynatıldığında API anahtarını tekrar döner.
• Cevaplar Cache-Control: no-store, private ile gönderilir. Onları önbelleğe almamak.
• Durum endpoint’inden usable’ı, ödeme sayfasından önce API’yi çağırmadan güvenmek.
• Bir ödeme itiraz edildiğinde, tüm cüzdan duraklatılır (paused: true) ve anahtar until durum çözülene kadar çalışmaz.

SSS

TwexAPI Twitter API’sini hesap açmadan kullanabilir miyim?

Evet. Misafir cüzdan, kayıt olmadan bir önceden ödenmiş API anahtarı sağlar ve MPP bir agentinin Tempo cüzdanına sahipse her istek başına ödeme yapmasına izin verir.

Bir AI agenti TwexAPI’yi kendi başına ödeyebilir mi?

Hayır. Misafir cüzdanı kullanamaz: bir kişi her zaman Stripe ödeme sayfasını öder. Tempo üzerinde kendi USDC’sine sahip bir agente, MPP ile her istek başına ödeme yapabilir.

Misafir anahtarı bazı noktalara sınırlı mı?

Hayır. Ödeme yapıldıktan sonra, bir misafir anahtarı her noktada ve MCP sunucusunda, hesap anahtarları gibi aynı fiyatlandırma ve hız sınırları ile çalışır.

Misafir cüzdanını daha sonra hesaba dönüştürebilir miyim?

Henüz değil. Misafir anahtarını ve yükseltmeyi kullanmaya devam edin veya yeni bir iş için hesap oluşturun ve yeni bir anahtar kullanın.

Sonraki adımlar

• Kimlik doğrulama için hesap API anahtarları
• Makine Ödeme Protokolü için ödeme başına erişim
• MCP genel bakış için AI istemcisi ile anahtar kullanımı
• Fiyatlandırma için Kredi maliyetleri