請求與錯誤.

請求格式

查詢使用 GET；寫入使用 POST 與 Content-Type: application/json。依文檔將欄位放在路徑、查詢字串或 JSON 請求主體；未宣告欄位會被拒絕。回應直接是業務物件或陣列，不使用共用的 data 封裝。

每個新操作使用獨立 requestKey；重試同一操作時，保留原鍵值與完全相同的參數。202 或 pending:true 不代表完成。使用傳回的 taskKey、付款 ID 或訂單 ID 查詢；結果不明時不可重新購買。

錯誤通常使用 { error: string }。除了 HTTP 狀態，也要檢查端點結果：部分能力查詢以 HTTP 200 與 supported:false 表示不支援。錯誤文字不是穩定的機器錯誤碼。

請求範例

{ "error": "invalid request" }

HTTP API 與 MCP 各自以每 IP、每程序計算，每分鐘最多 120 次。HTTP 錢包驗證另外有每分鐘 10 次登入限制。429 回應附有 Retry-After: 60，請等待後再重試；此限制不是吞吐量保證。

各端點的分頁不同：歷史使用不透明游標、訊息每頁 8 筆、伺服器事件每頁 10 筆。USD 餘額與報價使用整數美分字串；方案的 monthlyFromUsd 與 totalUsd 是十進位美元字串，不可混用。

變更伺服器狀態、快照、防火牆或擁有權前，先閱讀該端點的警告。AI 終止或重裝除了確認，還需要一次性錢包授權。目前續約能力未整合；儲存自動續約偏好不會延長服務。