令牌(API KEY)是什麼
令牌就是您呼叫 API易 時使用的 API KEY,格式以sk- 開頭。它是您身份和權限的憑證,主要作用包括:
身份認證
每次 API 呼叫都需要攜帶令牌,用於驗證您的身份和賬戶。
額度與權限控制
可為單個令牌設定專屬額度、過期時間、可用模型和分組。
呼叫統計
每個令牌的消耗、剩餘額度、呼叫日誌都可獨立檢視。
靈活分配
可為不同專案、團隊成員建立獨立令牌,便於管理和隔離。
註冊後系統會自動生成一個預設令牌,開箱即用。您也可以按需建立多個新令牌。
如何建立令牌
1
進入令牌頁面
開啟頂部導航的「令牌」頁面:https://api.apiyi.com/token
2
點選「新增」
在頁面右上角點選「新增」按鈕,開啟建立令牌彈窗。
3
填寫令牌資訊
設定令牌名稱、額度(可開啟無限額度)、有效期(可設永不過期)、計費模式和分組(詳見下文)。
4
儲存並複製 KEY
儲存後,點選令牌右側的複製圖示,即可複製完整的
sk- 開頭的 KEY。
編輯令牌與檢視程式碼示例
點選令牌最右側「操作」列的管理選單(扳手圖示),即可展開全部操作:
「請求示例」即程式碼示例入口。點選後會帶上當前令牌生成可直接執行的呼叫程式碼,無需手動拼接 KEY 和介面地址,適合快速測試和接入。
一個令牌多人共用,會限速嗎
經常有客戶問:“我一個令牌給多個人用,會被限速嗎?” 答案是:令牌本身沒有限速。限速跟隨的是賬戶的限速,與令牌數量、使用人數無關——一個令牌給 10 個人用,和 10 個令牌各給 1 個人用,限速效果完全相同。RPM(每分鐘請求數)
一般來說,單個賬戶的限速在 100 RPM 以內都沒有問題,足以覆蓋絕大多數團隊和應用場景。
TPM(每分鐘 Token 數)
TPM 不考核,無需擔心單次請求上下文過長或併發 Token 量過大觸發限制。
什麼是分組
分組是令牌可選擇的”資源通道”。 不同分組對應不同的上游資源、可用模型範圍和計費倍率,開放給使用者自行選擇。 簡單理解:同一個模型可能由多條上游通道提供,分組就是讓您選擇走哪條通道。不同的模型可能需要用到不同的分組,選對分組才能正常呼叫並享受對應的折扣。絕大多數情況下使用**預設分組(Default)**即可,它模型齊全,覆蓋文本模型、NanoBanana 系列、Veo 3.1 等絕大部分模型。
預設分組與兜底分組
同一個令牌最多可設定 3 個分組:1 個預設分組 + 2 個兜底分組。預設分組(主分組)
令牌優先使用的分組,通用絕大部分模型。每個令牌必須有 1 個預設分組。
兜底分組(備用)
當預設分組無法滿足請求時自動切換的備用通道,最多可設定 2 個,提高呼叫成功率。

- 選擇分組:設定預設(主)分組,預設為
Default - 兜底分組:可新增 1~2 個備用分組,當主分組不可用時自動兜底
不同模型對應不同分組
預設分組通用絕大部分模型,但部分模型(尤其是影片模型)需要切換到專屬分組才能呼叫:分組一覽
下圖為系統提供的分組及說明(以控制台實際顯示為準):
表格中的「組倍率」為人民幣計價的相對值,並非直接的美元折扣比例,無需深究。您只需選擇與所用模型匹配的分組即可;想了解倍率與價格的換算,請參考 系統裡模型的【倍率】是什麼?。
相關文件
令牌計費模式
瞭解按量優先、按次優先等計費模式的區別。
令牌模型白名單
如何限制單個令牌可用的模型範圍。
模型倍率說明
理解倍率含義與價格計算規則。
呼叫日誌查詢
檢視每個令牌的呼叫記錄與消耗明細。