mcpField
A
aliyun-qwen-tts-voice-clone

aliyun-qwen-tts-voice-clone

github.com/cinienceクリエイティブ・メディア396122 回インストール11 週間前に更新
リポジトリ

aliyun-qwen-tts-voice-clone について

Alibaba Cloud Model Studio の Qwen TTS で、登録用音声から声を複製するスキルです。音声 URL または PCM ストリームと、後続の合成に使う voice ID を返します。

主な機能

  1. 01音声サンプルからの声の複製
  2. 02通常モデルとリアルタイムモデルへの対応
  3. 03音声 URL または PCM ストリームの返却
  4. 04voice ID の保存と再利用

活用シーン

  1. 01テキスト読み上げ用のカスタム音声の作成
  2. 02生成音声の PCM ストリーム取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-qwen-tts-voice-clone

インストール後、Claude Code で/aliyun-qwen-tts-voice-cloneを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
sources.md
scripts/
prepare_voice_clone_request.py

詳細

Category: provider

Model Studio Qwen TTS Voice Clone

音声クローンモデルを使用して、登録用音声サンプルから声質を再現します。

重要なモデル名

次のモデル文字列のいずれかを正確に使用してください。

  • qwen3-tts-vc-2026-01-22
  • qwen3-tts-vc-realtime-2026-01-15

前提条件

  • 仮想環境に SDK をインストールします。
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 環境変数に DASHSCOPE_API_KEY を設定するか、~/.alibabacloud/credentials に dashscope_api_key を追加します。

正規化されたインターフェース（tts.voice_clone）

リクエスト
  • text（string、必須）
  • voice_sample（string | bytes、必須）登録用サンプル
  • voice_name（string、任意）
  • stream（bool、任意）
レスポンス
  • audio_url（string）またはストリーミング PCM チャンク
  • voice_id（string）
  • request_id（string）

運用ガイダンス

  • 背景ノイズの少ない、明瞭な音声サンプルを使用してください。
  • クローン音声に関する同意およびポリシー要件を遵守してください。
  • 生成された voice_id を保存し、今後の音声合成リクエストで再利用してください。

ローカルヘルパースクリプト

正規化されたリクエスト JSON を用意し、レスポンススキーマを検証します。

.venv/bin/python skills/ai/audio/aliyun-qwen-tts-voice-clone/scripts/prepare_voice_clone_request.py \
  --text "Welcome to this voice-clone demo" \
  --voice-sample "https://example.com/voice-sample.wav"

出力先

  • デフォルトの出力先：output/ai-audio-tts-voice-clone/audio/
  • OUTPUT_DIR でベースディレクトリを上書きできます。

検証

mkdir -p output/aliyun-qwen-tts-voice-clone
for f in skills/ai/audio/aliyun-qwen-tts-voice-clone/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-qwen-tts-voice-clone/validate.txt

合格基準：コマンドが終了コード 0 で終了し、output/aliyun-qwen-tts-voice-clone/validate.txt が生成されること。

出力と証跡

  • 成果物、コマンド出力、API レスポンスの要約を output/aliyun-qwen-tts-voice-clone/ に保存してください。
  • 再現性を確保するため、証跡ファイルに主要なパラメーター（リージョン／リソース ID／時間範囲）を含めてください。

ワークフロー

  1. ユーザーの意図、リージョン、識別子、および操作が読み取り専用か変更を伴うものかを確認します。
  2. 接続と権限を確認するため、まず最小限の読み取り専用クエリを 1 件実行します。
  3. 明示的なパラメーターと限定されたスコープで、対象の操作を実行します。
  4. 結果を検証し、出力／証跡ファイルを保存します。

参考資料

  • references/sources.md

コメント

Markdown 対応