学習のための API

mimi SRS を利用するには、事前に話者グループや話者を登録し、音声を学習させておく必要があります。ここで説明するAPIを利用し、事前準備を行います。

接続情報

ドメイン


https://apis.mimi.fd.ai/

ベース URL


/v1/applications/<applicationId>/clients/<clientId>/

ただし「<変数名>」の表記は、変数に置き換えて下さい。

applicationId と clientId は、mimi SRS サービスを利用するために作成されたアプリケーションとクライアントの ID です。
事前準備として、mimi API Console や mimi API で、 mimi SRS サービスや API を利用するためのアプリケーションとクライアントを作成して ID を取得しておいてください。注意事項として、アプリケーションやクライアントを作成する際には、mimi SRS サービスや API の利用に合わせて必要な範囲( scope )を設定するようにしてください。

Authorization

全ての HTTP リクエストの際に、事前に発行しておいた mimi のアクセストークンをBearer トークン(アクセストークン)として与えて下さい。注意事項として、mimi SRS サービスやAPIの利用に合わせて必要な範囲(scope)の権限を付与されたアクセストークンを発行し使用するようにしてください。


Authorization: Bearer <accessToken>

API 一覧

詳細については、各 API の API Reference を参照してください。

話者グループの API

API Reference	概要
話者グループの一覧を取得する	GET /srs/speaker_groups returns 話者グループリソース
話者グループを取得する	GET /srs/speaker_groups/<speakerGroupId> returns 話者グループリソース
話者グループを作成する	POST /srs/speaker_groups returns オペレーションリソース
話者グループを変更する	PUT /srs/speaker_groups/<speakerGroupId> returns オペレーションリソース
話者グループを削除する	DELETE /srs/speaker_groups/<speakerGroupId> returns オペレーションリソース
話者グループに登録された話者の一覧を取得する	GET /srs/speaker_groups/<speakerGroupId>/speakers returns 話者リソース
指定された話者グループへの指定された話者の登録	POST /srs/speaker_groups/<speakerGroupId>/speakers/ returns オペレーションリソース
話者グループから話者を削除する	DELETE /srs/speaker_groups/<speaerGroupId>/speakers/ returns オペレーションリソース

話者の API

API Reference	概要
話者の一覧を取得する	GET /srs/speakers 話者一覧の取得 returns 話者リソース
話者を取得する	GET /srs/speakers/<speakerId> returns 話者リソース
話者を作成する	POST /srs/speakers returns オペレーションリソース
話者を変更する	PUT /srs/speakers/<speakerId> returns オペレーションリソース
話者を削除する	DELETE /srs/speakers/ returns オペレーションリソース
話者が登録されている話者グループの一覧を取得する	GET /srs/speakers/<speakerId>/speaker_groups returns 話者グループリソース

話者の学習の API

API Reference	概要
話者の学習を非同期実行する	POST /srs/speakers/<speakerId>/trainer/commit returns オペレーションリソース
話者の学習状況を取得する	GET /srs/speakers/<speakerId>/trainer returns 学習器リソース

話者の発話データの API

API Reference	概要
発話データの一覧を取得する	GET /srs/speeches returns 発話リソース
発話データを取得する	GET /srs/speeches/<speechId> returns 発話リソース
話者に登録されている発話の一覧を取得する	GET /srs/speakers/<speakerId>/speeches returns 発話リソース
話者の発話データを登録する	POST /srs/speakers/<speakerId>/speeches returns オペレーションリソース
発話データを削除する	DELETE /srs/speeches/<speechId> returns オペレーションリソース

利用例

準備から話者識別サービス利用まで、一連の流れの API 実行例および応答例については初めてのAPI実行 - 6. 話者識別を参照してください。