全部產品
Search
文件中心

Intelligent Speech Interaction:擷取Token

更新時間:Sep 29, 2026

Token是調用Intelligent Speech InteractionAPI的鑒權憑證。調用時需要攜帶有效Token,有效期間內可重複使用,無需每次調用都重新擷取。本文介紹擷取方式、有效期間及常見問題。

選擇擷取方式

擷取方式

適用情境

通過控制台擷取Token

臨時調試和測試。

通過SDK擷取Token

正式環境。應用使用AccessKey憑證,通過SDK擷取Token並按需重新整理。

通過OpenAPI擷取Token

所用程式設計語言沒有對應SDK,或需要自行控制相依元件。自行實現請求籤名和調用邏輯。

Token使用與有效期間

如何擷取Token的到期時間?

SDK或OpenAPI響應中的 ExpireTime 表示Token的到期時間,採用秒級Unix時間戳記。使用接收毫秒時間戳記的日期介面時,需先將該值乘以1000;展示時間可按應用需要選擇時區。

Token到期前應擷取新的Token。控制台擷取方式用於臨時調試;正式環境通過SDK或OpenAPI擷取Token,並根據 ExpireTime 管理重新整理時間。

是否可以擷取長期有效Token?

不提供長期有效Token。Token存在有效期間限制,需要在到期前重新擷取。

重新擷取Token會使舊Token失效嗎?

不會。重新擷取Token不會使舊Token立即失效,舊Token在其有效期間內仍可使用。

多個裝置可以共用Token嗎?

同一個Token在有效期間內可以重複使用,也可以供多個裝置使用。各裝置使用的Appkey與Token應屬於同一阿里雲帳號。

常見問題

調用Voice Messaging Service時報錯40020105如何處理?

Meta:APPKEY_NOT_EXIST:Appkey not exist! 表示Appkey不存在。檢查Appkey是否填寫正確,並確認專案與產生Token所用的AccessKey屬於同一阿里雲帳號。使用RAM使用者的AccessKey時,該使用者應屬於專案所在帳號,並具有相應NLS許可權。

可在Intelligent Speech Interaction控制台的全部專案頁面查看Appkey,在RAM控制台檢查AccessKey所屬身份及其許可權。

擷取Token返回為空白或null如何處理?

  1. 檢查AccessKey ID和AccessKey Secret是否正確,並查看介面返回的錯誤資訊。

  2. 確認帳號已開通Intelligent Speech Interaction服務。

  3. 使用RAM使用者時,確認已授予擷取Token要求的權限。AliyunNLSSpeechServiceAccess 包含 nls:CreateToken 許可權;已有 AliyunNLSFullAccess 時無需重複授予。

  4. 檢查系統時鐘是否準確,避免請求時間戳記與實際時間不一致。

服務狀態可在Intelligent Speech Interaction控制台查看;許可權可在RAM控制台管理。

授權操作請參見管理RAM使用者的許可權。

調用Voice Messaging Service時Token無效或返回403如何處理?

根據介面返回的錯誤碼和錯誤資訊,檢查Token是否填寫正確、是否已到期,以及是否與Appkey所屬帳號匹配。到期後需擷取新的Token。

擷取Token時報錯connect failed或Connection refused如何處理?

檢查擷取Token的Endpoint是否正確,並檢查網域名稱解析、HTTPS連接埠串連、代理和防火牆配置,確認運行環境能夠訪問該Endpoint。

Postman或SDK調用因時間不準確而失敗,如何處理?

檢查並同步系統時鐘。OpenAPI的 Timestamp 應使用當前UTC時間,格式為 yyyy-MM-dd'T'HH:mm:ss'Z',例如 2026-09-28T08:00:00Z。使用本地時間產生該參數時,需先轉換為UTC時間。

SDK通常根據系統時間產生請求時間戳記。作業系統或Postman可使用本地時區,保持系統時鐘準確即可。

自行構造請求時,如何處理簽名和SignatureNonce?

每次請求使用新的 SignatureNonce,不要重複使用。出現 Specified signature is not matched with our calculation 時,檢查AccessKey Secret、參數排序、URL編碼和簽名使用的HTTP方法是否與實際請求一致。

請求需使用AccessKey完成簽名。請求參數和簽名演算法請參見通過OpenAPI擷取Token。