alicloud-ai-audio-asr-realtime について
Alibaba Cloud Model Studio Qwen ASR によるリアルタイム音声認識スキルです。ストリーミングリクエストを準備し、認識テキストの断片と最終結果の印を返します。
主な機能
- 01リアルタイム ASR リクエストの準備
- 02ストリーミングセッション設定への対応
- 03認識テキスト断片の返却
- 04最終結果の識別
活用シーン
- 01リアルタイム字幕の生成
- 02音声エージェントへの双方向入力
- 03ブラウザーやターミナルクライアントでの音声ストリーム文字起こし
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-ai-audio-asr-realtimeインストール後、Claude Code で/alicloud-ai-audio-asr-realtimeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdscripts/prepare_realtime_asr_request.py詳細
Category: provider
Model Studio Qwen ASR Realtime
検証
mkdir -p output/alicloud-ai-audio-asr-realtime
python -m py_compile skills/ai/audio/alicloud-ai-audio-asr-realtime/scripts/prepare_realtime_asr_request.py && echo "py_compile_ok" > output/alicloud-ai-audio-asr-realtime/validate.txt
合格基準:コマンドが 0 で終了し、output/alicloud-ai-audio-asr-realtime/validate.txt が生成されます。
出力と証拠
- セッションのペイロードと応答サンプルを
output/alicloud-ai-audio-asr-realtime/に保存します。
重要なモデル名
次のいずれかのモデル文字列を正確に使用してください。
qwen3-asr-flash-realtimeqwen3-asr-flash-realtime-2026-02-10
ユースケース
- リアルタイムの字幕とキャプション
- 音声エージェントの双方向入力
- ブラウザーまたはターミナルクライアントでのストリーミング音声テキスト変換
前提条件
- 環境に
DASHSCOPE_API_KEYを設定するか、~/.alibabacloud/credentialsにdashscope_api_keyを追加します。 - リアルタイムセッションでは通常、クライアントで WebSocket またはストリーミングセッションの処理が必要です。
正規化されたインターフェース(asr.realtime)
リクエスト
model(string、任意):デフォルトはqwen3-asr-flash-realtimelanguage_hints(array、任意)format(string、任意):例:pcm、wavsample_rate(int、任意):例:16000chunk_ms(int、任意):フレームサイズ(ミリ秒)
レスポンス
text(string):認識された文字起こしの断片is_final(bool):確定を示すマーカーusage(object、任意)
クイックスタート
リクエストテンプレートを生成します。
python skills/ai/audio/alicloud-ai-audio-asr-realtime/scripts/prepare_realtime_asr_request.py \
--output output/alicloud-ai-audio-asr-realtime/request.json
運用ガイダンス
- クライアントの構成で別の形式が必要でない限り、16kHz のモノラル PCM を優先してください。
- 応答性の高い部分結果が得られるよう、チャンクを十分に小さくしてください。
- 録音済みファイルしかない場合は、代わりに
skills/ai/audio/alicloud-ai-audio-asr/を使用してください。
参考資料
references/sources.md
コメント
Markdown 対応