> 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.

### デベロッパー向けリソース

- **ElevenLabs Devs YouTubeチャンネル**：チュートリアル、APIの解説、技術的な詳細解説を提供する、デベロッパー向けの新しい[YouTubeチャンネル](https://www.youtube.com/@elevenlabsdevs)を公開しました。ElevenLabsプラットフォームを最大限に活用できるよう支援します。

### ElevenAgents

- **ワークフロー開始ノードのオーバーライド**：[会話開始クライアントデータ](/docs/ja/api-reference/agents/create)で`starting_workflow_node_id`を渡すことで、特定のワークフローノードから会話を開始できるようになりました。この機能は、エージェントのプラットフォームオーバーライド設定にあるオプトインの`enable_starting_workflow_node_id_from_client`フィールドによって有効化されます。有効にすると、クライアント側で会話の開始ノードを指定できます。これはエージェントメモリや、より長期的なWebSocketユースケースに役立ちます。指定したノードが存在しない場合、会話はデフォルトのエントリーポイントにフォールバックします。

- **通話後分析LLMの設定**：エージェントのプラットフォーム設定に、評価基準やデータ収集を含む通話後分析のデフォルトLLMを設定する`analysis_llm`フィールド（デフォルト：`gemini-2.5-flash`）を追加しました。個々のデータ収集プロパティでは、新しい`AnalysisProperty`スキーマを介してアイテムごとの`llm`フィールドでこのデフォルトをオーバーライドでき、各分析アイテムを処理するモデルを細かく制御できます。

- **新しいLLMオプション**：エージェント設定で利用可能なLLMプロバイダーの一覧に`gpt-5.4`を追加しました。対応モデルで拡張推論を利用するため、`LLMReasoningEffort`列挙型に`xhigh`を追加しました。

- **ワークフロー式でのnullリテラル**：ワークフローの条件式で、新しい`ASTNullNode`型を介したnull比較をサポートするようになりました。これにより、ワークフローロジックで「変数がnullの場合」のような分岐を設定できます。

- **IDでシークレットを取得**：新しい[シークレットを取得](/docs/ja/api-reference/workspace/secrets/get)エンドポイント（`GET /v1/convai/secrets/{secret_id}`）で、IDによって単一のワークスペースシークレットを取得できます。[シークレット一覧](/docs/ja/api-reference/workspace/secrets/list)エンドポイントでも、名前のプレフィックスでシークレットをフィルタリングする`search`クエリパラメーターを受け付けるようになりました。

- **一括発信で検索可能な電話番号**：ダッシュボードの一括発信フォームに、検索可能な電話番号セレクターを追加しました。一括発信の設定時に適切な発信番号を簡単に見つけられます。

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

- **話者ロール検出**：[音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert)エンドポイントで、`detect_speaker_roles`パラメーター（ブール値、デフォルト`false`）を受け付けるようになりました。`diarize=true`とともに有効にすると、話者ラベルは`speaker_0`、`speaker_1`ではなく`agent`、`customer`として返されます。`use_multi_channel=true`とは併用できません。利用料金には、基本文字起こしコストの10%の追加料金がかかります。

### テキストtoダイアログ

- **入力文字数上限のガイダンス**：[テキストをダイアログに変換](/docs/ja/api-reference/text-to-dialogue/convert)エンドポイントで、リクエストあたりのすべての`inputs[].text`値の合計について、推奨上限を2,000文字と明記しました。より長いリクエストでは、ストリーミングレスポンスが早期に終了したり、バリデーションエラーが返されたりする可能性があります。

### ワークスペース

- **利用状況分析エンドポイント**：新しい[製品別の期間別利用状況](/docs/ja/api-reference/workspace/usage/get-usage-by-product-over-time)エンドポイント（`POST /v1/workspace/analytics/query/usage-by-product-over-time`）で、製品タイプ別に分類した期間ごとのクレジット利用状況を取得できます。結果は、設定可能な`interval_seconds`、`group_by`ディメンション、`filters`を含む表形式で返されます。以前の`GET /v1/usage/character-stats`エンドポイントは、この新しいエンドポイントに代わり非推奨になりました。

### SDKリリース

#### パッケージ

- [@elevenlabs/client@1.2.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.2.1) - セッションが接続済みとしてマークされ、Reactが`conversationRef`を同期した後に`onConnect`が実行されるよう、会話開始時の準備状態を修正しました。また、`onConnect`より前に作成された`Conversation`インスタンスを必要とする利用者向けに、`onConversationCreated`を公開して転送するようにしました。

- [@elevenlabs/react@1.1.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.1.1) - 会話開始時の準備状態を修正し、`@elevenlabs/client@1.2.1`の変更に合わせて`onConversationCreated`コールバックを公開しました。

- [@elevenlabs/react-native@1.1.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.1), [@elevenlabs/convai-widget-core@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.4), [@elevenlabs/convai-widget-embed@0.11.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.4) - 会話開始に関する修正を含む`@elevenlabs/client@1.2.1`に更新しました。

### API

<Accordion title="APIの変更を表示">

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

- [シークレットを取得](/docs/ja/api-reference/workspace/secrets/get) - `GET /v1/convai/secrets/{secret_id}`
- `POST /v1/workspace/analytics/query/usage-by-product-over-time` - 製品別の期間ごとのワークスペースクレジット利用状況を取得

## 非推奨のエンドポイント

- `GET /v1/usage/character-stats` - `POST /v1/workspace/analytics/query/usage-by-product-over-time`に代わり非推奨
- すべての吹き替えリソース編集エンドポイント（`POST /v1/dubbing/resource/{dubbing_id}/language`、`POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment`、`PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}`など）が非推奨になりました

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

### ElevenAgents

- [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを取得](/docs/ja/api-reference/agents/get)、[エージェントを更新](/docs/ja/api-reference/agents/update)

  - デフォルトの通話後分析モデルを設定するため、`AgentPlatformSettings`に`analysis_llm`フィールド（LLM列挙型、デフォルト：`gemini-2.5-flash`）を追加
  - データ収集プロパティで、アイテムごとのオプションの`llm`オーバーライドフィールドを持つ`AnalysisProperty`スキーマを使用するよう変更

- [会話をシミュレーション](/docs/ja/api-reference/agents/simulate-conversation)

  - 会話開始クライアントデータに`starting_workflow_node_id`フィールド（文字列、null許容）を追加
  - `ConversationInitiationClientDataConfig`に`enable_starting_workflow_node_id_from_client`フィールド（ブール値、デフォルト`false`）を追加

- [一括発信を送信](/docs/ja/api-reference/batch-calling/create)

  - 一括発信レコードに`external_link`フィールド（文字列、null許容）を追加

- [シークレット一覧](/docs/ja/api-reference/workspace/secrets/list)

  - 名前のプレフィックスでシークレットをフィルタリングする、オプションの`search`クエリパラメーター（文字列）を追加

- `LLM`列挙型

  - `gpt-5.4`、`gpt-5.4-2026-03-05`を追加

- `LLMReasoningEffort`列挙型

  - `xhigh`を追加

- ワークフロー式（`ASTNode`）

  - null比較用の`null_literal`識別子値と`ASTNullNode`スキーマを追加

- 配列ツールパラメーター（`ArrayJsonSchemaProperty`）

  - 実行時に動的変数から配列を設定する`dynamic_variable`フィールド（文字列、オプション）を追加
  - 定数の配列値を設定する`constant_value`フィールド（配列、null許容）を追加
  - `items`フィールドは必須ではなくなりました（デフォルトスキーマがあります）

- MCPツール設定のオーバーライド

  - レスポンスで`MCPToolConfigOverride-Output`スキーマ（入力／出力分割）を使用するよう変更

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

- [音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert)

  - エージェント／顧客の話者ロール検出用に`detect_speaker_roles`フィールド（ブール値、デフォルト`false`）を追加

### テキストtoダイアログ

- [テキストをダイアログに変換](/docs/ja/api-reference/text-to-dialogue/convert)、[テキストをダイアログにストリーミング](/docs/ja/api-reference/text-to-dialogue/stream)

  - `inputs`の説明に、リクエストあたり2,000文字という推奨を追加
  - リクエスト本文から`avatar_context`フィールドを削除

### テキスト読み上げ

- TTSおよびダイアログエンドポイントの品質プリセットフィールドで、`QualityPresetType`列挙型スキーマを参照するようになりました。ダイアログ品質プリセットから`highest`値を削除しました。代わりに`ultra`を使用してください。

### その他

- `AudioNativeResponse` - レスポンスから`transcription`フィールドを削除
- `UserResponseModel` - 後方互換性のあるスキーマ更新

</Accordion>