サービス、リージョン、ネットワーク環境に基づいて Intelligent Speech Interaction (ISI) のエンドポイントを選択し、そのエンドポイントで必要となる認証情報を設定します。
エンドポイントの選択
ドメイン名はサービスのエンドポイントを識別します。完全なリクエスト URL には、プロトコルと API パスも含まれます。サービスには完全な URL を使用してください。ドメイン名のみを変更しても、API パスや認証の違いは反映されません。
サービスを呼び出すには、Singapore のエンドポイントを使用します。クライアントはエンドポイントに到達でき、対応するアプリケーションキーとトークンを使用できる必要があります。
パブリックネットワークアクセス：オンプレミスサーバー、他のクラウド上のサーバー、またはインターネットへのアウトバウンド接続が可能な ECS インスタンスから、パブリックエンドポイントを使用します。NLS の呼び出しに専用のパブリック受信アドレスは不要です。ただし、実行環境は引き続きアウトバウンド接続を提供し、必要なプロトコルとポートを許可する必要があります。
サービスエンドポイント
短文音声認識、リアルタイム音声認識、短文音声合成
WebSocket API は /ws/v1 パスを使用します。メッセージの名前空間とパラメーターはサービスによって異なります。サービスが同じ URL を共有している場合でも、メッセージプロトコルに互換性はありません。
|
ネットワーク |
リージョン |
WebSocket URL |
|
Public |
Singapore |
|
短文音声認識と短文音声合成は RESTful API もサポートしています。次の表に完全な URL を示します。リアルタイム音声認識では、これら 2 つの RESTful パスは使用しません。
|
サービス |
リージョン |
RESTful URL |
|
短文音声認識 |
Singapore |
|
|
短文音声合成 |
|
認証とリージョン設定
トークンサービスと音声ゲートウェイでは、異なるエンドポイントを使用します。トークンベースの認証を使用する音声 API を呼び出す前に、トークンを取得してください。手順については、「SDK を使用してトークンを取得する」をご参照ください。
nlsmeta.ap-southeast-1.aliyuncs.com からトークンを取得し、 nls-gateway-ap-southeast-1.aliyuncs.com 経由で音声サービスを呼び出します。 トークンリクエストのリージョンを ap-southeast-1 に設定します。
トークン API から返される ExpireTime 値は、トークンの有効期限を指定します。リージョンとドメインを正しく設定しても、サービスは有効化されません。コールを行う前に、必要なサービスが有効化されていることを確認してください。