--- title: "Misafir Cüzdanlar" description: "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. :::warning Misafir cüzdan her zaman bir kişinin ödemesi gerektirir. Agenti ödeme sayfasını oluşturur ve bağlantıyı teslim eder; kart detaylarına asla erişmez. Kullanıcı miktarını onayladıktan sonra cüzdan oluşturun. ::: ## Erişim yöntemi seçin | Yöntem | Hesap | Kimlik Bilgisi | Kapsam | Ödeme | |---|---|---|---|---| | [Hesap API anahtarı](/tr/authentication) | Evet | `Authorization: Bearer ` | Her nokta ve MCP | Dashboard: kart, PayPal veya kripto | | [MCP oturum açma](/tr/mcp/oauth) | Evet | MCP istemcisinde OAuth | MCP araçları | Hesabın Kredileri | | Misafir cüzdan | Hayır | `Authorization: Bearer ` | Her nokta ve MCP | Kart, Stripe Checkout üzerinden önceden ödenmiş | | [MPP](/tr/mpp/machine-payments-protocol) | Hayır | `Authorization: Payment ` | 12 sayfalı okuma noktaları | Tempo üzerinde USDC, her istek başına | | [MPP](/tr/mpp/machine-payments-protocol) | Hayır | `Authorization: Payment ` | 12 sayfalı okuma noktaları | Tempo üzerinde USDC, her istek başına | 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](/tr/guides/pricing) sayfasını görüntüleyin. **2. Ödeme sayfasını oluşturun.** `Idempotency-Key` başlığına yeni bir UUID v4 gönderin: ```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. 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: ```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` 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: ```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"}' ``` 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: ```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"}' ``` 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: ```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`, 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ış](/tr/mcp/overview) 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 | Durum | Anlam | Ne Yapılmalı | |---|---|---| | `400` | Eksik veya geçersiz `Idempotency-Key`, `amount_minor` 1000–25000 dışında veya `usd` olmayan bir döviz | İsteki düzeltin | | `401` | Taşınabilir anahtar eksik veya misafir cüzdan anahtar değil | Adım 2'den misafir anahtarını gönderin | | `403` | Cüzdan duraklatılmış | Desteğe başvurun | | `409` | Yeniden denenen ödeme talebi, süresi dolan bir talebe çok yakındır | Yeni bir `Idempotency-Key` ile yeniden deneyin | | `422` | `Idempotency-Key` daha önce farklı bir istek için kullanılmış | Yeni bir UUID v4 kullanın | | `429` | Bir saate içinde bir IP adresinden çok fazla cüzdan oluşturuldu | Bekleyin ve yeniden deneyin | ## 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](/tr/mpp/machine-payments-protocol) 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](/tr/mpp/machine-payments-protocol) 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](/tr/authentication) için hesap API anahtarları - [Makine Ödeme Protokolü](/tr/mpp/machine-payments-protocol) için ödeme başına erişim - [MCP genel bakış](/tr/mcp/overview) için AI istemcisi ile anahtar kullanımı - [Fiyatlandırma](/tr/guides/pricing) için Kredi maliyetleri