SDK または API を使用して Intelligent Speech Interaction (ISI) の音声認識および音声合成を利用するには、アカウント、サービス、プロジェクト、および認証情報を設定します。
手順
設定には 6 つのステップがあります。アカウントの準備、AccessKey ペアの作成、サービスの有効化、プロジェクトの管理、トークンの取得、およびサービスの統合です。アカウント、サービス、または認証情報がすでに利用可能な場合は、対応する作成ステップをスキップしてください。
ステップ 1:アカウントの準備
Alibaba Cloud アカウントを準備します。アカウントの設定とサービスの有効化の手順については、「Intelligent Speech Interaction (ISI) の有効化」をご参照ください。
コラボレーションの場合は、Alibaba Cloud アカウントのパスワードや AccessKey ペアを共有する代わりに、Resource Access Management (RAM) ユーザーを使用して権限を割り当ててください。手順については、「RAM ユーザーの作成」をご参照ください。
RAM ユーザーがサービスを呼び出す前に、必要な権限を付与してください。AliyunNLSFullAccess システムポリシーは、ISI へのフルアクセスを提供します。実際のニーズに基づいて権限を付与してください。手順については、「RAM ユーザーへの権限付与」をご参照ください。
ステップ 2:AccessKey ペアの作成
AccessKey ペアは、Alibaba Cloud API への呼び出しを認証します。これは、ユーザーを識別する AccessKey ID と、アイデンティティを検証する AccessKey シークレットで構成されます。既存の有効な AccessKey ペアを再利用できます。
RAM ユーザーの AccessKey ペア (推奨):Alibaba Cloud アカウントで RAM コンソールにサインインし、承認された RAM ユーザーの AccessKey ペアを作成します。手順については、「RAM ユーザーの AccessKey ペアの作成」をご参照ください。
Alibaba Cloud アカウントの AccessKey ペア:このペアはアカウントへのフルアクセスを提供するため、日常的な開発には推奨されません。必要な場合は、AccessKey 管理ページにアクセスし、「Alibaba Cloud アカウントの AccessKey ペアの作成」の手順に従ってください。
AccessKey シークレットは、ペアの作成時にのみ表示されます。安全に保管してください。公開コード、ログ、またはクライアントサイドのコードに含めないでください。
ステップ 3:サービスの有効化
Alibaba Cloud アカウントで必要なサービスを有効化します。手順については、「ISI の有効化」をご参照ください。
|
サービスエディション |
説明 |
|
無料トライアル |
一部のサービスでは、1 日あたり 2 つの同時呼び出しまたは 2 時間の録音ファイル認識を含む 3 か月間の無料トライアルを提供しています。クォータはサービスによって異なります。 |
|
商用版 |
有効化後の実際の使用量に基づいて課金されます。本番ワークロードまたは無料トライアルを提供していないサービスには、このエディションを使用してください。 |
トライアルクォータと料金については、「課金」をご参照ください。トライアル期間終了後もサービスを継続して使用するには、「商用版へのアップグレード」をご参照ください。
ステップ 4:プロジェクトの管理
プロジェクトを作成し、その Appkey を取得します。Appkey は、サービス呼び出しで使用されるプロジェクトを識別します。手順については、「プロジェクトの管理」をご参照ください。
ステップ 5:トークンの取得
アクセストークンは、Intelligent Speech Interaction サービスへのコールを認証します。その有効期限は、API から返される ExpireTime 値によって指定されます。トークンは有効な間、再利用してください。アプリケーションは、現在のトークンの有効期限が切れる前に新しいトークンを取得する必要があります。SDK の自動更新には依存しないでください。
|
方法 |
使用するタイミング |
|
AccessKey ペアを使用して SDK 経由でトークンを取得します。アプリケーションでトークンの更新を管理します。 |
|
|
プログラミング言語用の SDK が利用できない場合、または依存関係を直接管理する必要がある場合。 |
ステップ 6:サービスの統合
プロジェクトの Appkey と有効なトークンでサンプルを設定し、有効化されたサービスを呼び出します。トークンの取得に使用される AccessKey ペアには、プロジェクトを所有するアカウント配下のリソースにアクセスする権限が必要です。
SDK を使用してサービスを呼び出す例については、「SDK の実行」をご参照ください。