リアルタイム字幕タスクを作成し、音声ストリームをリアルタイムでテキストに文字起こしします。
操作説明
この操作は現在メンテナンスモードです。この機能を実装するにはインテリジェントワークフローを使用してください。詳細については、インテリジェントワークフロー構成を参照してください。
QPS 制限
この操作のシングルユーザー QPS 制限は 1 秒あたり 20 回の呼び出しです。この制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。この操作を適切に呼び出してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:CreateRtcAsrTask |
create |
*Domain
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
リージョン ID。 |
cn-shanghai |
| Mode |
string |
必須 |
ストリームモード。有効な値: live および rtc。値 live は RTMP などの標準ライブストリームを示します。 列挙値:
|
live |
| SDKAppID |
string |
任意 |
ApsaraVideo リアルタイムコミュニケーションアプリケーション ID。 説明
このパラメーターは Mode が rtc に設定されている場合に必須です。それ以外の場合、このパラメーターは有効になりません。 |
appId |
| ChannelID |
string |
任意 |
チャンネル ID。 説明
このパラメーターは Mode が rtc に設定されている場合に必須です。それ以外の場合、このパラメーターは有効になりません。 |
channelId |
| RtcUserId |
string |
任意 |
アップストリーミングユーザー ID。 説明
このパラメーターは Mode が rtc に設定されている場合に必須です。指定できる値は 1 つのみです。それ以外の場合、このパラメーターは有効になりません。 |
user1 |
| StreamURL |
string |
任意 |
ストリーミング URL。 説明
このパラメーターは Mode が live に設定されている場合に必須です。それ以外の場合、このパラメーターは有効になりません。 |
rtmp://xxx |
| Language |
string |
必須 |
ソース音声の言語。有効な値:
|
cn |
| CallbackURL |
string |
必須 |
コールバック URL。 |
http://xxx.com |
| AuthKey |
string |
任意 |
コールバック情報の MD5 署名を生成するために使用される認証キー。 説明
コールバック時にリクエストヘッダーに 2 つの認証フィールドが追加されます: "SIG-TIME" は現在のタイムスタンプを示し、"ASR-SIG" は MD5 認証フィールドを示します。"ASR-SIG" フィールドはルール md5( |
abcd |
| TranslateEnabled |
boolean |
任意 |
翻訳を有効にするかどうかを指定します。 |
true |
| TargetLanguages |
string |
任意 |
ターゲット翻訳言語。有効な値:
|
en |
| AutoTerminateEnabled |
boolean |
任意 |
ストリーム切断が最大遅延を超えた場合にタスクを自動的に閉じるかどうかを指定します。デフォルト値: false。 |
true |
| AutoTerminateDelay |
integer |
任意 |
自動ストリーム切断遅延（秒単位）。有効な値: 1～10。 |
5 |
| ReportInterval |
integer |
任意 |
コールバック報告間隔（ミリ秒単位）。有効な値: -1～500。
|
5 |
コールバック例
JSON 形式のデータはリクエストボディに配置され、HTTP POST リクエストとして指定された CallbackUrl に送信されます。コールバックパラメーター Content およびコールバックプロセスの詳細については、インタラクションプロセスと実装を参照してください。例:
{
"task_id": "asr-cf8c70d7-3b8d-496c-98f8-4785******",
"sdk_app_id": "",
"channel_id": "",
"rtc_user_id": "",
"callback_time_stamp": 1723433155645,
"language": "cn",
"content": "{\"header\":{\"nls_task_id\":\"af95c5cc332549f689f3153bc9******\",\"task_key\":\"tl_2977564_17234*****\",\"namespace\":\"SpeechTranscriber\",\"name\":\"TranscriptionResultChanged\",\"task_id\":\"413937911b874146b5796******\",\"message_id\":\"abfc9e9994e748a38499e1******\",\"status_text\":\"Success.\",\"status\":20000000},\"payload\":{\"result\":\"在这里与各位相聚\",\"confidence\":0.0,\"words\":[{\"startTime\":0,\"text\":\"在这\",\"endTime\":510},{\"startTime\":510,\"text\":\"里与\",\"endTime\":1020},{\"startTime\":1020,\"text\":\"各位\",\"endTime\":1530},{\"startTime\":1530,\"text\":\"相聚\",\"endTime\":2040}],\"index\":0,\"time\":2040,\"fixed_result\":\"\",\"unfixed_result\":\"\",\"status\":0}}"
}
```。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| Description |
string |
結果の説明。値 success は操作が成功したことを示します。エラーが発生した場合はエラーメッセージが返されます。 |
success |
| RequestId |
string |
ゲートウェイリクエスト ID。 |
7FF5417D-06E9-5A2C-9A70-581F6149E6C1 |
| RetCode |
integer |
状態コード。値 2000 は成功を示します。その他の値は例外を示します。 |
2000 |
| TaskId |
string |
生成されたタスク ID。 |
asr-a6ac15e0-9118-4b4c-9e64-306163a0**** |
例
成功レスポンス
JSONJSON
{
"Description": "success",
"RequestId": "7FF5417D-06E9-5A2C-9A70-581F6149E6C1",
"RetCode": 2000,
"TaskId": "asr-a6ac15e0-9118-4b4c-9e64-306163a0****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。