核心概念

額度

你的餘額以美元計價。每次 API 呼叫依模型的 token 單價從餘額中扣減（見即時定價）；輸入與輸出 token 的價格可能不同。

API Key

標準 Key（sk-...）在 控制台 → Keys 建立，用於所有 API 呼叫的認證：

Authorization: Bearer sk-YOUR_KEY

Key 可命名、停用、刪除。用量日誌按 Key 歸屬，建議每個應用使用獨立的 Key。

Agent 憑證

Linkex 上的 Agent 是註冊到你帳戶的外部錢包（EVM 或 Solana），並配對一把專屬 API Key：

• 你只需簽名一次以證明錢包所有權——Linkex 不接觸私鑰，只儲存公開地址。
• Agent Key 可像普通 Key 一樣呼叫推理 API，並且可以建立綁定該 Agent 的 x402 充值訂單。
• 可選的消費上限（單筆／每日／總額，以美元計）在 Agent 自主充值時強制執行。
• 隨時可撤銷：一步操作即停用 Key 並解除錢包綁定。

詳見：Agent 憑證。

x402

x402 是圍繞 HTTP 狀態碼 402 Payment Required 建立的開放支付協議。Linkex 實作 x402 v2 的 exact 方案：

1. 建立充值訂單 → 收到 PaymentRequired 挑戰（challenge），精確描述應付內容（鏈、代幣、金額、收款地址）。
2. 用錢包簽署挑戰——免 Gas 授權（EIP-3009）、Permit2 簽名或 Solana 轉帳。
3. 將簽名後的 payload 提交到公開的支付端點。閘道驗證並在鏈上結算，然後為帳戶入帳。

任何 x402 v2 用戶端都能付款——包括 Binance Agentic Wallet 與 Coinbase x402 工具鏈。協議詳解：x402 協議。

訂單生命週期

充值訂單（所有通道）狀態流轉：

pending → settling → success | failed | expired

可透過 GET /api/user/topup/order/{trade_no} 輪詢任何訂單，x402 待付訂單另有專屬端點。