ให้ AI agent ชำระเงินด้วย OKXและสมัครเอง
จ่ายด้วย OKX Wallet ผ่าน x402 แล้วรับ API key และยอดคงเหลือในคำขอเดียว
- USD₮0 บน X Layer ชำระบัญชีผ่าน OKX
- ไม่ต้องใช้บัตรเครดิตหรือแบบฟอร์มสมัคร
- ผู้ใช้ทั่วไปก็เติมเงินด้วย x402 ได้
curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
-H "Content-Type: application/json" \
-d '{"name":"my-agent","amountUsd":1.1}'HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"x402Version": 2,
"resource": {
"url": "https://bazaarlink.ai/api/v1/agents/register/x402",
"description": "BazaarLink paid agent registration",
"mimeType": "application/json"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:196",
"payTo": "0xPAY_TO_ADDRESS",
"asset": "0xASSET_CONTRACT",
"amount": "1100000",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD₮0", "version": "1" }
}
]
}x402 คืออะไร
- POST
/api/v1/agents/register/x402 - ← 402
accepts[ network, asset, amount, payTo ] - sign
EIP-3009 - POST
X-PAYMENT: … - ← 201
api_key, credits, claim_token
การชำระเงินชำระบัญชีผ่าน x402 facilitator ของ OKX บน X Layer และเซิร์ฟเวอร์จะตรวจสอบทุกรายการก่อนดำเนินการ
HTTP 402 ขอให้ชำระเงิน
เซิร์ฟเวอร์ตอบกลับด้วย 402 และระบุเครือข่าย สินทรัพย์ จำนวนเงิน และที่อยู่ผู้รับที่รองรับ ไคลเอนต์เซ็นการอนุมัติการชำระเงินแล้วส่งคำขอเดิมอีกครั้ง BazaarLink ชำระบัญชีแต่ละรายการผ่าน x402 facilitator ของ OKX บน X Layer
api_keysk-bl-…credits5claim_token…payment.txHash0x…ไม่ต้องมีบัญชีก่อน
agent ไม่ต้องกรอกแบบฟอร์มหรือสร้างบัญชีล่วงหน้า คำขอที่แนบการชำระเงินจะสร้างบัญชี ออก API key และเพิ่มยอดคงเหลือให้
สี่ขั้นตอนจากคำขอถึง API key
ส่งคำขอ
POST ไปที่ /api/v1/agents/register/x402 พร้อมชื่อและจำนวนเงินดอลลาร์สหรัฐที่ต้องการจ่าย
รับ 402
เซิร์ฟเวอร์ตอบ 402 พร้อมเงื่อนไขการชำระเงิน ขั้นตอนนี้ยังไม่มีการสร้างอะไร
เซ็นแล้วส่งอีกครั้ง
ใช้วอลเล็ตของคุณเซ็นการอนุมัติการชำระเงิน ใส่ไว้ในเฮดเดอร์ X-PAYMENT แล้วส่งคำขอเดิมอีกครั้ง
รับ API key
หลังยืนยันการชำระเงิน คุณจะได้รับ 201 ที่มี API key ยอดคงเหลือ และลิงก์รับสิทธิ์ API key จะแสดงเฉพาะในการตอบกลับนี้ จึงควรเก็บทันที
มีบัญชีแล้วใช่ไหม เติมเงินด้วย x402 ได้เช่นกัน
agent ใช้ API key ที่มีอยู่ ผู้ใช้ทั่วไปเข้าสู่ระบบแล้วเติมเงินจากหน้าเครดิต
Agent และสคริปต์
POST ไปที่ /api/x402/topup พร้อมเฮดเดอร์ Authorization และ amountUsd ขั้นตอนเหมือนการสมัคร: ขอราคา เซ็น และส่งอีกครั้ง
ผู้ใช้ทั่วไป
เข้าสู่ระบบ เปิดหน้าเครดิต เลือก x402 แล้วเซ็นการชำระเงินด้วยวอลเล็ตในเบราว์เซอร์
เครือข่ายและสินทรัพย์ที่รองรับ
ขณะนี้รองรับหนึ่งชุดเท่านั้น
- เครือข่าย
- X Layer ชำระบัญชีผ่าน x402 facilitator ของ OKX
- สินทรัพย์
- USD₮0
- ยอดคงเหลือ
- มีค่าธรรมเนียมเติมเงินของแพลตฟอร์ม ยอดเงินที่ได้รับจึงน้อยกว่าจำนวนที่จ่าย (ดูหน้าราคา)
- จำนวนต่อการชำระเงิน
- มีจำนวนขั้นต่ำและสูงสุด ดูขีดจำกัดปัจจุบันได้จากการตอบกลับ 402 และ GET /api/x402/topup
การชำระเงินบนเชนไม่สามารถย้อนกลับได้ ตรวจสอบจำนวนเงินและเครือข่ายก่อนเซ็น
ยังไม่จ่ายเงินใช่ไหม โมเดลฟรียังใช้งานได้
บัญชี agent ที่ยังไม่จ่ายเงินใช้โควตาโมเดลฟรีและขีดจำกัดอัตราที่มีอยู่ (auto:free) หลังจ่ายเงิน บัญชีจะใช้กฎปกติของบัญชีแบบชำระเงิน
คำถามที่พบบ่อย
x402 คืออะไร
x402 คือโปรโตคอลที่ใช้รหัสสถานะ HTTP 402 เพื่อขอการชำระเงิน เซิร์ฟเวอร์ระบุจำนวนเงิน เครือข่าย และที่อยู่ผู้รับ ไคลเอนต์เซ็นการอนุมัติแล้วส่งคำขอเดิมอีกครั้ง
ต้องใช้อะไรในการจ่ายด้วย x402
OKX Wallet หรือคีย์วอลเล็ตใดก็ได้ที่เซ็นการอนุมัติ EIP-3009 ได้ พร้อม USD₮0 บน X Layer เอกสารการเชื่อมต่อมีโค้ด TypeScript ที่ใช้ไคลเอนต์ x402 สำหรับการเซ็น
รองรับเครือข่ายและสินทรัพย์ใดบ้าง
USD₮0 บน X Layer ชำระผ่าน x402 facilitator ของ OKX มีค่าธรรมเนียมเติมเงินของแพลตฟอร์ม ยอดเงินที่ได้รับจึงน้อยกว่าจำนวนที่จ่าย ดูรายละเอียดที่หน้าราคา
ถ้าจ่ายเงินหรือส่งซ้ำสองครั้งจะเกิดอะไรขึ้น
แต่ละการชำระเงินจะถูกเพิ่มยอดเพียงครั้งเดียว การส่งการชำระเงินเดิมซ้ำเพื่อเติมเงินจะคืนค่า already_credited การสมัครจะคืนผลเดิมนาน 15 นาที หลังจากนั้นจะได้ already_registered และจะไม่แสดง API key ซ้ำ
ขอเงินคืนได้ไหม
การชำระเงินบนเชนไม่สามารถย้อนกลับได้ และระบบจะไม่คืนเงินอัตโนมัติ หากเกิดปัญหาให้ติดต่อฝ่ายช่วยเหลือ
การสมัครมีขีดจำกัดไหม
มี การสมัครจากแหล่งเครือข่ายเดียวกันมีขีดจำกัดในช่วงเวลาสั้น ๆ เมื่อถึงขีดจำกัดจะได้รับ 429 พร้อมเฮดเดอร์ Retry-After ให้รอแล้วลองใหม่
คนสามารถรับช่วงต่อบัญชี agent ได้ไหม
ได้ การตอบกลับการสมัครมี claim_token และ upgrade_url คนสามารถเข้าสู่ระบบและรับช่วงบัญชี จากนั้น API key กับยอดคงเหลือจะย้ายไปยังบัญชีนั้น claim_expires ระบุเส้นตาย