> 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 Finetunes API**：[Music Finetunes](/docs/ja/eleven-creative/products/music/finetunes)を管理するためのAPIサポートを追加しました。5つのエンドポイントで、アップロードしたオーディオからのFinetune作成、アクセス可能なFinetuneの一覧表示、トレーニングステータスの取得、メタデータと公開設定の更新、Finetuneの削除ができます。すべての音楽生成SDKメソッドで`finetune_id`を公開するようになりました。

### ElevenAgents

- **外部会話参照の解決**：SlackメッセージURLまたはZendeskチケットURLから会話を解決する`GET /v1/convai/conversations/resolve`を追加しました。リクエストには`agent_id`と`reference`のクエリパラメーター（文字列）が必要です。
- **エージェントのナレッジベースをクエリ**：エージェントのナレッジベースに対する読み取り専用RAGクエリ用の`POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`を追加しました。リクエストには`query`（文字列）が必要で、任意の`branch_id`（文字列）を受け付け、ドキュメント、チャンク、テキスト、ベクトル距離のメタデータを含むランク付けされたチャンクを返します。このエンドポイントは生成SDKから除外されます。
- **ナレッジベースのコンテンツ形式**：ナレッジベースのファイル、テキスト、URLレスポンスに、任意の`content_format`（`html` | `markdown`、デフォルトは`html`）を追加しました。
- **エージェント音声設定**：TTSオーバーライドスキーマに、クライアントでオーバーライド可能な任意の`model_id`（`TTSConversationalModel`）を追加しました。`enable_phoneme_tags`のデフォルトは`false`から`true`に変更されます。
- **高速化されたバックアップLLMカスケード**：`cascade_timeout_seconds`のデフォルトを8秒から4秒に変更しました。許容範囲は2～15秒のままです。
- **ツールパラメーター値のソース**：オブジェクトツールパラメーターで、既存のスカラーおよび配列コントロールに合わせて`dynamic_variable`、`constant_value`、`is_omitted`を使用できるようになりました。定数スキーマオーバーライドは任意の配列およびオブジェクトを受け付けるようになりました。
- **完全レスポンスのガードレール**：カスタムガードレールに、完全な非TTSレスポンスを一度だけ評価する任意の`evaluate_full_response_only`（boolean、デフォルトは`false`）を追加しました。このオプションにはブロッキングモードが必要です。
- **Twilio通話録音**：テレフォニー通話設定に、任意の`twilio_call_recording_enabled`（boolean、デフォルトは`false`）を追加しました。録音は接続されたTwilioアカウントに保存され、他のプロバイダーではこの設定は無視されます。
- **ウィジェットのファイルアップロードテキスト**：ウィジェットテキスト設定に、ファイルの添付・削除、アップロード失敗、非対応タイプ、ファイルサイズ超過、ファイル数上限、入力中インジケーター用の任意のラベルとエラーメッセージを追加しました。
- **ナレッジベース同期ステータス**：ナレッジベースのファイルレスポンスに、任意の`auto_sync_info`および`refresh_status`（`FileRefreshStatus`）を追加しました。フォルダーレスポンスに、フォルダー以外のドキュメントを再帰的にカウントし、上限を1000とする必須の`document_count`（integer）を追加しました。
- **会話テキスト検索フィルター**：[会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)に、任意の`exclude_statuses`および`termination_reasons`配列クエリパラメーターを追加しました。
- **LLMオプション**：エージェントLLM設定に`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.6-luna`を追加しました。`LLMReasoningEffort`に`max`を追加しました。
- **WhatsApp入力中インジケーター**：WhatsAppアカウントのリクエストおよびレスポンススキーマに、任意の`enable_typing_indicator`（boolean）を追加しました。

### スピーチtoテキスト

- **単回使用バッチ認証**：[音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert)に、APIキーまたはBearer認証の代替として任意の`token`（文字列）を追加しました。単回使用トークンは`POST /v1/single-use-token/batch_scribe`で作成でき、15分後に期限切れになります。
- **リアルタイムクライアントの信頼性**：`@elevenlabs/client`が、マイク設定エラーおよび不正なサーバーエラーを`RealtimeEvents.ERROR`で報告し、設定失敗および接続終了後にマイクのリソースを解放し、ソケット終了後に遅延したマイクフレームを破棄するようになりました。

### テキスト読み上げ

- **アーカイブ済み発音辞書**：[発音辞書一覧](/docs/ja/api-reference/pronunciation-dictionaries/list)に、任意の`include_archived`（boolean、デフォルトは`true`）を追加しました。

### ワークスペース

- **Webhookイベントサブスクリプション**：[ワークスペースWebhookを更新](/docs/ja/api-reference/webhooks/update)のリクエストに、`voice_library_removal_notice`、`speech_to_text`、`agent_qa`を含む任意の`events`（`WorkspaceWebhookEventType[]`）を追加しました。Webhookレスポンスで購読イベント一覧を返せるようになりました。
- **使用状況分析のディメンション**：[ワークスペース使用状況を取得](/docs/ja/api-reference/analytics/workspace/usage)の`group_by`値に`surface`および`actor`を追加しました。
- **サービスアカウント上限のクリア**：[サービスアカウントAPIキーを更新](/docs/ja/api-reference/service-accounts/api-keys/update)で、`"no_update"`および整数値に加えて、月間文字数上限を削除する`character_limit: "clear"`を受け付けるようになりました。
- **アラートWebhook参照**：アラートWebhook通知スキーマで、`url`、`method`、`headers`を埋め込む代わりに、必須の`webhook_id`（文字列）でワークスペースWebhookを識別するようになりました。

