Skip to main content

令牌(API KEY)是什麼

令牌就是您呼叫 API易 時使用的 API KEY,格式以 sk- 開頭。它是您身份和權限的憑證,主要作用包括:

身份認證

每次 API 呼叫都需要攜帶令牌,用於驗證您的身份和賬戶。

額度與權限控制

可為單個令牌設定專屬額度、過期時間、可用模型和分組。

呼叫統計

每個令牌的消耗、剩餘額度、呼叫日誌都可獨立檢視。

靈活分配

可為不同專案、團隊成員建立獨立令牌,便於管理和隔離。
註冊後系統會自動生成一個預設令牌,開箱即用。您也可以按需建立多個新令牌。

如何建立令牌

1

進入令牌頁面

開啟頂部導航的「令牌」頁面:https://api.apiyi.com/token
2

點選「新增」

在頁面右上角點選「新增」按鈕,開啟建立令牌彈窗。
3

填寫令牌資訊

設定令牌名稱、額度(可開啟無限額度)、有效期(可設永不過期)、計費模式和分組(詳見下文)。
4

儲存並複製 KEY

儲存後,點選令牌右側的複製圖示,即可複製完整的 sk- 開頭的 KEY。
新增令牌
建立新令牌時不需要設定可用模型。採用白名單機制:不設定則該令牌可使用全站 400+ 模型;設定後則只能使用指定模型。詳見 令牌模型白名單

編輯令牌與檢視程式碼示例

點選令牌最右側「操作」列的管理選單(扳手圖示),即可展開全部操作: 令牌管理選單與請求示例
「請求示例」即程式碼示例入口。點選後會帶上當前令牌生成可直接執行的呼叫程式碼,無需手動拼接 KEY 和介面地址,適合快速測試和接入。

一個令牌多人共用,會限速嗎

經常有客戶問:“我一個令牌給多個人用,會被限速嗎?” 答案是:令牌本身沒有限速。限速跟隨的是賬戶的限速,與令牌數量、使用人數無關——一個令牌給 10 個人用,和 10 個令牌各給 1 個人用,限速效果完全相同。

RPM(每分鐘請求數)

一般來說,單個賬戶的限速在 100 RPM 以內都沒有問題,足以覆蓋絕大多數團隊和應用場景。

TPM(每分鐘 Token 數)

TPM 不考核,無需擔心單次請求上下文過長或併發 Token 量過大觸發限制。
多人共用令牌不影響速率,但從管理角度仍建議為不同成員或專案建立獨立令牌:便於分別設定額度、獨立檢視呼叫日誌和消耗統計。

什麼是分組

分組是令牌可選擇的”資源通道”。 不同分組對應不同的上游資源、可用模型範圍和計費倍率,開放給使用者自行選擇 簡單理解:同一個模型可能由多條上游通道提供,分組就是讓您選擇走哪條通道。不同的模型可能需要用到不同的分組,選對分組才能正常呼叫並享受對應的折扣。
絕大多數情況下使用**預設分組(Default)**即可,它模型齊全,覆蓋文本模型、NanoBanana 系列、Veo 3.1 等絕大部分模型。

預設分組與兜底分組

同一個令牌最多可設定 3 個分組1 個預設分組 + 2 個兜底分組

預設分組(主分組)

令牌優先使用的分組,通用絕大部分模型。每個令牌必須有 1 個預設分組。

兜底分組(備用)

當預設分組無法滿足請求時自動切換的備用通道,最多可設定 2 個,提高呼叫成功率。
選擇分組與兜底分組設定 在建立或編輯令牌的彈窗中:
  • 選擇分組:設定預設(主)分組,預設為 Default
  • 兜底分組:可新增 1~2 個備用分組,當主分組不可用時自動兜底
分組會影響令牌的計費倍率和可用模型,請根據實際使用的模型來選擇。不確定時保持預設 Default 即可。

不同模型對應不同分組

預設分組通用絕大部分模型,但部分模型(尤其是影片模型)需要切換到專屬分組才能呼叫:
呼叫 Sora 2 官轉、Wan&HappyHorse 等專屬分組模型時,若令牌沒有對應分組,會出現模型不可用的情況。建議將常用專屬分組設為兜底分組,或為這類模型單獨建立令牌。

分組一覽

下圖為系統提供的分組及說明(以控制台實際顯示為準): API易 令牌分組一覽
表格中的「組倍率」為人民幣計價的相對值,並非直接的美元折扣比例,無需深究。您只需選擇與所用模型匹配的分組即可;想了解倍率與價格的換算,請參考 系統裡模型的【倍率】是什麼?

相關文件

令牌計費模式

瞭解按量優先、按次優先等計費模式的區別。

令牌模型白名單

如何限制單個令牌可用的模型範圍。

模型倍率說明

理解倍率含義與價格計算規則。

呼叫日誌查詢

檢視每個令牌的呼叫記錄與消耗明細。