ボイス管理

Agent の主経路

Universal Skill から MCP ツール beatra.voices.list を使います。課金されない読み取り専用の呼び出しで、プリセットボイスとテナント所有のクローンボイスを返します。

category（preset / cloned）、language（BCP-47）、gender、 query（名前で検索）で絞り込みます。
返された voice_id は音声合成の voice フィールドにそのまま使えます。preview_url で選ぶ前に試聴できます。

AI ガイド

AI 連携 Markdown

独自アプリケーションに組み込む場合は、この API ガイドを Claude や Codex などにコピーできます。

ツール引数

{
  "category": "preset",
  "language": "zh-CN"
}

ボイスのエントリは次の形です：

{
  "voice_id": "voice_01JX...",
  "display_name": "Sunny female voice",
  "category": "preset",
  "language": "zh-CN",
  "gender": "female",
  "preview_url": "https://cdn.beatra.ai/.../preview.mp3",
  "status": "ready"
}

クローンボイスの削除

削除は REST のみです：

curl -X DELETE "$BEATRA_BASE_URL/voices/voice_01JX..." \
  -H "Authorization: Bearer $BEATRA_API_KEY"

204 を返します。削除できるのは自分でクローンしたボイスだけで、プリセットボイスは削除できません。

REST で呼び出す

プロトコル直結の統合はボイスエンドポイントを直接使えます：一覧 · 詳細 · 削除。推奨の統合方法は Skill + MCP です。REST は Agent ではないカスタムアプリケーション向けです。