SpeakAPI(スピークAPI)をつかって、非同期で一方的に喋らせるには?
デジタルヒューマンを非同期(ユーザーからのリクエストなしに)で喋らせたいときに、下記のAPI経由あてに発話させたい文字列を投げてください。
このAPIはデジタルヒューマン株式会社が提供するオーケストレーションレイヤーにデジタルヒューマンと会話AIが接続されているときのみ有効です。
メソッド
POST
/api/v1/<uuid>/speak
エンドポイント
提供する環境によって変わるので、確認してください。
https://nlp-orch-001.digitalhumans.ne.jp/
https://nlp-orch-002.digitalhumans.ne.jp/
例: https://nlp-orch-001.digitalhumans.ne.jp/api/v1/<uuid>/speak
リクエストパラメータ
キー | 値 | 必須 | 備考 |
uuid | DHKKが発行した識別子 | ○ | デジタルヒューマン株式会社から提供しない限り確認する方法はありません。 |
POSTデータ(JSON形式)
キー | 値 | 必須 | 備考 |
session_id | アバターのセッションID | ○ | |
speak_text | 発話させたい文字列 | ○ | プレーンな発話文字列に追加して、SynAnim (シンアニム) - シンセティック アニメーションエンジン の制御タグが利用可能です。 |
instructions | インストラクション | 任意、JSON文字列をセットしてください。ただしフロントエンドの種類によって異なります。
・ ホステッドエクスペリエンスの場合 |
レスポンス(JSON形式)
キー | 値 | 備考 |
result | success または error | |
{message} エラーメッセージ | resultがerrorの場合のみ |
Crulサンプル
curl -X POST "https://nlp-orch-001.digitalhumans.ne.jp/api/v1/<uuid>/speak" \
-H "Content-Type: application/json" \
-d '{
"session_id": "ブラウザJavaScriptコンソールからUneeQ Session IDを取得",
"instructions":"<インストラクション>",
"speak_text": "テストSpeak発話"
}'
お役に立ちましたか?
😞
😐
🤩
最終更新日 July 7, 2023