mcpField
A
alicloud-ai-audio-tts-voice-clone

alicloud-ai-audio-tts-voice-clone

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

alicloud-ai-audio-tts-voice-clone について

このスキルは、DashScopeを使う音声合成ワークフロー向けに、Alibaba Cloud Model StudioのQwen TTS音声クローンモデルを統一的な形式で利用します。登録音声を受け取り、音声URLまたはストリーミングPCMチャンクを返します。

主な機能

  1. 01登録音声から声質をクローン
  2. 02指定された2種類のモデル名に対応
  3. 03音声URLまたはPCMストリームを返却
  4. 04voice_idとリクエストIDを返却

活用シーン

  1. 01テキストからクローン音声を生成
  2. 02後続の合成用にvoice_idを保存

インストール

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

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

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

同梱ファイル

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

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

詳細

Category: プロバイダー

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/alicloud-ai-audio-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/alicloud-ai-audio-tts-voice-clone
for f in skills/ai/audio/alicloud-ai-audio-tts-voice-clone/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-audio-tts-voice-clone/validate.txt

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

出力と証拠

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

ワークフロー

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

参考資料

  • references/sources.md

コメント

Markdown 対応