ボイスクローン

Agent の主経路

Universal Skill から MCP ツール beatra.voices.clone を使います。この ツールは課金対象で、同意確認が必須で、非同期タスクを返します。

1. ユーザーがその声の権利を持っていることを確認します。明示的な確認の後で のみ consent_attested: true を設定します。
2. ローカルサンプルを beatra.assets.upload でアップロードし、その artifact ID を使います。10 秒〜5 分の、クリーンな単一話者の音声が最適です。
3. 不透明な client_request_id を 1 つ作り、最終的な引数を一度だけ送信します。
4. beatra.tasks.get でポーリングします。終端状態の応答が新しい voice_id を返します。

AI ガイド

ツール引数

{
  "sample": { "type": "artifact", "artifact_id": "artifact_01JX..." },
  "display_name": "Brand narration - female",
  "consent_attested": true,
  "client_request_id": "voice-clone-opaque-1"
}

sample は artifact、HTTPS URL、data URI を受け付けます。display_name は 必須（≤255 文字）。consent_attested: true がないリクエストは拒否されます。

モデル・コントロール・コスト

ユーザーがモデルを指名しない限り model は省略（または auto）します。 選択可能なモデル、受け付けるサンプル形式、固定価格は capability: "voice_clone" の beatra.models.list で取得します。

ボイスクローンは、アクティブ化されたボイスの作成に成功したときに一度だけ 固定料金が発生します。成功とは、Beatra がクローンをアクティブ化する短い 正式合成をすでに完了したことを意味します——このアクティブ化は料金に含まれ、 以後の音声合成は別課金です。クローンまたはアクティブ化に失敗した場合、 課金は保持されません。

タスクの状態とリカバリー

queued と running は失敗ではありません。同じ task_id をポーリングし 続け、実行中だからといって代替リクエストを送らないでください。作成応答を 失った場合は、同じ client_request_id で同一の引数を再送します。入力が 少しでも変わったら新しい ID を使います。返された voice_id は 音声合成の voice フィールドに そのまま使え、長期間有効で、ボイス管理で 確認・削除できます。

REST で呼び出す

プロトコル直結の統合は POST /v1/voices と共有タスクエンドポイントを使え ます。生成されたAPI 定義 に従ってください。推奨の統合方法は Skill + MCP です。REST は Agent ではないカスタム アプリケーション向けです。