### SDKリリース

#### JavaScript SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Music Finetunesの一覧表示、作成、取得、更新、削除を行う`music.finetunes`メソッドを追加しました。会話参照の解決、アーカイブ済み発音辞書のフィルタリング、単回使用のスピーチtoテキストトークンも追加しました。

#### Python SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - 最新のAPIスキーマからMusic Finetunesおよび会話参照の解決を追加しました。`OnPremInitiationData`には、署名付き通話後Webhook用の任意の`hmac_secret`を持つ、型付きの`post_call_transcription_webhook`および`post_call_audio_webhook`設定も追加されています。

#### パッケージ

- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - 設定失敗、クライアントまたはサーバーの終了、遅延したオーディオフレーム中のScribe Realtimeエラー配信とマイククリーンアップを改善しました。
- [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1), [@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15), [@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) and [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - `@elevenlabs/client@1.15.1`のScribe Realtime修正を含むよう依存関係を更新しました。

#### Android SDK

- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - `text`や`type`などの送信WebSocketおよびWebRTCイベントフィールドがR8とProGuardによって難読化されないようにしました。

#### CLI

- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - デフォルトのエージェントテンプレートを、削除された`elevenlabs` ASRプロバイダーではなく`scribe_realtime`を使用するよう更新しました。最小テンプレートは引き続きサーバーのデフォルトを使用します。

### API

<Accordion title="APIの変更を見る">

## 新しいエンドポイント

### 音楽

- [Music Finetunes一覧](/docs/ja/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - カーソルページネーション、公開設定および作成者フィルター、作成日時または名前での並べ替えをサポート
- [Music Finetuneを作成](/docs/ja/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
  - `name`および`primary_genre`が必要
  - 最大50個のオーディオファイル、タグ、公開設定、`model_id`を受け付け
- [Music Finetuneを取得](/docs/ja/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Music Finetuneを更新](/docs/ja/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - `name`、`tags`、`primary_genre`、`visibility`を更新
- [Music Finetuneを削除](/docs/ja/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}`

### ElevenAgents

- `GET /v1/convai/conversations/resolve`
  - `agent_id`（文字列）および`reference`（文字列）クエリパラメーターが必要
  - `GetConversationResponseModel`を返す
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - リクエストボディに`query`（文字列）が必要
  - 任意の`branch_id`（文字列）クエリパラメーターを受け付け
  - `AgentKnowledgeBaseRagQueryResponseModel`を返す
  - 生成SDKから除外

## 更新されたエンドポイント

### ElevenAgents

- [会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 任意の`exclude_statuses`および`termination_reasons`配列クエリパラメーターを追加

### スピーチtoテキスト

- [音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - 単回使用バッチScribeトークン用に任意の`token`（文字列）クエリパラメーターを追加

### テキスト読み上げ

- [発音辞書一覧](/docs/ja/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
  - 任意の`include_archived`（boolean、デフォルトは`true`）クエリパラメーターを追加

### ワークスペース

- [ワークスペースWebhookを更新](/docs/ja/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
  - 任意の`events`（`WorkspaceWebhookEventType[]`）リクエストフィールドを追加
- [ワークスペース使用状況を取得](/docs/ja/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
  - 任意の`group_by`配列に`surface`および`actor`を追加
- [サービスアカウントAPIキーを更新](/docs/ja/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
  - 任意の`character_limit`フィールドに`"clear"`を追加

## スキーマの変更

### ElevenAgents

- ElevenAgentsナレッジベースレスポンススキーマに、任意の`content_format`（`html` | `markdown`、デフォルトは`html`）を追加
- ナレッジベースのファイルレスポンスに、任意の`auto_sync_info`および`refresh_status`（`FileRefreshStatus`）を追加
- ナレッジベースのフォルダーレスポンスに、必須の`document_count`（integer）を追加
- エージェントTTSオーバーライドスキーマに、任意の`model_id`（`TTSConversationalModel`）を追加
- エージェントTTSの`enable_phoneme_tags`のデフォルトを`false`ではなく`true`に変更
- バックアップLLMの`cascade_timeout_seconds`のデフォルトを8秒ではなく4秒に変更
- エージェントLLM設定に`gpt-5.6-sol`、`gpt-5.6-terra`、`gpt-5.6-luna`を追加。`LLMReasoningEffort`に`max`を追加
- カスタムガードレールに、任意の`evaluate_full_response_only`（boolean、デフォルトは`false`）を追加
- テレフォニー通話設定に、任意の`twilio_call_recording_enabled`（boolean、デフォルトは`false`）を追加
- オブジェクトツールパラメーターに`dynamic_variable`、`constant_value`、`is_omitted`を追加。定数オーバーライドで任意の配列およびオブジェクト値を受け付け
- ウィジェットテキスト設定に、任意のファイルアップロードおよび入力中インジケーターラベルを追加
- WhatsAppアカウントスキーマに、任意の`enable_typing_indicator`（boolean）を追加
- シミュレーションおよびテストスキーマに`AutoGenerationMetadata`および`SimulationLibrarySettings`を追加

### 音楽

- Music Finetuneのリクエスト、レスポンス、ページネーション、公開設定、作成者、ステータス、失敗理由のスキーマを追加
- すべてのMusic生成リクエストスキーマで、生成SDK向けに`finetune_id`を公開

### ワークスペース

- ワークスペースWebhookのリクエストおよびレスポンススキーマに、任意の`events`（`WorkspaceWebhookEventType[]`）を追加
- アラートWebhook通知スキーマで、`url`、`method`、`headers`の代わりに必須の`webhook_id`（文字列）を使用

</Accordion>