> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
### Music v2のご紹介
Music v2がElevenLabs APIで利用可能になりました。新しいモデルを使用するには、[音楽を生成](/docs/ja/api-reference/music/compose)、[音楽をストリーミング](/docs/ja/api-reference/music/stream)、[詳細な音楽を生成](/docs/ja/api-reference/music/compose-detailed)、[音楽をアップロード](/docs/ja/api-reference/music/upload)で`model_id`を`music_v2`に設定してください。Music v2では、`GenerationChunk`および`AudioRefChunk`セグメントで構成されるチャンクベースのコンポジションプランを導入し、プロンプトベースの`music_v1`フローよりも構造、ペーシング、アレンジを細かく制御できます。
生成およびアップロードリクエストでは`music_v2`コンポジションプランを使用するか、コンポジションプランエンドポイントで先にプランを生成してください。リクエストおよびレスポンスボディはv1またはv2のプラン形式を受け付けるため、エンドポイントごとに移行できます。`MusicPrompt`は引き続き`music_v1`でのみ利用できます。
Music APIで最初のトラックを数分で生成できます。
構造化された複数セクションのトラック向けに、チャンクベースのコンポジションプランを作成します。
REST API経由で`music_v2`を使用して音楽を作曲、ストリーミング、アップロードします。
- **アップロードのタイムスタンプ**：[音楽をアップロード](/docs/ja/api-reference/music/upload)でオプションの`with_timestamps`を受け付けるようになりました。レスポンスには`words_timestamps`が含まれる場合があります。
### ElevenAgents
- **会話評価を実行**：`RunConversationEvaluationsRequest`を使用して、完了した会話に対して単一の評価基準を再実行する[会話評価を実行](/docs/ja/api-reference/conversations/analysis/run-evaluation)エンドポイント（`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`）を追加しました。
- **ワークフローのエントリー動作**：ワークフローのoverride-agentノードに、サブエージェントが先に発話するかユーザー入力を待つかを制御するオプションの`entry_behavior`（`generate_immediately`、`wait_for_user`、`auto`）が追加されました。
- **プロシージャ終了システムツール**：対応するエラーステータスとともに`end_procedure`システムツール設定を追加しました。`start_procedure`ツールのエラーステータスには`already_active`が追加されます。
- **転送時のTTSオーバーライド**：`AgentTransfer`、ワークフローのスタンドアロンエージェントノード、成功した`transfer_to_agent`ツール結果に、転送後もクライアント側TTSオーバーライドを維持するオプションの`preserve_client_tts_overrides`（ブール値）が追加されました。
- **インタラクション予算enum**：`InteractionBudget`から`async`を削除し、`5_minutes`、`10_minutes`、`1_hour`を追加しました。引き続き`async`を参照している設定またはSDK enumを更新してください。
- **カスタムガードレールモデルの選択**：カスタムガードレール設定に、Gemini、Claude、GPTのバリアントを持つオプションの`model`が追加されました。ガードレール設定にはオプションの`history_message_count`（整数）も追加されました。
- **電話番号一覧フィルター**：[電話番号一覧](/docs/ja/api-reference/phone-numbers/list)に、インポートした番号をフィルタリングするためのオプションの`provider`、`agent_id`、`branch_id`クエリパラメーターが追加されました。
- **WhatsAppアカウントのフィルタリング**：[WhatsAppアカウント一覧](/docs/ja/api-reference/whats-app/accounts/list)に、割り当てられたエージェントでアカウントをフィルタリングするオプションの`agent_id`クエリパラメーターが追加されました。
- **トピックの期間フィルター**：[エージェント会話トピックを取得](/docs/ja/api-reference/conversations/topics/get)に、トピック検出結果の期間を限定するオプションの`from_unix_secs`および`to_unix_secs`クエリパラメーターが追加されました。
- **SIPコーデック設定**：送信SIPトランクのリクエストおよびレスポンスモデルに、オプションの`enabled_codecs`（`MediaCodec` enum）が追加されました。
- **メモリツール型**：メモリツールのエラー処理用に`LoadableMemoryEntry`および`LoadMemoryEntryToolErrorStatus`スキーマを追加しました。
- **エージェントテストのバッチ上限**：エージェントテストのアタッチ、実行、再送信リクエストスキーマで、添付可能なテストの最大数を1000から5000に引き上げました。
- **音素タグのサポート**：エージェントTTS設定に、オプトインのV3 SSML音素処理用オプション`enable_phoneme_tags`（ブール値）が追加されました。
- **配列スキーマの省略オーバーライド**：配列JSONスキーマプロパティに、オプションの`is_omitted`（他の値ソースと相互排他的）が追加されました。`ConstantSchemaOverride`で配列の定数値を使用できるようになりました。
- **転送エラーコンテキスト**：電話番号への転送のエラーペイロードに、オプションの`agent_message`（文字列）を含められるようになりました。
### ワークスペース
- **サービスアカウントAPIキーの更新**：[サービスアカウントAPIキーを更新](/docs/ja/api-reference/service-accounts/api-keys/update)でリクエストボディが不要になりました。編集フィールドでは、`no_update`およびnull許容の`name`を介した部分更新がサポートされ、`permissions`および`character_limit`も対象です。
- **使用量のタイムゾーンバケット**：ワークスペースのプロダクト別経時使用量リクエストに、オプションの`time_zone`（IANAタイムゾーン文字列）が追加され、`interval_seconds`バケットのルールが明確化されました。
- **履歴ソースフィルター**：履歴一覧および詳細の`source`フィルターに`Flows`が追加されました。
### ElevenCreative Studio
- **プロジェクトの音声参照**：プロジェクトモデル、チャプターTTSノード、音声一覧、音声統計で、標準の音声フィールドが`project_voice_ref_id`に移行されます。従来の`voice_id`フィールドは、互換性のため非推奨の読み取り専用ミラーとしてレスポンスに残ります。
### スピーチtoテキスト
- **話者ライブラリ話者分離**：[音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert)に、バッチ文字起こしでの話者分離用オプション`use_speaker_library`（ブール値、デフォルトは`false`）が追加されました。
### 音声
- **共有音声の並べ替え**：[共有音声一覧](/docs/ja/api-reference/voices/voice-library/get-shared)の`sort`クエリパラメーターに明示的なenum、`created_date`のデフォルト値、更新された説明が追加されました。
### SDKリリース
#### JavaScript SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.0) - 最新のOpenAPIスキーマから再生成されました。会話評価の再実行サポート、music v2コンポジションプランユニオン、ワークフローの`entry_behavior`、電話番号およびWhatsApp一覧フィルター、トピック期間パラメーター、アラートスキーマ更新、Studioの`project_voice_ref_id`フィールド、拡張されたエージェントテストバッチ上限が含まれます。
#### Python SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.53.0) - 最新のOpenAPIスキーマから再生成されました。会話評価の再実行サポート、music v2コンポジションプラン、ワークフローのエントリー動作およびプロシージャ終了ツール、テレフォニーフィルターパラメーター、アラートおよびサービスアカウント部分更新モデル、Studio音声参照フィールドが含まれます。
#### パッケージ
- [@elevenlabs/client@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Unity SDK WebGLブリッジ用の`@elevenlabs/client/internal/unity`サブパスエクスポートを追加し、`MediaDeviceInput`、`MediaDeviceOutput`、接続アタッチヘルパー、WebRTCアダプター型を公開しました。
- [@elevenlabs/client@1.11.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.1)、[@elevenlabs/react@1.6.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.7)、[@elevenlabs/react-native@1.2.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.7)、[@elevenlabs/convai-widget-core@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.2)、[@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - `@elevenlabs/client@1.11.1`および`@elevenlabs/types@0.14.1`との依存関係を整合させました。
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - ライセンスチェッカーとの互換性のため、`package.json`に`"license": "MIT"`を追加しました。
#### iOS SDK
- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - シンガポールのデータレジデンシーをサポートし、WebRTCセッションで`singlePeerConnection`を有効化しました。
### API
## 新しいエンドポイント
### ElevenAgents
- [会話評価を実行](/docs/ja/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
- リクエストボディで`RunConversationEvaluationsRequest`を使用し、単一の評価基準を再実行
## 更新されたエンドポイント
### ElevenAgents
- [電話番号一覧](/docs/ja/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
- オプションの`provider`、`agent_id`、`branch_id`クエリパラメーターを追加
- [エージェント会話トピックを取得](/docs/ja/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- オプションの`from_unix_secs`および`to_unix_secs`クエリパラメーターを追加
- [WhatsAppアカウント一覧](/docs/ja/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
- オプションの`agent_id`クエリパラメーターを追加
### 音楽
- [音楽を生成](/docs/ja/api-reference/music/compose)、[詳細な音楽を生成](/docs/ja/api-reference/music/compose-detailed)、[音楽をストリーミング](/docs/ja/api-reference/music/stream)、[音楽をアップロード](/docs/ja/api-reference/music/upload)
- サポート対象の`model_id`値に`music_v2`を追加
- アップロードにオプションの`with_timestamps`を追加。レスポンスには`words_timestamps`が含まれる場合があります
### スピーチtoテキスト
- [音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- オプションの`use_speaker_library`クエリパラメーター（ブール値、デフォルトは`false`）を追加
### 音声
- [共有音声一覧](/docs/ja/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
- `sort`クエリパラメーターで、`created_date`をデフォルトとする明示的なenumを使用するようになりました
## スキーマの変更
### ElevenAgents
- ワークフローのoverride-agentノード
- オプションの`entry_behavior` enum（`generate_immediately`、`wait_for_user`、`auto`）を追加
- システムツール
- `end_procedure`ツール設定およびエラーステータスを追加
- 転送およびインタラクションスキーマ
- 転送および転送ツール結果にオプションの`preserve_client_tts_overrides`を追加
- `InteractionBudget`から`async`を削除し、`5_minutes`、`10_minutes`、`1_hour`を追加
- ガードレールおよびTTS
- カスタムガードレールにオプションの`model`および`history_message_count`を追加
- エージェントTTS設定にオプションの`enable_phoneme_tags`を追加
- テレフォニー
- SIPトランクモデルにオプションの`enabled_codecs`（`MediaCodec` enum）を追加
- メモリおよびコードツール
- `LoadableMemoryEntry`および`LoadMemoryEntryToolErrorStatus`を追加
- エージェントテスト
- 実行および再送信リクエストで、添付テストの上限を1000から5000に引き上げ
- ツールJSONスキーマプロパティ
- 配列プロパティにオプションの`is_omitted`を追加
### ワークスペース
- サービスアカウント
- APIキーPATCHで`no_update`センチネルによる部分更新をサポート
- 使用量および履歴
- プロダクト別経時使用量にオプションの`time_zone`を追加
- 履歴の`source`フィルターに`Flows`を追加
### 音楽
- コンポジションプラン
- `music_v2`向けに、チャンクベースの`CompositionPlan`、`GenerationChunk`、`AudioRefChunk`を追加
- リクエストおよびレスポンスボディでv1またはv2のプラン形式の`anyOf`を受け付け
### ElevenCreative Studio
- プロジェクト音声モデル
- 標準の音声参照として`project_voice_ref_id`を追加
- 非推奨の読み取り専用`voice_id`ミラーをレスポンスに保持