全部產品
Search
文件中心

Intelligent Speech Interaction:通過SDK擷取Token

更新時間:Sep 29, 2026

在服務端通過 SDK 擷取 Token,可避免在移動端應用中儲存長期 AccessKey。SDK 封裝請求籤名,應用負責儲存 Token、檢查有效期間並在到期前重新擷取。

背景資訊

按專案使用的 SDK 選擇一種擷取方式,無需同時整合兩種 SDK。

擷取方式

適用情境

Intelligent Speech Interaction SDK

已整合相應 SDK,使用封裝的 Token 請求類。

阿里雲公用 SDK

使用公用 SDK 調用 CreateToken,按專案語言選擇樣本。

配置訪問憑證

準備已開通Intelligent Speech Interaction服務的帳號及具有要求的權限的 AccessKey ID 和 AccessKey Secret。服務開通和憑證準備方法,請參見快速開始。

擷取 Token 使用的是 AccessKey,不是百鍊 API Key。將 AccessKey 配置到運行樣本的進程環境中:ALIYUN_AK_ID 對應 AccessKey ID,ALIYUN_AK_SECRET 對應 AccessKey Secret。

重要

AccessKey 僅儲存在可信的服務端環境,不寫入原始碼或移動端應用。移動端調用Voice Messaging Service前,先向商務服務端請求 Token。樣本只輸出擷取結果和到期時間,不輸出 Token 本身;不要將 AccessKey、Token 或帶簽名的完整請求寫入日誌。

通過Intelligent Speech Interaction SDK 擷取 Token

Java

添加 Maven 依賴。樣本使用 nls-sdk-common 2.1.6;在 JDK 21 下運行時,還需添加 JAXB API 依賴。

<dependency>
    <groupId>com.alibaba.nls</groupId>
    <artifactId>nls-sdk-common</artifactId>
    <version>2.1.6</version>
</dependency>
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>

調用 apply() 發起請求,再讀取 getToken() 和 getExpireTime()。此請求類不會自動定時重新整理 Token。

import com.alibaba.nls.client.AccessToken;

public class NlsTokenDemo {
    public static void main(String[] args) throws Exception {
        AccessToken request = new AccessToken(
                System.getenv("ALIYUN_AK_ID"),
                System.getenv("ALIYUN_AK_SECRET"),
                "nlsmeta.ap-southeast-1.aliyuncs.com",
                "ap-southeast-1", "2019-07-17");

        request.apply();
        String token = request.getToken();
        long expireTime = request.getExpireTime();
        System.out.println("Token acquired: " + (token != null && !token.isEmpty()));
        System.out.println("ExpireTime (Unix seconds): " + expireTime);
    }
}

通過阿里雲公用 SDK 擷取 Token

公用 SDK 的 RPC 請求使用以下參數。網域名稱、地區和 API 版本需配套使用,不能只修改其中一項。

參數

配置值

說明

domain

nlsmeta.ap-southeast-1.aliyuncs.com

擷取 Token 的網域名稱。

region_id

ap-southeast-1

請求地區。

action

CreateToken

介面名稱。

version

2019-07-17

RPC API 版本。

Java

添加 Maven 依賴。樣本使用 aliyun-java-sdk-core 3.7.1 和 fastjson 1.2.83;JDK 21 還需 JAXB API 2.3.1。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>3.7.1</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;

public class CreateTokenDemo {
    public static void main(String[] args) throws Exception {
        DefaultProfile profile = DefaultProfile.getProfile(
                "ap-southeast-1", System.getenv("ALIYUN_AK_ID"),
                System.getenv("ALIYUN_AK_SECRET"));
        DefaultAcsClient client = new DefaultAcsClient(profile);

        CommonRequest request = new CommonRequest();
        request.setDomain("nlsmeta.ap-southeast-1.aliyuncs.com");
        request.setVersion("2019-07-17");
        request.setAction("CreateToken");
        request.setMethod(MethodType.POST);
        request.setProtocol(ProtocolType.HTTPS);

        CommonResponse response = client.getCommonResponse(request);
        JSONObject result = JSON.parseObject(response.getData()).getJSONObject("Token");
        String token = result.getString("Id");
        long expireTime = result.getLongValue("ExpireTime");
        System.out.println("Token acquired: " + (token != null && !token.isEmpty()));
        System.out.println("ExpireTime (Unix seconds): " + expireTime);
    }
}

Python

安裝依賴。樣本使用 aliyun-python-sdk-core 2.15.1。

pip install aliyun-python-sdk-core
import json
import os

from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest

client = AcsClient(
    os.environ["ALIYUN_AK_ID"],
    os.environ["ALIYUN_AK_SECRET"],
    "ap-southeast-1",
)

request = CommonRequest()
request.set_method("POST")
request.set_protocol_type("https")
request.set_domain("nlsmeta.ap-southeast-1.aliyuncs.com")
request.set_version("2019-07-17")
request.set_action_name("CreateToken")

result = json.loads(client.do_action_with_exception(request))
token = result["Token"]["Id"]
expire_time = result["Token"]["ExpireTime"]
print("Token acquired:", bool(token))
print("ExpireTime (Unix seconds):", expire_time)

Go

在 Go 模組中安裝依賴。樣本使用 alibaba-cloud-sdk-go 1.63.107。

go get github.com/aliyun/alibaba-cloud-sdk-go/sdk
package main

import (
    "encoding/json"
    "fmt"
    "os"

    "github.com/aliyun/alibaba-cloud-sdk-go/sdk"
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk/auth/credentials"
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
)

