API 接入說明

三步接入

1. 在用戶中心領取月卡並複製客戶 Key。不要使用管理員 Key 或 Magpie 內部 Key。
2. 將客戶端設為 OpenAI 兼容 Chat Completions，Base URL 使用用戶中心顯示的 /v1 地址。
3. 從用戶中心的可用模型列表選擇用途組。首頁的公開目錄列出各組的模型名單；組名和名單可能由管理員更新。

本站按請求的 model 路由。任務拆分和為子任務選擇用途組需要由支持該能力的客戶端完成。一個組可以連接多個上游；故障線路會短暫冷卻，進行中的生成不會自動重試。

已支持與限制

支持聊天 JSON、流式 SSE 和工具調用字段透傳。不支持原生 Claude Messages 或 Codex Responses；客戶端支持 OpenAI 聊天並不代表其所有功能都兼容。輸出上限為 1 至 8192；只提供 max_tokens 或 max_completion_tokens 中的一個，缺省為 4096。

所有用途組共用賬號額度。每日額度在 UTC 00:00 重置（越南時間 07:00），小時額度和請求頻率仍按滾動窗口計算。跨日請求計入開始調用的 UTC 日期。暫停或換 Key 不會清空用量，暫停也不延長月卡。明確拒絕不計 Token；流中斷或缺少 usage 會標記為估算。請在用戶中心查看剩餘天數和今日（UTC）用量。

出錯時

401 通常需要檢查客戶 Key 與月卡狀態；429 表示賬號或上游限額；502/503/504 表示上游錯誤、容量保護或超時。更換請求 ID 後盲目重試可能重複消耗，流中斷尤其需要確認結果。

在 用戶中心 的支持入口提交時間和請求 ID，勿提交 Key 或完整敏感提示詞。