簡短回答
個人訪問令牌是新版控制台推出的「管理介面憑證」,用來讓指令碼或自動化工具呼叫餘額查詢、日誌查詢、令牌管理這類介面。 它取代原來的系統令牌:可以只勾選需要的權限、設定到期時間、限定 IP 白名單,一個賬號最多可建 20 個,按用途分開發放。個人訪問令牌不能呼叫模型。呼叫模型請繼續使用 API Key(控制台裡叫「模型金鑰」,
sk- 開頭)。與系統令牌有什麼不同
如何建立
1
打開個人訪問令牌
登入控制台,進入個人中心
api.apiyi.com/account/profile,在「賬戶選項」裡點選 個人訪問令牌,再點右上角 建立令牌。2
填寫名稱與到期時間
名稱按用途寫,方便日後識別,例如「對賬指令碼」「餘額監控」。到期時間預設 30 天,到期後令牌自動失效,建議選久一點(如 365 天),免得指令碼突然中斷。
3
設定 IP 白名單(可選)
多個地址用英文逗號分隔,支援 IPv4、IPv6 或 CIDR,留空表示不限制。白名單建立後不能修改,做法見下文。
4
勾選權限
只勾你的指令碼用得到的權限,對照表見下文。
5
建立並儲存令牌
點選 建立令牌,立即複製並妥善儲存。



該勾選哪些權限
權限分為「讀取」「寫入」「檢視金鑰」三種,相互獨立:勾了寫入不等於能讀取,勾了讀取也看不到金鑰明文。
例如只做每日對賬,勾「用量與個人記錄 · 讀取」一項就夠了;餘額監控只勾「個人資料 · 讀取」。
修改密碼、兩步驗證這類需要安全驗證的操作,仍須登入網頁完成,個人訪問令牌勾了寫入也做不了。
IP 白名單怎麼設才不踩坑
白名單建立後不能修改,要改只能新建一把。推薦的順序:- 先建一把不填白名單的令牌,把指令碼調通。
- 確認能用後,再建一把帶白名單的正式令牌。把可能用到的出口 IP 都填上:生產伺服器、備用伺服器、需要臨時排查時用的辦公網路等。
- 換上正式令牌,刪除那把不帶白名單的測試令牌。
怎麼呼叫
用法與系統令牌完全相同:請求頭Authorization 填令牌本身,加不加 Bearer 字首都可以。
常見報錯
相關文件
餘額查詢 API
用個人訪問令牌查詢賬戶餘額
日誌查詢 API
按時間段拉取呼叫明細做對賬
令牌管理 API
程式化建立、輪換和刪除 API Key
如何安全地管理 API Key?
API Key 的權限邊界與防洩漏