func main() {
    credential := credentials.NewAccessKeyCredential(
        os.Getenv("ALIYUN_AK_ID"), os.Getenv("ALIYUN_AK_SECRET"))
    client, err := sdk.NewClientWithOptions("ap-southeast-1", sdk.NewConfig(), credential)
    if err != nil {
        panic(err)
    }

    request := requests.NewCommonRequest()
    request.Scheme = "HTTPS"
    request.Method = "POST"
    request.Domain = "nlsmeta.ap-southeast-1.aliyuncs.com"
    request.ApiName = "CreateToken"
    request.Version = "2019-07-17"
    response, err := client.ProcessCommonRequest(request)
    if err != nil {
        panic(err)
    }

    var result struct {
        Token struct {
            Id string
            ExpireTime int64
        }
    }
    if err := json.Unmarshal(response.GetHttpContentBytes(), &result); err != nil {
        panic(err)
    }
    token := result.Token.Id
    fmt.Println("Token acquired:", token != "")
    fmt.Println("ExpireTime (Unix seconds):", result.Token.ExpireTime)
}

PHP

使用 PHP 7.2 及以上版本,並通過 Composer 安裝依賴。樣本使用 alibabacloud/sdk 1.8.2345 和 alibabacloud/client 1.5.32。

composer require alibabacloud/sdk

此樣本使用公用 RPC 請求,顯式設定網域名稱、API 版本和要求方法。

<?php
require __DIR__ . '/vendor/autoload.php';

use AlibabaCloud\Client\AlibabaCloud;

AlibabaCloud::accessKeyClient(
    getenv('ALIYUN_AK_ID'), getenv('ALIYUN_AK_SECRET'))
    ->regionId('ap-southeast-1')
    ->asDefaultClient();

$response = AlibabaCloud::rpc()
    ->product('nls-cloud-meta')
    ->version('2019-07-17')
    ->action('CreateToken')
    ->host('nlsmeta.ap-southeast-1.aliyuncs.com')
    ->scheme('https')
    ->method('POST')
    ->request();

$token = $response['Token']['Id'];
$expireTime = $response['Token']['ExpireTime'];
echo 'Token acquired: ' . (!empty($token) ? 'true' : 'false') . PHP_EOL;
echo 'ExpireTime (Unix seconds): ' . $expireTime . PHP_EOL;

Node.js

安裝依賴。樣本使用 @alicloud/pop-core 1.8.0。

npm install @alicloud/pop-core
const { RPCClient } = require('@alicloud/pop-core');

const client = new RPCClient({
  accessKeyId: process.env.ALIYUN_AK_ID,
  accessKeySecret: process.env.ALIYUN_AK_SECRET,
  endpoint: 'https://nlsmeta.ap-southeast-1.aliyuncs.com',
  apiVersion: '2019-07-17',
});

async function main() {
  const result = await client.request('CreateToken', {}, { method: 'POST' });
  const token = result.Token.Id;
  const expireTime = result.Token.ExpireTime;
  console.log('Token acquired:', Boolean(token));
  console.log('ExpireTime (Unix seconds):', expireTime);
}

main().catch((error) => {
  console.error('CreateToken failed:', error.code || error.name);
  process.exitCode = 1;
});

傳回值與使用建議

公用 SDK 請求成功後,從響應的 Token 對象讀取以下欄位;NLS Java 請求類通過對應方法返回這些值。

欄位

類型

說明

Id

String

Token 字串,用於後續Voice Messaging Service請求。NLS Java 對應 getToken()。

ExpireTime

Long

到期時間的 Unix 時間戳記,單位為秒。NLS Java 對應 getExpireTime()。

  • 緩衝 Token 並在有效期間內複用,不必在每次Voice Messaging Service請求前重新擷取。根據返回的 ExpireTime 判斷有效期間,在到期前重新擷取並更新緩衝,不使用固定時間長度代替傳回值。

  • 在可信環境中,同一個 Token 可以供多個進程或應用使用。使用本頁配置的端點擷取 Token,不要混用上海和新加坡端點簽發的 Token。

  • 將 Id 字串傳給Voice Messaging Service,不傳整個 JSON 響應、AccessKey 或其他欄位。具體傳遞位置遵循相應語音介面的鑒權要求。

常見問題

擷取 Token 失敗時如何排查?

根據 SDK 返回的錯誤碼區分原因,不將所有鑒權錯誤都歸為 AccessKey 配對問題。

錯誤碼

排查方法

InvalidAccessKeyId.NotFound

檢查 AccessKey ID 是否正確、是否屬於預期身份,以及複製時是否包含空格。

SignatureDoesNotMatch

檢查 AccessKey ID 與 AccessKey Secret 是否配對,以及參與簽名的參數是否被修改。使用公用 SDK 構造請求,避免自行拼裝簽名。

InvalidTimeStamp.Expired

檢查發起請求的系統時間,確保與標準時間同步。此錯誤屬於請求時間戳記問題,不等同於已經擷取的 Token 到期。

InvalidVersion

核對請求網域名稱和 API 版本,並區分 RPC 與 ROA。PHP 樣本的請求形式需與其 API 版本配套。

擷取 Token 後,語音介面提示 Token 無效怎麼辦?

40000001 是Voice Messaging Service調用階段的鑒權錯誤。檢查是否傳入了實際 Token 字串、是否遺漏鑒權參數、Token 是否已到期,以及 Token 的簽發端點是否與所調用的Voice Messaging Service匹配。相同錯誤碼可能對應多種原因,應結合完整錯誤資訊判斷。

出現 Not supported proxy scheme 如何處理?

檢查 http_proxy、https_proxy 及程式中設定的代理。Proxy 位址需使用 SDK 支援的協議,並確保地址、連接埠和代理服務可用。如果當前網路不需要代理,移除相關配置後重試。

相關文檔