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

# 변경 로그

## October 19, 2026

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### Eleven Realtime

Eleven Realtime is a new family of models for ElevenAgents voice agents, rolling out gradually across workspaces. Each one is a complete voice agent configuration. You pick one model, and ElevenLabs handles the LLM, Speech to Text and Text to Speech settings behind it. Your agent's system prompt, voice, tools and knowledge base work the same as before.

There are two to choose from. Eleven Realtime v1 Mini (`eleven_realtime_v1_mini`) is the default, and it's the fastest and cheapest. Eleven Realtime v1 Max (`eleven_realtime_v1_max`) reasons before it answers, so use it when your agent has complex instructions or multi-step tool calls.

If you've already built on OpenAI's Realtime API, you don't need to rewrite your client. The events and the WebSocket transport are the same, so you change the endpoint and the session configuration. Your backend calls [Create realtime client secret](/docs/api-reference/conversations/create-client-secret) to get a short-lived secret, and the browser uses it to connect directly.

<YoutubeEmbed id="M36FyDpvCWk" />

<CardGroup cols={3}>
  <Card
    title="Realtime models"
    icon="duotone waveform-lines"
    href="/docs/eleven-agents/customization/realtime-models"
  >
    Choose a Realtime model and configure an agent's voice mode.
  </Card>
  <Card
    title="OpenAI Realtime API compatibility"
    icon="duotone plug"
    href="/docs/eleven-agents/guides/openai-realtime-compatibility"
  >
    Connect an existing OpenAI Realtime client to ElevenLabs.
  </Card>
  <Card
    title="Create realtime client secret"
    icon="duotone code"
    href="/docs/api-reference/conversations/create-client-secret"
  >
    Review the request and response for minting client secrets.
  </Card>
</CardGroup>

### Realtime Translation

Realtime Translation turns speech in one language into speech in another while the speaker is still talking. It's a [WebSocket API](/docs/api-reference/realtime-translation/v-1-translation-realtime), available now for enterprise workspaces.

You open a connection with a `target_language` and a `voice_id`, then stream audio in. You get translated speech back in that voice. You don't have to say which language the speaker is using, because it's detected automatically, but you can set `source_language` if you know it. Along the way, the server also sends live transcripts of the original speech and the translated text, for example to show captions.

`eagerness` controls the tradeoff between speed and quality. `high` starts translating soonest, and `low` waits for more of the sentence. The translated voice uses Eleven v4 Turbo by default, and you can switch to `eleven_v3` or `eleven_flash_v2_5` with `tts_model_id`. For sensitive conversations, set `enable_zrm=true` to use [Zero Retention Mode](/docs/eleven-api/resources/zero-retention-mode).

<YoutubeEmbed id="sB15uXTYHvA" />

<CardGroup cols={3}>
  <Card
    title="Realtime Translation WebSocket"
    icon="duotone language"
    href="/docs/api-reference/realtime-translation/v-1-translation-realtime"
  >
    Review the connection parameters and message types.
  </Card>
  <Card title="Models" icon="duotone microphone-lines" href="/docs/overview/models">
    Compare the TTS models available for translated speech.
  </Card>
  <Card
    title="Zero Retention Mode"
    icon="duotone shield-check"
    href="/docs/eleven-api/resources/zero-retention-mode"
  >
    Keep transcripts and translations out of logs and history.
  </Card>
</CardGroup>

### Video to Music

Video to Music writes a soundtrack for your video. The [Video to music](/docs/api-reference/music/video-to-music) API is now available: you upload a video and get back music that fits it, without writing a music prompt from scratch. Use it to score product videos, ads and social clips.

You can send up to 10 video files (200 MB combined). They're joined in order and scored as one video. To steer the result, add a text `description` and up to 10 style `tags`.

Three options are worth knowing. `use_audio_as_reference` takes the genre, BPM, instruments and mood from the video's own audio. `add_sfx` adds sound effects that match the video. `separate_tracks` returns the music and the sound effects as separate files in a ZIP, so you can mix them yourself.

<YoutubeEmbed id="dAfDxcJxkBc" />

<CardGroup cols={2}>
  <Card
    title="Video to music API reference"
    icon="duotone code"
    href="/docs/api-reference/music/video-to-music"
  >
    Review the request parameters and response format.
  </Card>
  <Card title="Music overview" icon="duotone music" href="/docs/overview/capabilities/music">
    Learn what Eleven Music can generate and how it can be used.
  </Card>
</CardGroup>

### ElevenAgents

- **Alerts**: [Alerts](/docs/eleven-agents/operate/alerts) notify a workspace when agent error rates exceed a threshold or rise sharply above their recent baseline. Monitors cover conversation failures, tool failures, webhook errors, guardrail triggers, call initiation errors and evaluation success scores, and run with default thresholds without any setup. Agent-level thresholds and notifiers can be set through `platform_settings.alerting` on [Update agent](/docs/api-reference/agents/update). Notifications can be delivered as webhooks, to Slack or to PagerDuty.
- **Guardrails generally available**: [Guardrails](/docs/eleven-agents/best-practices/guardrails) are no longer in alpha.
- **Workspace environments**: Environments for [environment variables](/docs/eleven-agents/integrate/environment-variables) can now be managed through the API with [List environments](/docs/api-reference/environments/list), [Create environment](/docs/api-reference/environments/create) and [Delete environment](/docs/api-reference/environments/delete). A variable without a value for an environment falls back to its `production` value. Deleting an environment removes its values from all variables, and `production` cannot be deleted.
- **Answering machine detection actions**: Twilio answering machine detection settings on [Outbound call](/docs/api-reference/twilio/outbound-call) and [Submit batch call](/docs/api-reference/batch-calling/create) accept `actions`, a list of rules that pair an `action` (`hang_up`) with the `answered_by` verdicts that trigger it, such as `machine_start` or `fax`. Verdicts without a rule leave the call running.
- **New LLMs**: Agents can use `gemini-4-argon`, `claude-opus-4-6` and the ElevenLabs-hosted `nemotron-35-super-vl-nvfp4`. See [Models](/docs/eleven-agents/customization/llm).
- **Authored-only workflow reads**: [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update) accept `include_procedure_generated_workflow_elements`. Set it to `false` to receive only the workflow nodes and edges you authored, excluding the ones compiled from [structured procedures](/docs/eleven-agents/customization/procedures/structured-procedures). Defaults to `true`, so existing callers are unchanged.
- **Branch rebasing from any branch**: [Rebase branch](/docs/api-reference/agents/branches/rebase) and [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) accept an optional `source_branch_id` to pull changes from a branch other than main.
- **Delete agents used as subagents**: [Delete agent](/docs/api-reference/agents/delete) accepts `force`. When `true`, the agent is deleted even if other agents use it as a subagent, and it is removed from those agents and their branches.
- **Sort agents by last update**: [List agents](/docs/api-reference/agents/list) accepts `sort_by=updated_at`, and each agent summary includes `updated_at_unix_secs`, the last time the main branch or agent-level settings changed.
- **Google Calendar event updates**: The [Google Calendar integration](/docs/eleven-agents/customization/integrations/google_calendar) adds `google_calendar_update_event` and `google_calendar_delete_event` tools. Both are privileged tools that can change or cancel any event on the connected calendar.

### Music and Sound Effects

- **Zero Retention Mode**: Music generation, composition plan, stem separation and video to music endpoints, plus [Sound Effects](/docs/api-reference/text-to-sound-effects/convert), accept `enable_logging=false` to use [Zero Retention Mode](/docs/eleven-api/resources/zero-retention-mode). Zero Retention Mode is available to enterprise customers. Music requests that set `store_for_inpainting=true` are rejected in this mode.
- **WAV output for sound effects**: [Sound Effects](/docs/api-reference/text-to-sound-effects/convert) accepts `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` and `wav_48000` output formats.

### Speech Engine

- **40-minute conversations**: [Speech Engine](/docs/overview/capabilities/speech-engine) supports conversations of up to 40 minutes. The default limit remains 10 minutes. Raise `conversation.max_duration_seconds` to allow longer conversations.
- **Sort by last update**: [List Speech Engines](/docs/api-reference/speech-engine/list) accepts `sort_by=updated_at`, and each summary includes `updated_at_unix_secs`.

### Dubbing

- **Subtitles for dubbed languages**: Dubbing project language outputs (`GET /v1/dubbing/project/{project_id}/language/{language_id}`) include `subtitles`, a signed URL to the translated lines as WebVTT subtitles timed to the source speech. The URL expires one hour after it is issued.

### Voices

- **Resubmittable voice reviews**: Voice sharing `review_status` adds `declined_resubmittable` for declined voices that can be resubmitted for review.

### Workspaces

- **Disable service account API keys**: [Disable service account API key](/docs/api-reference/service-accounts/api-keys/disable) disables a service account API key without changing its other settings. It remains available after a workspace downgrades from a plan that includes service accounts.
- **Group concurrency limits**: [List workspace groups](/docs/api-reference/workspace/groups/list) and [List service accounts](/docs/api-reference/service-accounts/list) return `group_concurrency_limit`, `group_dubbing_concurrency_limit` and `group_music_concurrency_limit` for each group, and group permissions add `all_resources_access`.

### SDK releases

#### JavaScript SDK

- [v2.74.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.74.0) - Added `client.conversationalAi.realtime.createClientSecret` for the Realtime API, with the `RealtimeModel` and OpenAI-compatible session configuration types, and an `environments` client with `list`, `create` and `delete`. Also adds `force` on agent deletion, `sourceBranchId` on branch rebase and rebase preview, `includeProcedureGeneratedWorkflowElements` on agent reads, `enableLogging` on Music and Sound Effects methods, WAV output formats for Sound Effects, service account API key `disable`, and Twilio answering machine detection `actions`.
- [v2.73.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.73.0) - Added `createAndWait` helpers for Flows image, video and Text to Speech generations and template runs (`client.flows.templates.runs.createAndWait`). They create the request and poll until it completes or fails, pacing requests with the server's `Retry-After` header. A `failed` result is returned rather than thrown, and `waitTimeoutInSeconds` throws `FlowsWaitTimeoutError` if the work is not finished in time. The regenerated client adds the Video to music `add_sfx`, `separate_tracks` and `use_audio_as_reference` options.

#### Python SDK

- [v2.74.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.74.1) - `music.compose_detailed` now accepts and forwards `enable_logging`, which the custom wrapper previously dropped, so Zero Retention Mode works with this method.
- [v2.74.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.74.0) - Added `client.conversational_ai.realtime.create_client_secret` for the Realtime API and an `environments` client, with the same regenerated API changes as JavaScript SDK v2.74.0.
- [v2.73.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.73.0) - Added `create_and_wait` helpers for Flows image, video and Text to Speech generations and template runs, for both sync and async clients, with `wait_timeout_in_seconds` and `min_poll_interval_in_seconds` options and a `FlowsWaitTimeoutError` exported from `elevenlabs.flows_custom`. Type checkers such as pyright now resolve `client.webhooks.construct_event`, `client.speech_to_text.realtime`, `client.text_to_speech.convert_realtime` and the custom Music methods. Includes the same regenerated API changes as the JavaScript SDK.
- [v2.73.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.73.1) - Fixed the test suite on Python 3.13 and later, and added Python 3.13 and 3.14 to CI.

#### ElevenLabs CLI

- [v1.7.0](https://github.com/elevenlabs/cli/releases/tag/v1.7.0) - Regenerated API commands, adding environments, realtime client secrets and service account API key disabling.
- [v1.6.0](https://github.com/elevenlabs/cli/releases/tag/v1.6.0) - Added `create-and-wait` commands for `flows image`, `flows video`, `flows text-to-speech` and `flows templates runs`. Each command returns a finished result, with `--wait-timeout` and `--min-poll-interval` options.
- [v1.5.1](https://github.com/elevenlabs/cli/releases/tag/v1.5.1), [v1.5.2](https://github.com/elevenlabs/cli/releases/tag/v1.5.2), [v1.5.3](https://github.com/elevenlabs/cli/releases/tag/v1.5.3) and [v1.6.1](https://github.com/elevenlabs/cli/releases/tag/v1.6.1) - Bug fixes for onboarding, including Windows support.

#### Packages

- [@elevenlabs/client@1.28.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.28.0) - Added the experimental `persistentSession` option for resumable text conversations over WebSocket, and the `onConversationHistory` callback for the transcript the server replays on resume. WebSocket sessions now also emit `onConversationMetadata`.
- [@elevenlabs/react@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.18.0) - Forwards the experimental `onConversationHistory` callback to `@elevenlabs/client`.
- [@elevenlabs/types@0.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.25.0) - Added the `conversation_history` server event and the `persistent_session_token` field on `conversation_initiation_metadata`.
- [@elevenlabs/react-native@1.2.30](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.30) - Updated to `@elevenlabs/client@1.28.0` and `@elevenlabs/react@1.18.0`.
- [@elevenlabs/convai-widget-core@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.20.0) and [@elevenlabs/convai-widget-embed@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.20.0) - Added the `persistent-session` attribute. Text conversations survive a dropped connection or a page reload: the widget keeps the transcript, reopens the chat, renders the history replayed by the server and resumes the conversation. **End chat** discards the stored conversation. Workspaces without persistent sessions fall back to a standard conversation.
- [@elevenlabs/convai-widget-core@0.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.19.1) and [@elevenlabs/convai-widget-embed@0.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.19.1) - First message quick replies are shown below the first message in voice calls.

### API

<Accordion title="View API changes">

## New endpoints

### ElevenAgents

- [Create realtime client secret](/docs/api-reference/conversations/create-client-secret) - `POST /v1/convai/realtime/client_secrets` - Create an ephemeral client secret for browser-based Realtime API sessions. Accepts an optional `session` (OpenAI-compatible session configuration with `model` of `eleven_realtime_v1_mini` (default) or `eleven_realtime_v1_max`, `instructions`, `audio`, `tools`, `turn_detection` and `max_duration_seconds` from 60 to 7,200, default 600) and optional `expires_after` with required `seconds` (integer). Returns `value` (string), `expires_at` (integer) and the echoed `session`.

- [List environments](/docs/api-reference/environments/list) - `GET /v1/convai/environments` - List the workspace environments, including `production`. Each environment has `name`, nullable `updated_at_unix_secs` and nullable `created_by_user_id`.
- [Create environment](/docs/api-reference/environments/create) - `POST /v1/convai/environments` - Create an environment with a required, unique `name` (string). Returns `409` if the name is taken.
- [Delete environment](/docs/api-reference/environments/delete) - `DELETE /v1/convai/environments/{environment}` - Delete an environment and remove its values from all environment variables. Returns `204`.

### Workspaces

- [Disable service account API key](/docs/api-reference/service-accounts/api-keys/disable) - `POST /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}/disable` - Disable a service account API key without changing its other settings.

## Updated endpoints

### ElevenAgents

- [Get agent](/docs/api-reference/agents/get), [Update agent](/docs/api-reference/agents/update), [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) and [Preview merge](/docs/api-reference/agents/branches/preview-merge)
  - Added optional `include_procedure_generated_workflow_elements` (boolean, default `true`). When `false`, the returned workflow contains only authored nodes and edges, without those generated from structured procedures.
- [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update)
  - The `llm` enum adds `gemini-4-argon`, `claude-opus-4-6` and `nemotron-35-super-vl-nvfp4`.
  - TTS configuration `effects` removes the deprecated `seed` field.
- [Delete agent](/docs/api-reference/agents/delete) - Added optional `force` (boolean, default `false`).
- [List agents](/docs/api-reference/agents/list) - `sort_by` adds `updated_at`. Agent summaries add required `updated_at_unix_secs` (integer).
- [Rebase branch](/docs/api-reference/agents/branches/rebase) and [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) - Added optional `source_branch_id` (string). Defaults to the agent's main branch.
- [Outbound call](/docs/api-reference/twilio/outbound-call), [Submit batch call](/docs/api-reference/batch-calling/create) and [Get batch call](/docs/api-reference/batch-calling/get)
  - Twilio machine detection configuration adds `actions`, an array of rules with required `action` (`hang_up`) and required `answered_by` (array of `human`, `fax`, `unknown`, `machine_start`, `machine_end_beep`, `machine_end_silence` or `machine_end_other`). Each action can appear in at most one rule.
- [Get conversation details](/docs/api-reference/conversations/get)
  - Transcript tool calls add nullable `tool_id` (string). It is not set for tools without an ID, such as system tools.
  - Turn metrics add nullable `voice_id` (string).
  - Tool results add nullable `to_agent` and `to_node` (string).
  - WhatsApp conversation info adds nullable `recipient` with nullable `phone` and `bsuid` (string), and nullable `call_permission_request` with required `state` (`blocked`, `sent`, `accepted` or `declined`) and nullable `requested_at_unix` (integer).
  - The platform charge category enum adds `v3_addon`, `v4_addon` and `rag_addon`.
- [Get ticket](/docs/api-reference/triage-tickets/get), [List tickets](/docs/api-reference/triage-tickets/list) and [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace)
  - Ticket responses add required `status_changes`, an array of objects with `status`, nullable `changed_by_user_id` (string) and `changed_at_unix_secs` (integer).

### Text to Speech and Text to Dialogue

- [Create speech](/docs/api-reference/text-to-speech/convert), [Stream speech](/docs/api-reference/text-to-speech/stream), [Create dialogue](/docs/api-reference/text-to-dialogue/convert) and [Stream dialogue](/docs/api-reference/text-to-dialogue/stream), including their timestamp variants - `use_pvc_as_ivc` is now nullable and no longer declares a default of `false`.

### Music

- [Compose music](/docs/api-reference/music/compose), [Compose detailed](/docs/api-reference/music/compose-detailed), [Stream music](/docs/api-reference/music/stream), [Compose detailed stream](/docs/api-reference/music/compose-detailed-stream), [Separate stems](/docs/api-reference/music/separate-stems), [Video to music](/docs/api-reference/music/video-to-music) and `POST /v1/music/plan`
  - Added optional `enable_logging` query parameter (boolean, default `true`). Set it to `false` for Zero Retention Mode.
- [Video to music](/docs/api-reference/music/video-to-music) - Added optional `add_sfx`, `separate_tracks` and `use_audio_as_reference` (boolean, default `false`).

### Sound Effects

- [Create sound effect](/docs/api-reference/text-to-sound-effects/convert)
  - Added optional `enable_logging` query parameter (boolean, default `true`).
  - `output_format` adds `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` and `wav_48000`.

### Speech Engine

- [List Speech Engines](/docs/api-reference/speech-engine/list) - `sort_by` adds `updated_at`. Summaries add required `updated_at_unix_secs` (integer).

### Speech to Text

- [Create transcript](/docs/api-reference/speech-to-text/convert) and [Get transcript](/docs/api-reference/speech-to-text/get) - Edited transcripts add required, read-only `edited_text` (string), matching `text` and the `edited_text` field of the realtime `edited_transcript` event.

### Dubbing

- `GET /v1/dubbing/project/{project_id}/language` and `GET /v1/dubbing/project/{project_id}/language/{language_id}` - Language outputs add nullable `subtitles` (string, signed URL).

### Voices

- [Get voice](/docs/api-reference/voices/get), [List voices](/docs/api-reference/voices/search) and [Get voices](/docs/api-reference/voices/get-all) - Voice sharing `review_status` adds `declined_resubmittable`.

### Workspaces

- [List workspace groups](/docs/api-reference/workspace/groups/list) and [List service accounts](/docs/api-reference/service-accounts/list)
  - Groups add nullable `group_concurrency_limit`, `group_dubbing_concurrency_limit` and `group_music_concurrency_limit` (integer or `unlimited`).
  - Group permissions add `all_resources_access`.

</Accordion>

## October 12, 2026

### ElevenAgents

- **Merge and search triage tickets**: [Merge tickets](/docs/api-reference/triage-tickets/merge) folds up to 50 open tickets from the same agent into one target ticket. Merged tickets keep the status `merged` and reference the target through `merged_into_ticket_id`. [List tickets](/docs/api-reference/triage-tickets/list) and [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) add a case-insensitive `search` parameter that matches ticket titles, descriptions, comments and turn comments, and each result includes a `search_match` excerpt showing where the query matched.
- **Workflow End node outcomes**: Workflow End nodes accept an `outcome` of `success` (default) or `failure`, so a workflow can record whether a conversation ended successfully. The conversation error type adds `workflow_end_failure`.
- **Call queueing enabled for new agents**: New agents are created with [call queueing](/docs/eleven-agents/guides/call-queueing) enabled unless `platform_settings.queueing_config.enabled` is set explicitly. Existing agents keep their current setting.
- **Post-call audio webhook retries**: When **Enable retries** is on, `post_call_audio` [webhooks](/docs/eleven-agents/workflows/post-call-webhooks) are retried on the same schedule as transcription webhooks. Audio payloads over 50 MiB are not retried, and queued audio retries are capped at 400 MiB per webhook.
- **Strict tool overrides**: The conversation override `tool_ids_strict` makes an overridden `tool_ids` list the complete set of tools available in the conversation, including tools on workflow nodes. It is ignored when set on the agent itself.
- **Widget end confirmation**: The widget can ask users to confirm before ending a chat or call. Enable it with `end_confirmation_enabled` in the widget configuration or the `end-confirmation` attribute.

### Text to Speech

- **Audio effects**: [Text to Speech](/docs/api-reference/text-to-speech/convert) and [Text to Dialogue](/docs/api-reference/text-to-dialogue/convert) requests accept an optional `audio_effects` object. It applies a filter preset, perceived distance, a reverb environment, a looped background noise bed and stereo panning to the generated audio. List valid preset, environment and background noise IDs with `GET /v1/audio-effects/catalog`. Reverb and non-zero panning produce stereo audio and are rejected for `ulaw_*`, `alaw_*` and `pcm_*` output formats. Effects do not change the cost of a request.

### Speech to Text

- **Turn prediction commit strategy**: The [realtime Speech to Text WebSocket](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime) adds `turn_prediction` as a `commit_strategy` value. In addition to silence-based segmentation, it commits a segment as soon as the model predicts the speaker has finished their turn. It is the default for models that predict turns, and partial transcripts from those models include `turn_probability`. See [transcripts and commit strategies](/docs/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies).

### Voices

- **Voice collections API**: Voice collections can now be managed through the API. Create, list, update and delete collections, and add or remove voices. See [List voice collections](/docs/api-reference/voices/collections/list).

### Workspaces

- **Basic seat fallback**: [Update member](/docs/api-reference/workspace/members/update) accepts `allow_downgrade_to_basic_seat`. When unlocking a user whose original seat type has no seats available, the user is moved to a basic seat instead of the request failing.
- **Workspace ID on user**: [Get user](/docs/api-reference/user/get) returns the `workspace_id` of the workspace the API key belongs to.

### SDK releases

#### JavaScript SDK

- [v2.72.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy.

#### Python SDK

- [v2.72.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy. `play()` and `save()` now accept any iterable of audio chunks, such as a list or tuple. `RealtimeEvents.CLOSE` handlers receive a dictionary with the WebSocket close `code` and `reason`; handlers without parameters continue to work.

#### ElevenLabs CLI

- [v1.5.0](https://github.com/elevenlabs/cli/releases/tag/v1.5.0) - Regenerated API commands, adding voice collections, the audio effects catalog, triage ticket merging and agent merge proposals.

#### Packages

- [@elevenlabs/client@1.27.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.27.0) and [@elevenlabs/react@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.17.0) - Added a `previousText` option to `Scribe.connect()` and `useScribe()` in microphone mode. The text is sent with the first audio chunk to give the model context, such as existing document text, for casing, punctuation and sentence continuation. `MediaDeviceOutput` now receives `libsampleratePath`, so output resampling uses the same custom libsamplerate bundle path as `MediaDeviceInput`.
- [@elevenlabs/react-native@1.2.29](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.29) - Updated to `@elevenlabs/client@1.27.0` and `@elevenlabs/react@1.17.0`.
- [@elevenlabs/convai-widget-core@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.19.0) and [@elevenlabs/convai-widget-embed@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.19.0) - Added an optional confirmation dialog before ending a chat or call, enabled with the `end-confirmation` attribute or `end_confirmation_enabled` config, with customizable text. Added carousel rich content with scrollable item cards that can include an image, subtitle, description and actions. Carousels remain in the transcript after a reply, without their actions. Rich content is now shown during voice calls when the transcript is visible.

### API

<Accordion title="View API changes">

## New endpoints

### ElevenAgents

- [Merge tickets](/docs/api-reference/triage-tickets/merge) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/merge` - Merge open tickets into the target ticket. Requires `source_ticket_ids` (string array, 1–50 items) and returns the target ticket.

### Voices

- [List voice collections](/docs/api-reference/voices/collections/list) - `GET /v1/voices/collections` - List the voice collections the caller can access, sorted by title.
- [Create voice collection](/docs/api-reference/voices/collections/create) - `POST /v1/voices/collections` - Create a collection with required `title` and `icon` (string, maximum 1,000 characters each).
- [Get voice collection](/docs/api-reference/voices/collections/get) - `GET /v1/voices/collections/{collection_id}` - Retrieve a collection with its `title`, `icon` and the caller's `permission_on_resource` (`admin`, `editor`, `commenter` or `viewer`).
- [Update voice collection](/docs/api-reference/voices/collections/update) - `PATCH /v1/voices/collections/{collection_id}` - Update the optional `title` or `icon`.
- [Delete voice collection](/docs/api-reference/voices/collections/delete) - `DELETE /v1/voices/collections/{collection_id}`
- [Add voice to collection](/docs/api-reference/voices/collections/add-voice) - `POST /v1/voices/collections/{collection_id}/voice/{voice_id}`
- [Remove voice from collection](/docs/api-reference/voices/collections/remove-voice) - `DELETE /v1/voices/collections/{collection_id}/voice/{voice_id}`

### Audio effects

- `GET /v1/audio-effects/catalog` - List the available `filter_presets`, `environments` and `background_noises`. Each entry has an ID, a `name` and a nullable `description`.

## Updated endpoints

### ElevenAgents

- [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update)
  - Workflow End nodes add `outcome` (`success` or `failure`, default `success`). The field is required in responses.
  - Standalone workflow agent nodes and agent transfer configurations add nullable `branch_id` (string) to target a specific branch of the destination agent. When unset, the transfer follows the target agent's traffic deployment. Transfer tool results add a `configured` branch reason.
  - Prompt override configurations add `tool_ids_strict` (boolean, default `false`).
  - TTS configuration `effects` add `pan` (number, -1 to 1, default `0`). The `seed` field is deprecated and has no effect.
- [Get widget config](/docs/api-reference/widget/get) - Added `end_confirmation_enabled` (boolean, default `false`).
- [List tickets](/docs/api-reference/triage-tickets/list)
  - Added optional `search` (string, maximum 200 characters) and `merged_into_ticket_id` (string) query parameters.
  - Ticket responses add nullable `merged_into_ticket_id` and nullable `search_match` with `field` (`title`, `description`, `comment` or `turn_comment`), `snippet`, `highlight_start`, `highlight_end` and nullable `turn_index`.
- [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) - Added optional `agent_id`, `sources`, `priorities`, `sort_by` (`created_at` or `priority`, default `created_at`), `owner_user_id`, `issue_type`, `label`, `merged_into_ticket_id` and `search` query parameters.
- [List tests](/docs/api-reference/tests/list) - Added optional `created_by_user_id` (string). Use `@me` for the authenticated user.
- [List test invocations](/docs/api-reference/tests/test-invocations/list) - Added optional `test_id` (string), `version_id` (string), `start_time` and `end_time` (integer, Unix seconds, inclusive) query parameters.
- [Update agent branch](/docs/api-reference/agents/branches/update) - Added optional `auto_rebase` (boolean). Branch responses add `auto_rebase` (boolean, default `false`).
- [Get conversation details](/docs/api-reference/conversations/get)
  - Twilio, SIP trunk and Exotel phone call metadata add nullable `call_result` with `answered`, `voicemail`, `busy`, `no_answer` and `failed` values.
  - Batch call metadata adds nullable `cold_attempt` (integer) and nullable `conversation_type` (`initial`, `retry`, `callback` or `redirect`).
  - The conversation error type adds `workflow_end_failure`.
- Knowledge base auto-sync `auto_discover` is deprecated and no longer has any effect.

### Text to Speech

- [Create speech](/docs/api-reference/text-to-speech/convert), [Stream speech](/docs/api-reference/text-to-speech/stream), [Create speech with timing](/docs/api-reference/text-to-speech/convert-with-timestamps) and [Stream speech with timing](/docs/api-reference/text-to-speech/stream-with-timestamps)
  - Added optional nullable `audio_effects` with `filter_preset_id` (string), `distance` (number, 0–1, default `0`), `environment_id` (string), `background_noise_id` (string), `send_level` (number, 0–1, default `1`) and `pan` (number, -1 to 1, default `0`).
  - Unknown effect IDs return `404`. Stereo effects return `400` for `ulaw_*`, `alaw_*` and `pcm_*` output formats.

### Text to Dialogue

- [Create dialogue](/docs/api-reference/text-to-dialogue/convert), [Stream dialogue](/docs/api-reference/text-to-dialogue/stream), [Create dialogue with timestamps](/docs/api-reference/text-to-dialogue/convert-with-timestamps) and [Stream dialogue with timestamps](/docs/api-reference/text-to-dialogue/stream-with-timestamps) - Added optional nullable `audio_effects`, matching the Text to Speech endpoints.

### Speech to Text

- [Realtime Speech to Text](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime)
  - The `commit_strategy` query parameter adds `turn_prediction`, alongside `manual` and `vad`.
  - `partial_transcript` messages add optional `turn_probability` (number), sent only for models that predict turns.

### Music

- `POST /v1/music/video-to-music` - Responses add a `song-id` header with the ID of the generated song.

### History

- [List generated items](/docs/api-reference/history/list) - The history item `source` enum adds `VoicePreview`.

### Workspace and user

- [Update member](/docs/api-reference/workspace/members/update) - Added optional `allow_downgrade_to_basic_seat` (boolean, default `false`).
- [Get user](/docs/api-reference/user/get) - Added required `workspace_id` (string).
- Service account API key permissions add `voice_collections_read` and `voice_collections_write`.

</Accordion>

## October 5, 2026

### ElevenAgents

- **구조화된 절차는 저장 및 게시 시 컴파일됩니다**: 이제 [에이전트 업데이트](/docs/ko/api-reference/agents/update) 및 [에이전트 초안 생성](/docs/ko/api-reference/agents/drafts/create)이 [구조화된 절차](/docs/ko/eleven-agents/customization/procedures/structured-procedures)를 자동으로 컴파일하고 검증합니다. 더 이상 통합에서 컴파일 엔드포인트를 호출하거나 생성된 워크플로를 수동으로 업데이트할 필요가 없습니다. 유효하지 않은 절차는 `400 procedure_validation_failed`로 절차별 오류를 반환합니다. 구조화된 절차가 없는 에이전트는 영향을 받지 않습니다.
- **절차 컴파일 엔드포인트는 레거시입니다**: [절차 컴파일](/docs/ko/api-reference/agents/procedures/compile)은 레거시로 표시되며 새 통합에서 사용하면 안 됩니다. 기존 호출자에게는 계속 제공됩니다.
- **병합 제안**: 병합 제안은 알파 버전으로 제공됩니다. 팀은 에이전트 브랜치에 대한 제안을 열고, 구성 변경 사항과 테스트 결과를 검토하며, 댓글이나 승인 결정을 남기고, 승인된 변경 사항을 대상 브랜치에 병합할 수 있습니다. [병합 제안](/docs/ko/eleven-agents/operate/merge-proposals)을 참조하세요.

### SDK 릴리스

#### JavaScript SDK

- [v2.71.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.71.0) - 에이전트 병합 제안, 배포 기록, 테스트 호출 취소, Speech Engine 복제용 클라이언트를 추가했습니다. 또한 트리아지 티켓 우선순위 및 정렬, 배치 통화 내보내기 제한, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 에이전트 음성 모델 및 최신 에이전트 구성 타입을 추가했습니다.

#### Python SDK

- [v2.71.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.71.0) - 에이전트 병합 제안, 배포 기록, 테스트 호출 취소, Speech Engine 복제용 클라이언트를 추가했습니다. 또한 트리아지 티켓 우선순위 및 정렬, 배치 통화 내보내기 제한, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 에이전트 음성 모델 및 최신 에이전트 구성 타입을 추가했습니다.

#### Swift SDK

- [v3.4.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.4.0) - 이제 동적 변수가 대화 시작 데이터로 전송될 때 네이티브 JSON 타입을 유지합니다.

#### 패키지

- [@elevenlabs/client@1.26.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.26.0), [@elevenlabs/react@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.16.0), [@elevenlabs/react-native@1.2.28](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.28), [@elevenlabs/types@0.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.24.0) - `transcriptEdit`, `edited_transcript` 이벤트, React의 `onEditedTranscript` 콜백을 통해 실시간 음성-텍스트 변환 트랜스크립트 편집을 추가했습니다. 이제 React는 `filterBackgroundAudio`를 실시간 세션으로 전달합니다. 클라이언트는 `MessagePayload`도 내보내며, 중복 에이전트 답변을 방지하기 위해 안정적인 응답 ID를 사용합니다.
- [@elevenlabs/convai-widget-core@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.3) 및 [@elevenlabs/convai-widget-embed@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.3) - 첨부 파일만 있는 답변을 포함해 에이전트 메시지 첨부 파일의 이미지 미리 보기와 다운로드 링크를 추가했습니다. 안정적인 응답 ID가 중복 답변을 방지하며, 이제 텍스트 전용 대화에서는 **채팅 종료** 툴팁이 있는 중지 컨트롤을 사용합니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- [병합 제안 생성](/docs/ko/api-reference/agents/merge-proposals/create) - `POST /v1/convai/agents/{agent_id}/merge-proposals` - 필수 `source_branch_id`, `target_branch_id`, `title` 필드와 선택적 설명, 검토자 ID, 트리아지 티켓 ID로 제안을 생성합니다.
- [병합 제안 나열](/docs/ko/api-reference/agents/merge-proposals/list) - `GET /v1/convai/agents/{agent_id}/merge-proposals` - 상태, 소스 브랜치, 대상 브랜치, 텍스트 필터 및 커서 페이지네이션으로 제안을 나열합니다.
- [병합 제안 가져오기](/docs/ko/api-reference/agents/merge-proposals/get) - `GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - 제안과 검토, 댓글, 결과 세부 정보를 조회합니다.
- [병합 제안 업데이트](/docs/ko/api-reference/agents/merge-proposals/update) - `PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - 제목, 설명 또는 요청된 검토자를 업데이트하거나 병합하지 않고 닫습니다.
- [병합 제안 검토](/docs/ko/api-reference/agents/merge-proposals/submit-review) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews` - 선택적 댓글과 함께 `approved` 또는 `changes_requested` 결정을 제출합니다.
- [병합 제안에 댓글 달기](/docs/ko/api-reference/agents/merge-proposals/add-comment) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments` - 최대 4,096자의 Markdown 댓글을 추가합니다.
- [병합 제안 병합](/docs/ko/api-reference/agents/merge-proposals/merge) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge` - 소스 브랜치를 병합하고, 필요에 따라 강제 충돌 해결 및 소스 브랜치 보관을 제어합니다.
- [에이전트 배포 나열](/docs/ko/api-reference/agents/deployments/list) - `GET /v1/convai/agents/{agent_id}/deployments` - 페이지 기반 페이지네이션으로 현재 및 과거 브랜치 트래픽 분할을 나열합니다.
- [테스트 호출 취소](/docs/ko/api-reference/tests/test-invocations/cancel) - `POST /v1/convai/test-invocations/{test_invocation_id}/cancel` - 실행 중인 테스트 호출을 취소합니다.

### Speech Engine

- [Speech Engine 복제](/docs/ko/api-reference/speech-engine/duplicate) - `POST /v1/speech-engine/{speech_engine_id}/duplicate` - Speech Engine을 복제하고, 선택적으로 사본에 새 `name`을 할당합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [에이전트 생성](/docs/ko/api-reference/agents/create), [에이전트 가져오기](/docs/ko/api-reference/agents/get), [에이전트 업데이트](/docs/ko/api-reference/agents/update)
  - `LLM` 열거형에 `gpt-6.1-sol` 및 `claude-sonnet-5-5`를 추가했습니다.
  - 대화형 TTS 모델 옵션에 `eleven_v4` 및 `eleven_v4_turbo`를 추가했습니다. 기본값은 `eleven_flash_v2`에서 `eleven_v4_turbo`로 변경되었습니다.
  - 에이전트 전송 및 독립형 워크플로 에이전트 노드에 전송 후 기본 음성, TTS 모델 및 음성 설정을 유지하는 선택적 `preserve_voice_settings`(불리언, 기본값 `false`)를 추가했습니다.
  - 턴 건너뛰기 도구 구성에 선택적 `wait_timeout_secs`(숫자, 기본값 `-1`)를 추가했습니다. 값이 `-1`이면 발신자가 말할 때까지 에이전트가 무음 상태를 유지합니다.
  - 통화 후 웹훅 구성에 JSON 트랜스크립션 웹훅에서 턴별 트랜스크립트를 생략하는 선택적 `exclude_transcript`(불리언, 기본값 `false`)를 추가했습니다.
  - 대화 기록 수정 구성에 근거를 수정하는 동안 선택한 추출 값을 유지하는 선택적 `excluded_data_collection_ids`(문자열 배열, 최대 50개)를 추가했습니다.
  - 이제 클라이언트 도구 `response_timeout_secs`는 `expects_response`가 활성화된 경우 무기한 대기하도록 `-1`을 허용합니다.
- [티켓 나열](/docs/ko/api-reference/triage-tickets/list)
  - `low`, `medium`, `high`, `urgent` 값을 포함하는 선택적 `priorities`(배열)를 추가했습니다.
  - `created_at` 및 `priority` 값을 갖는 `sort_by`를 추가했으며, 기본값은 `created_at`입니다.
  - 이제 티켓 응답에는 `title`, nullable `priority`, `priority_changes` 배열이 필요합니다. 티켓 생성 및 업데이트 요청에서 `priority`를 설정할 수 있으며, 티켓 상태에 `cancelled`가 추가되었습니다.
- [도구 나열](/docs/ko/api-reference/tools/list) - 에이전트의 기본 브랜치에서 참조되는 도구를 반환하는 선택적 nullable `used_by_agent_id`(문자열)를 추가했습니다.
- [배치 통화 결과 내보내기](/docs/ko/api-reference/batch-calling/export) - 첫 번째 수신자만 열 미리 보기로 내보내는 선택적 nullable `limit`(정수, 최소 `1`)를 추가했습니다.
- [테스트 호출 나열](/docs/ko/api-reference/tests/test-invocations/list) 및 [테스트 호출 가져오기](/docs/ko/api-reference/tests/test-invocations/get)
  - 테스트 호출 요약에 필수 `cancelled_count`(정수) 및 선택적 `cancelled`(불리언, 기본값 `false`)를 추가했습니다.
  - 테스트 실행 상태에 `cancelled`를 추가했습니다.
- [대화 세부 정보 가져오기](/docs/ko/api-reference/conversations/get) - 트랜스크립트 항목에 `user_turn_timeout` 및 `skip_turn_wait_elapsed` 값을 갖는 선택적 nullable `platform_event`를 추가했습니다.
- [에이전트 버전 메타데이터 가져오기](/docs/ko/api-reference/agents/versions/get) - 기본 브랜치에 병합된 변경 사항을 게시한 사람을 설명하는 배열인 선택적 nullable `merged_authors`를 추가했습니다.
- [크롤 작업 가져오기](/docs/ko/api-reference/knowledge-base/get-crawl-job) - 지원 중단된 `max_depth` 응답 필드를 제거했습니다.

</Accordion>

## September 28, 2026

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### Eleven v4 및 Eleven v4 Turbo

이제 [Eleven v4 및 Eleven v4 Turbo](/docs/ko/overview/capabilities/text-to-speech/eleven-v4)를 사용할 수 있습니다. Eleven v4는 90개 이상의 언어에서 더 높은 품질과 표현력이 풍부한 음성, 향상된 음성 복제를 제공합니다. Eleven v4 Turbo는 실시간 애플리케이션을 위한 동일한 모델 제품군으로, 중앙값 추론 지연 시간은 약 100ms입니다.

콘텐츠 제작 및 장문 오디오에는 Text to Dialogue API를 통해 `eleven_v4`를 사용하세요. 에이전트 및 인터랙티브 애플리케이션에는 Text to Dialogue WebSocket을 통해 `eleven_v4_turbo`를 사용하세요.

<YoutubeEmbed id="4QHFkK2MTcw" />

<CardGroup cols={3}>
  <Card
    title="Eleven v4 개요"
    icon="duotone book"
    href="/docs/ko/overview/capabilities/text-to-speech/eleven-v4"
  >
    두 모델 변형, 음성 복제 동작, 설정 및 지원 언어를 비교하세요.
  </Card>
  <Card
    title="Text to Dialogue API"
    icon="duotone code"
    href="/docs/ko/api-reference/text-to-dialogue/convert"
  >
    Eleven v4로 고품질 대화를 생성하세요.
  </Card>
  <Card
    title="실시간 스트리밍"
    icon="duotone code"
    href="/docs/ko/eleven-api/guides/how-to/websockets/realtime-tdd"
  >
    WebSocket 연결을 통해 Eleven v4 Turbo 대화를 스트리밍하세요.
  </Card>
</CardGroup>

### 음성-텍스트 변환

- **트랜스크립트 편집**: 이제 배치 및 실시간 트랜스크립션에서 최대 2,000자의 자연어 편집 지시문을 받을 수 있습니다. 배치 응답은 `edited_transcript`에 결과를 반환하며, 실시간 세션은 `edited_transcript` 이벤트를 내보냅니다. 호환되지 않는 기능, 응답 처리 및 가격은 [배치](/docs/ko/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing) 및 [실시간](/docs/ko/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing) 가이드를 참조하세요.

### ElevenAgents

- **에이전트 모델**: 지원되는 에이전트 LLM 옵션에 `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5`, `claude-opus-5-5`를 추가했습니다.
- **에이전트 테스트 사용량**: 테스트 호출 요약에 총 크레딧 및 USD 가격을 포함할 수 있습니다. 개별 테스트 실행에는 크레딧 및 과금 내역을 포함할 수 있습니다.

### Flows

- **템플릿 API**: 게시된 Flows 템플릿을 나열하고 검색하며, 템플릿 실행을 시작하고 실행 결과를 조회하는 엔드포인트를 추가했습니다. 실행은 게시된 버전을 대상으로 할 수 있으며, 최종 결과를 구성된 웹훅으로 전송할 수 있습니다.

### Text to Dialogue

- **생성 연속성**: Text to Dialogue 요청에서 이전 또는 이후 텍스트와 요청 ID를 사용해 여러 생성 간 연속성을 유지할 수 있습니다.
- **프로페셔널 음성 모드**: Text to Dialogue 요청에서 프로페셔널 음성 복제의 즉석 음성 복제 버전을 사용해 지연 시간을 줄이거나 표현력을 높일 수 있습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.70.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.70.0) - 배치 및 실시간 음성-텍스트 변환 트랜스크립트 편집 타입, 테스트 호출 요약용 `branchId` 필터링 및 비용 필드, 지식 베이스 자동 검색, Text to Dialogue `usePvcAsIvc`, `deepseek-v41-flash` 에이전트 모델을 추가했습니다.

#### Python SDK

- [v2.70.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.70.0) - 배치 및 실시간 음성-텍스트 변환 트랜스크립트 편집 타입, 테스트 호출 요약용 `branch_id` 필터링 및 비용 필드, 지식 베이스 자동 검색, Text to Dialogue `use_pvc_as_ivc`, `deepseek-v41-flash` 에이전트 모델을 추가했습니다.

#### ElevenLabs CLI

- [v1.4.0](https://github.com/elevenlabs/cli/releases/tag/v1.4.0) - 명시적 API 키를 사용하는 요청이 저장된 OAuth 자격 증명도 함께 전송하여 인증에 실패하던 문제를 수정했습니다. 피드백 명령 그룹에 설명을 추가하고, 생성된 에이전트 스킬에서 누락된 기능을 신고하는 방법을 추가했습니다. Flows 템플릿 엔드포인트 및 최신 스키마 타입으로 API 클라이언트를 다시 생성했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### Flows

- [템플릿 나열](/docs/ko/api-reference/flows/templates/list) - `GET /v1/flows/templates` - 게시된 템플릿과 실행 가능한 버전을 나열합니다.
- [템플릿 가져오기](/docs/ko/api-reference/flows/templates/get) - `GET /v1/flows/templates/{template_id}` - 템플릿과 실행 가능한 버전을 조회합니다.
- [템플릿 실행 생성](/docs/ko/api-reference/flows/templates/runs/create) - `POST /v1/flows/templates/{template_id}/runs` - 입력 값, 선택적 버전 및 선택적 웹훅으로 템플릿 실행을 시작합니다.
- [템플릿 실행 나열](/docs/ko/api-reference/flows/templates/runs/list) - `GET /v1/flows/templates/{template_id}/runs` - 커서 페이지네이션 및 선택적 버전 필터링으로 템플릿 실행을 나열합니다.
- [템플릿 실행 가져오기](/docs/ko/api-reference/flows/templates/runs/get) - `GET /v1/flows/templates/{template_id}/runs/{run_id}` - 템플릿 실행과 출력 상태를 조회합니다.

## 업데이트된 엔드포인트

### 음성-텍스트 변환

- [음성을 텍스트로 변환](/docs/ko/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - 최대 2,000자의 자연어 편집 지시문을 받을 수 있는 선택적 nullable `transcript_edit`(문자열)를 추가했습니다.
  - 응답에 선택적 nullable `edited_transcript`를 추가했습니다. 편집에 성공하면 필수 `kind: "transcript"` 및 `text` 필드가 포함됩니다. 편집에 실패하면 필수 `kind: "error"`, `error_type: "edit_failed"`, `message` 필드가 포함됩니다.
- [실시간 음성-텍스트 변환](/docs/ko/api-reference/speech-to-text/v-1-speech-to-text-realtime)은 `transcript_edit`(문자열)를 수락하고 필수 `text` 및 `edited_text` 필드가 있는 `edited_transcript` 이벤트를 내보냅니다.

### ElevenAgents

- [에이전트 생성](/docs/ko/api-reference/agents/create), [에이전트 가져오기](/docs/ko/api-reference/agents/get), [에이전트 업데이트](/docs/ko/api-reference/agents/update)
  - `LLM` 열거형에 `gpt-6-sol`, `gpt-6-luna`, `glm-52`, `deepseek-v41-flash`, `claude-opus-5`, `claude-opus-5-5`를 추가했습니다.
  - 알림 모니터에 모니터의 알림 전송 여부를 제어하는 선택적 nullable `enabled`(불리언)를 추가했습니다.
- [대화 나열](/docs/ko/api-reference/conversations/list) 및 [텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search)
  - `data_collection_params` 및 `dynamic_variable_params`에 `neq` 및 `in` 연산자를 추가했습니다. `in`의 값은 파이프 구분 기호를 사용합니다.
  - `evaluation_params`는 결과 값으로 `success`, `failure` 또는 `unknown`을 허용합니다.
- [스마트 검색](/docs/ko/api-reference/conversations/messages/search) - `GET /v1/convai/conversations/messages/smart-search`
  - 선택적 nullable `branch_id`(문자열)를 추가했습니다.
- [테스트 호출 나열](/docs/ko/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
  - 선택적 nullable `branch_id`(문자열)를 추가했습니다.
  - 테스트 호출 요약에 선택적 nullable `credits_used`(정수) 및 `total_price`(숫자)를 추가했습니다.
- [테스트 호출 가져오기](/docs/ko/api-reference/tests/test-invocations/get) - `GET /v1/convai/test-invocations/{test_invocation_id}`
  - 개별 테스트 실행에 선택적 nullable `credits_used`(정수) 및 `charging`(`ConversationChargingCommonModel`)을 추가했습니다.
- [대화 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation) 및 [대화 스트림 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation-stream)
  - 선택적 `new_turns_limit` 기본값을 `10,000`에서 `100`으로 변경하고 최대값을 `100`으로 설정했습니다.
- [크롤 작업 생성](/docs/ko/api-reference/knowledge-base/create-crawl-job) 및 [크롤 작업 가져오기](/docs/ko/api-reference/knowledge-base/get-crawl-job)
  - 자동 동기화 중 링크를 따라가 새로 발견된 페이지를 추가하는 선택적 `auto_discover`(불리언, 기본값 `false`)를 추가했습니다. 이를 사용하려면 `enable_auto_sync: true`가 필요합니다.
- [지식 베이스 문서 새로 고침](/docs/ko/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh`
  - `AutoSyncInfo`에 새로 고침 시 새로 발견된 페이지를 크롤링하고 추가하는지 나타내는 선택적 `auto_discover`(불리언, 기본값 `false`)를 추가했습니다.
- [MCP 서버 도구 나열](/docs/ko/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
  - 응답에 선택적 `tool_approval_statuses`(배열)를 추가했습니다. 각 항목에는 필수 `tool_id`(문자열)와 `state`(`up_to_date`, `needs_review` 또는 `not_approved`)가 포함되며, 선택적 승인 정책 및 승인된 정의 필드가 포함됩니다.

### Text to Dialogue

- [텍스트를 대화로 변환](/docs/ko/api-reference/text-to-dialogue/convert), [텍스트를 대화로 스트리밍](/docs/ko/api-reference/text-to-dialogue/stream), [타임스탬프와 함께 변환](/docs/ko/api-reference/text-to-dialogue/convert-with-timestamps), [타임스탬프와 함께 스트리밍](/docs/ko/api-reference/text-to-dialogue/stream-with-timestamps)
  - 프로페셔널 음성 복제의 즉석 음성 복제 버전을 사용하는 선택적 `use_pvc_as_ivc`(불리언, 기본값 `false`)를 추가했습니다.
  - 생성 연속성을 위해 선택적 nullable `previous_text` 및 `future_text`(문자열, 최대 100자)와 `previous_request_ids` 및 `next_request_ids`(문자열 배열, 최대 3개 ID)를 추가했습니다.
  - 선택적 `settings` 객체에 nullable `similarity`(숫자, 0~1, 기본값 `0.75`)를 추가했습니다.

### 텍스트 음성 변환

- [텍스트를 음성으로 변환](/docs/ko/api-reference/text-to-speech/convert), [텍스트를 음성으로 스트리밍](/docs/ko/api-reference/text-to-speech/stream), [타임스탬프와 함께 변환](/docs/ko/api-reference/text-to-speech/convert-with-timestamps), [타임스탬프와 함께 스트리밍](/docs/ko/api-reference/text-to-speech/stream-with-timestamps)
  - 기존 `use_pvc_as_ivc` 필드는 더 이상 지원 중단되지 않습니다.

### Flows

- [이미지 생성 생성](/docs/ko/api-reference/flows/image/create), [비디오 생성 생성](/docs/ko/api-reference/flows/video/create), [템플릿 실행 생성](/docs/ko/api-reference/flows/templates/runs/create)
  - 이제 웹훅 대상에 명시적 `type` 구분자(`all` 또는 `ids`)가 필요합니다. 이전 기본값은 제거되었습니다.

### 보이스 디자인

- [미리 보기에서 음성 생성](/docs/ko/api-reference/text-to-voice/create), [음성 미리 보기 생성](/docs/ko/api-reference/legacy/voices/create-previews), [음성 디자인](/docs/ko/api-reference/text-to-voice/design), [음성 리믹스](/docs/ko/api-reference/text-to-voice/remix)
  - 미리 보기용 생성이 이미 진행 중인 경우 `409` 응답을 추가했습니다. 이 응답을 받은 후 요청을 다시 시도하세요.

### 워크스페이스

- [서비스 계정 API 키 생성](/docs/ko/api-reference/service-accounts/api-keys/create) - `POST /v1/service-accounts/{service_account_user_id}/api-keys`
  - 엔터프라이즈 서비스 계정 API 키를 위한 선택적 nullable `tts_concurrency_limit`, `music_concurrency_limit`, `dubbing_concurrency_limit`(정수)를 추가했습니다.
- [서비스 계정 API 키 업데이트](/docs/ko/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
  - 선택적 `tts_concurrency_limit`, `music_concurrency_limit`, `dubbing_concurrency_limit`를 추가했습니다. 각 필드는 정수, `clear`, `no_update`, `null`을 허용하며 기본값은 `no_update`입니다.

### 모델

- [모델 나열](/docs/ko/api-reference/models/list) - `GET /v1/models`
  - 필수 `max_characters_request_free_user` 및 `max_characters_request_subscribed_user`를 지원 중단했습니다. 이 필드는 적용되지 않으므로 대신 `maximum_text_length_per_request`를 사용하세요.

</Accordion>

## September 23, 2026

### 이미지 & 비디오

- **Sora 2 및 Sora 2 Pro 지원 종료**: OpenAI는 2026년 9월 24일 Sora API를 중단합니다. 두 모델은 이미지 & 비디오 모델 선택기에서 제거되었으며, 해당 날짜에 생성을 중단합니다. 기존 생성물은 기록에서 계속 사용할 수 있습니다. Sora 노드를 사용하는 Flows 및 템플릿은 다시 실행하려면 [Gemini Omni 1.1 Flash](/docs/ko/overview/capabilities/image-video)와 같은 다른 비디오 모델로 전환해야 합니다.
- **Seedance 1.5 Pro 지원 중단**: ByteDance는 2026년 11월 11일 Seedance 1.5 Pro를 종료합니다. 이 모델은 더 이상 새 생성에 제공되지 않으며 해당 날짜에 작동을 중단합니다. 대신 [Seedance 2.0 모델](/docs/ko/overview/capabilities/image-video)을 사용하세요.

## September 21, 2026

### ElevenAgents

- **병렬 도구 호출**: 이제 에이전트 프롬프트 구성에 `enable_parallel_tool_calls`(불리언, 기본값 `true`)가 포함됩니다. 활성화하면 지원되는 모델은 한 턴에서 여러 도구를 실행할 수 있습니다.
- **에이전트 모델**: 에이전트 LLM 옵션에 `gpt-6-astra`를 추가했습니다.
- **알림**: 이제 에이전트 알림에서 PagerDuty 및 webhook 알림과 함께 Slack 채널을 지원합니다.
- **전화번호 검색**: 제공업체, 발신 지원, 할당된 에이전트 및 브랜치, 라벨, 전화번호 필터를 갖춘 커서 페이지네이션 전화번호 엔드포인트를 추가했습니다.

### 이미지 및 비디오

- **GPT Image 2.5 모델**: 이제 [이미지 생성](/docs/ko/api-reference/flows/image/create)에서 `gpt-image-2.5-flare` 및 `gpt-image-2.5-sunburst`를 지원합니다. 두 모델 모두 최대 10개의 참조 이미지, `max`까지의 품질 수준, `auto`를 포함한 14개의 고정 가로세로비, 1K, 2K 또는 4K 출력을 지원합니다.

### Speech Engine

- **캐스케이드 시간 초과**: 이제 Speech Engine 생성 및 업데이트 요청에서 `cascade_timeout_seconds`(숫자, 2–15, 기본값 `4`)를 지원하여 재시도 전 ElevenLabs가 업스트림 음성 엔진을 대기하는 시간을 제어할 수 있습니다.

### 텍스트 음성 변환

- **멀티 컨텍스트 턴 경계**: 이제 `is_final_audio_for_turn` 마커가 MP3 및 Opus 출력을 포함해 해당 턴의 버퍼링된 모든 바이트 뒤에 전송됩니다. 클라이언트는 PCM으로 전환하지 않고도 이 마커를 정확한 턴 경계로 사용할 수 있습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.69.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.69.0) - 실시간 Speech to Text 래퍼에 `transcriptEdit`를 추가했으며, 편집된 텍스트는 `edited_transcript` 이벤트를 통해 전달됩니다. 데이터 레지던시 접미사가 있는 API 키에 대한 Speech Engine JWT 검증을 수정했습니다. 템플릿을 나열하고 가져오며 실행을 나열, 생성, 가져오는 `phoneNumbers.listV2` 및 Flows 템플릿 메서드를 추가했습니다. GPT Image 2.5, Slack 에이전트 알림, 병렬 도구 호출, `gpt-6-astra`, 서비스 계정 API 키 동시성 제한, Music 제로 보존, 대화 필터, MCP 도구 승인 상태를 위한 클라이언트와 타입을 재생성했습니다.

#### Python SDK

- [v2.69.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.69.0) - 실시간 Speech to Text 래퍼에 `transcript_edit`를 추가했으며, 편집된 텍스트는 `edited_transcript` 이벤트를 통해 전달됩니다. 데이터 레지던시 접미사가 있는 API 키에 대한 Speech Engine JWT 검증을 수정하고, `ffplay`가 실패하면 `play`가 오류를 발생시키도록 했습니다. 템플릿을 나열하고 가져오며 실행을 나열, 생성, 가져오는 `phone_numbers.list_v2` 및 Flows 템플릿 메서드를 추가했습니다. GPT Image 2.5, Slack 에이전트 알림, 병렬 도구 호출, `gpt-6-astra`, 서비스 계정 API 키 동시성 제한, Music 제로 보존, 대화 필터, MCP 도구 승인 상태를 위한 클라이언트와 타입을 재생성했습니다.

#### ElevenLabs CLI

- [v1.3.2](https://github.com/elevenlabs/cli/releases/tag/v1.3.2) - CLI 사용에 대한 피드백을 수집할 수 있도록 선택적 `--intent` 메타데이터를 추가했습니다. CLI에서 지원하지 않는 워크플로를 신고할 수 있도록 `elevenlabs feedback missing-capability`를 추가했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- [전화번호 페이지 나열](/docs/ko/api-reference/phone-numbers/list-v-2) - `GET /v1/convai/v2/phone-numbers`
  - 선택적 `page_size`(정수, 1–1,000, 기본값 `100`) 및 `cursor`(nullable 문자열) 페이지네이션 매개변수를 추가했습니다.
  - 선택적 `search`, `label`, `phone_number`, `provider`, `supports_outbound`, `agent_id`, `branch_id`, `sort_by`, `sort_direction` 필터를 추가했습니다. `sort_by`는 `label` 또는 `phone_number`를 지원하며, `sort_direction`의 기본값은 `asc`입니다.
  - 응답에는 필수 `phone_numbers`(배열), 선택적 nullable `next_cursor`(문자열), `has_more`(불리언, 기본값 `false`)가 포함됩니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [에이전트 생성](/docs/ko/api-reference/agents/create), [에이전트 가져오기](/docs/ko/api-reference/agents/get) 및 [에이전트 업데이트](/docs/ko/api-reference/agents/update)
  - 프롬프트 구성에 `enable_parallel_tool_calls`(불리언, 기본값 `true`)를 추가했습니다. 워크플로 재정의는 nullable 불리언을 지원합니다.
  - `LLM` 열거형에 대화 시작 재정의를 포함하여 `gpt-6-astra`를 추가했습니다.
  - 이제 알림 통합 알리미에서 `integration_type`을 사용하여 `pagerduty` 또는 `slack`을 선택합니다. Slack 알리미에는 `connection_id` 및 `channel_id`(문자열)가 필요하며, `channel_id`는 1~64자를 지원합니다.
- [대화 나열](/docs/ko/api-reference/conversations/list) 및 [대화 참조 확인](/docs/ko/api-reference/conversations/resolve)
  - `data_collection_params`에서 더 이상 `missing` 연산자를 지원하지 않습니다. 필드가 수집되지 않은 대화를 일치시키려면 빈 값을 사용하세요.
  - `dynamic_variable_params`의 빈 값은 변수가 설정되지 않은 대화와 일치합니다.
- [Speech Engine 생성](/docs/ko/api-reference/speech-engine/create), [Speech Engine 가져오기](/docs/ko/api-reference/speech-engine/get) 및 [Speech Engine 업데이트](/docs/ko/api-reference/speech-engine/update)
  - `cascade_timeout_seconds`(숫자, 2–15)를 추가했습니다. 생성 요청의 기본값은 `4`이며, 업데이트 요청은 nullable 값을 지원하고 응답에는 해당 필드가 필요합니다.

### 이미지 및 비디오

- [이미지 생성 만들기](/docs/ko/api-reference/flows/image/create) - `POST /v1/flows/image`
  - `gpt-image-2.5-flare` 및 `gpt-image-2.5-sunburst`를 위한 요청 변형을 추가했습니다.
  - 두 변형 모두 `prompt` 및 `model_id`가 필요하고, 최대 10개의 `images`를 지원하며, `resolution`(`1K`, `2K` 또는 `4K`, 기본값 `1K`)을 추가합니다.
  - `quality`는 `low`, `medium`, `high`, `xhigh`, `max`를 지원하며 기본값은 `high`입니다. `aspect_ratio`는 `auto` 및 14개의 고정 비율을 지원하며 기본값은 `16:9`입니다.

### 더빙

- [더빙 프로젝트 생성](/docs/ko/api-reference/dubbing/create-project) - `POST /v1/dubbing/project`
  - multipart `keyterms`는 반복 필드 또는 단일 JSON 배열을 지원합니다.
  - multipart `webhook_ids`는 반복 필드, 단일 JSON 배열 또는 쉼표로 구분된 문자열을 지원합니다.
- [워크스페이스 리소스 가져오기](/docs/ko/api-reference/workspace/resources/get), [워크스페이스 리소스 공유](/docs/ko/api-reference/workspace/resources/share) 및 [워크스페이스 리소스 공유 해제](/docs/ko/api-reference/workspace/resources/unshare)
  - `WorkspaceResourceType`에 `dubbing_project`를 추가했습니다.

### 지식 베이스

- [크롤 작업 생성](/docs/ko/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
  - `max_depth`(정수, 기본값 `3`)를 지원 중단했습니다. 이 필드는 이제 아무 작업도 수행하지 않으며 최소 또는 최대 제약 조건도 აღარ 이상 적용되지 않습니다.
  - 크롤 작업 메타데이터에서 더 이상 `max_depth`가 필요하지 않습니다.

### 사용자

- [사용자 가져오기](/docs/ko/api-reference/user/get) 및 [구독 가져오기](/docs/ko/api-reference/user/subscription/get)
  - 통화 열거형에 `gbp`를 추가했습니다.

## 스키마 변경 사항

### 텍스트 음성 변환

- 이제 멀티 컨텍스트 WebSocket `audio` 및 `final` 메시지에서 `is_final_audio_for_turn`을 해당 턴의 버퍼링된 모든 바이트가 전달된 후 발생하는 것으로 정의합니다.

</Accordion>

## September 14, 2026

### ElevenAgents

- **통화 대기열 및 대기 오디오**: 동시 처리 한도에 도달한 에이전트를 위한 [통화 대기열](/docs/ko/eleven-agents/guides/call-queueing)을 추가했습니다. 대기 중인 발신자는 대기 오디오를 듣고, 입장하거나 시간 초과될 때까지 `queue_status` 이벤트를 수신합니다. 새 API 메서드로 사용자 지정 대기 오디오를 업로드하거나 삭제할 수 있습니다.
- **테스트 버전 메타데이터**: 이제 에이전트 테스트 결과에서 테스트를 실행한 에이전트 버전과 초안 변경 사항 포함 여부를 확인할 수 있습니다. 호출 요약에는 부분 재제출이 서로 다른 버전에서 실행된 경우도 표시됩니다.
- **모델 및 계정 메타데이터**: 이제 에이전트 LLM 구성에서 `gemini-3.8-flash`를 지원합니다. WhatsApp 계정 응답에서 해당 계정이 Cloud API를 사용하는지, 공존 가입 플로를 사용하는지 확인할 수 있습니다.

### 음악

- **Music v2.5 API 지원**: 이제 음악 엔드포인트와 SDK에서 `music_v2_5`를 지원합니다. 작곡 계획 생성 청크는 최대 6,132자를 지원하며, 각 줄 최대 200자의 줄을 최대 30개까지 포함할 수 있습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - 에이전트 대기 오디오를 업로드하고 삭제하는 메서드를 추가했습니다. 통화 대기열, 프로시저 참조, 초안 브랜치 생성, RAG 쿼리 제한, 테스트 버전 메타데이터, `gemini-3.8-flash`, `music_v2_5`를 위한 타입을 재생성했습니다.

#### Python SDK

- [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - 에이전트 대기 오디오를 업로드하고 삭제하는 동기 및 비동기 메서드를 추가했습니다. 통화 대기열, 프로시저, 초안 브랜치 생성, RAG 쿼리 제한, 테스트 버전 메타데이터, `gemini-3.8-flash`, `music_v2_5`를 위한 타입을 재생성했습니다. 이제 `compose_detailed` 래퍼에서 생성된 모든 음악 모델 ID와 프롬프트 기반 및 청크 기반 작곡 계획을 모두 지원합니다.

#### iOS SDK

- [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - 에이전트 메시지를 `event_id` 대신 `response_id`로 조정하여 도구 호출 주변의 여러 응답을 보존하고, 스트리밍된 부분이나 수정 사항이 잘못된 메시지에 연결되지 않도록 했습니다.

#### ElevenLabs CLI

- [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - 생성된 API 명령에 선택적 `--intent` 메타데이터를 추가했습니다. CLI에서 지원하지 않는 워크플로를 신고할 수 있도록 `elevenlabs feedback missing-capability`를 추가했습니다.

#### 패키지

- [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) 및 [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - 도구 및 프로시저 호출 후 중복되는 에이전트 답변을 수정했습니다. 스트리밍된 텍스트 답변은 Markdown 형식을 유지하며, 음성 대화에서는 발화되지 않은 스트리밍 채팅 부분이 더 이상 렌더링되지 않습니다. 임베드 패키지는 `user_activity` 이벤트도 초당 한 번으로 제한하고 세션이 종료되면 이 제한을 해제합니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- [에이전트 대기 오디오 업로드](/docs/ko/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio`
  - 필수 `hold_audio_file`(바이너리)을 multipart 양식 데이터로 받습니다. 파일은 최대 40MB 및 180초 길이의 MP3 또는 WAV여야 합니다.
  - 필수 `agent_id`(문자열) 및 `hold_audio`(`AgentHoldAudioConfig`)를 반환합니다. 대기 오디오 객체에는 `audio_path`, `audio_url`, `original_filename`(문자열), `duration_secs`(숫자), `size_bytes`(정수)가 필요합니다.
- [에이전트 대기 오디오 삭제](/docs/ko/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio`
  - 사용자 지정 클립을 제거하여 대기 중인 발신자가 기본 대기음을 듣도록 합니다.
  - 필수 `agent_id`(문자열)를 반환합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [에이전트 생성](/docs/ko/api-reference/agents/create), [에이전트 가져오기](/docs/ko/api-reference/agents/get) 및 [에이전트 업데이트](/docs/ko/api-reference/agents/update)
  - `enabled`(불리언, 기본값 `false`) 및 `wait_timeout_seconds`(정수, 1–1,800, 기본값 `180`)가 포함된 선택적 `platform_settings.queueing_config`(`AgentQueueingConfig`)를 추가했습니다.
  - 대기열 구성 응답에는 읽기 전용의 nullable `hold_audio`(`AgentHoldAudioConfig`)가 포함됩니다. 에이전트 응답에는 선택적 `default_hold_audio_url`(문자열)도 포함됩니다.
- [대화 가져오기](/docs/ko/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - 메타데이터에 선택적 nullable `queue_wait_secs`(숫자)를 추가했습니다. 대기열 시간은 `call_duration_secs` 및 청구 시간에서 제외됩니다.
- [에이전트 브랜치 생성](/docs/ko/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches`
  - 선택적 `include_draft`(불리언, 기본값 `false`)를 추가했습니다. `true`인 경우 브랜치 팁에서 생성된 브랜치에 호출자의 초안 프로시저 세트가 포함됩니다.
- [프로시저 나열](/docs/ko/api-reference/agents/procedures/list) 및 프로시저 생성, 가져오기, 초안 엔드포인트
  - 목록 항목에 선택적 `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids`, `referenced_dynamic_variables`(문자열 배열)를 추가했습니다.
  - 에이전트 및 병합 미리보기 응답에 프로시저 ID를 키로 하는 맵인 선택적 `procedures`를 추가했습니다.
- [테스트 호출 나열](/docs/ko/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
  - 이름으로 테스트와 폴더를 필터링하는 선택적 nullable `search`(문자열)를 추가했습니다.
- [에이전트에서 테스트 실행](/docs/ko/api-reference/tests/run-tests) 및 [테스트 호출 가져오기](/docs/ko/api-reference/tests/test-invocations/get)
  - 테스트 스위트 호출 및 단위 테스트 실행 응답에 선택적 nullable `version_id`(문자열)와 선택적 `ran_against_draft`(불리언, 기본값 `false`)를 추가했습니다.
  - 호출 요약에도 선택적 `runs_diverged_from_version`(불리언, 기본값 `false`)를 추가했습니다.
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - 요청 본문에 쿼리별 재정의 값으로 선택적 nullable `max_documents_length`(정수, 1–50,000) 및 `max_retrieved_rag_chunks_count`(정수, 1–20)를 추가했습니다.
- [WhatsApp 계정 가져오기](/docs/ko/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}`
  - 선택적 `account_type`(`WhatsAppAccountType`, 기본값 `cloud_api`)을 추가했습니다. 값은 `cloud_api` 및 `coexistence`입니다.
- [예상 LLM 사용량 계산](/docs/ko/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate`
  - `LLMUsageCalculatorLLMResponseModel`에 필수 `price_per_message`(숫자)를 추가했습니다.

### 음악

- `MusicModelID`에 `POST /v1/music/video-to-music`, `POST /v1/music/plan`, [음악 작곡](/docs/ko/api-reference/music/compose), `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload`, `POST /v1/music/finetunes`용 `music_v2_5`를 추가했습니다.
- `GenerationChunk.text`의 `maxLength`를 `POST /v1/music/plan`, `POST /v1/music`, `POST /v1/music/detailed`, `POST /v1/music/detailed/stream`, `POST /v1/music/stream`, `POST /v1/music/upload`에 대해 6,000자에서 6,132자로 늘렸습니다. 섹션 이름은 1~100자를 포함할 수 있고, 청크에는 한 줄당 200자씩 최대 30줄을 포함할 수 있습니다.

## 스키마 변경 사항

### ElevenAgents

- 실시간 서버 이벤트에 `queue_status`를 추가했습니다. 필수 `queue_status_event.status`는 `waiting`, `admitted`, `timed_out`를 지원하며, `timed_out`은 WebSocket 종료 코드 `4300`보다 먼저 발생합니다. 대기 오디오는 계속 일반 `audio` 이벤트로 전달됩니다.
- `LLM` 열거형에 대화 시작 재정의를 포함하여 `gemini-3.8-flash`를 추가했습니다.
- 대화 시스템 도구 결과 유니온에 `start_procedure_success`, `start_procedure_error`, `end_procedure_success`, `end_procedure_error`를 추가했습니다.
- `FeaturesUsageCommonModel`에 선택적 `freeform_procedure` 및 `structured_procedure` 기능 상태를 추가했습니다.

</Accordion>

## September 11, 2026

### Scribe v2 Medical

[Scribe v2 Medical](/docs/ko/overview/models#scribe-v2-medical)이 이제 정식 출시되었습니다. 의료 및 임상 오디오에 특화된 일괄 음성 인식 모델이며, Scribe v2와 동일한 요금이 적용됩니다.

[트랜스크립트 생성](/docs/ko/api-reference/speech-to-text/convert)에서 `model_id`로 `scribe_v2_medical`을 전달하세요. 키워드 프롬프팅, 엔터티 감지, 화자 분리 및 축어록 비사용 모드는 Scribe v2와 동일하게 작동합니다.

<CardGroup cols={2}>
  <Card title="모델" icon="duotone book" href="/docs/ko/overview/models#scribe-v2-medical">
    모델 ID, 기능 및 Scribe v2 Medical을 사용해야 하는 경우를 확인하세요.
  </Card>
  <Card
    title="트랜스크립트 생성"
    icon="duotone code"
    href="/docs/ko/api-reference/speech-to-text/convert"
  >
    `model_id`를 `scribe_v2_medical`로 설정하여 오디오를 트랜스크립션하세요.
  </Card>
</CardGroup>

## September 7, 2026

### ElevenAgents

- **워크스페이스 전체 대화 티켓**: 액세스 가능한 에이전트 전반의 대화 트리아지 티켓을 가져오는 [워크스페이스 티켓 목록](/docs/ko/api-reference/triage-tickets/list-for-workspace)을 추가했습니다. 상태 또는 담당자로 필터링하고 커서 페이지네이션을 사용해 페이지당 최대 100개의 티켓을 가져올 수 있습니다.
- **동적 변수 대화 필터**: 이제 [대화 목록](/docs/ko/api-reference/conversations/list) 및 [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search)에서 반복 가능한 `dynamic_variable_params` 필터를 지원합니다. `eq`, `gt`, `gte`, `lt`, `lte`와 함께 `name:op:value`를 사용하세요. 비교 연산자에는 숫자 값이 필요합니다.
- **Twilio 자동응답기 감지**: 이제 발신 전화 및 일괄 통화 구성에서 선택적 `twilio_machine_detection`을 지원합니다. 사람 또는 기계 여부를 빠르게 판별하려면 `enable`을 선택하고, 음성사서함 안내가 끝날 때까지 기다리려면 `detect_message_end`를 선택하세요. 결과는 새 `answering_machine_detection` 웹훅 이벤트를 통해 제공됩니다.
- **데이터 수집 값 제약 조건**: 이제 데이터 수집 속성에서 허용되는 값을 포함하는 동적 변수의 이름을 지정하기 위해 `allowed_values`를 사용할 수 있습니다. 이전 `allowed_values_dynamic_variable` 필드는 더 이상 사용되지 않습니다.
- **에이전트 메타데이터**: 이제 [에이전트 브랜치 목록](/docs/ko/api-reference/agents/branches/list) 응답에서 초안 생성 시점과 브랜치 팁보다 이전인지 여부를 표시합니다. 에이전트 및 Speech Engine 요약에는 이제 `voice_id`가 필요합니다.
- **지식 베이스 소스 URL**: 이제 에이전트 RAG 쿼리 청크에 URL 문서의 추적 URL을 포함하는 필수 nullable `source_url`이 포함됩니다.
- **에이전트 응답 첨부 파일**: 이제 `agent_response` WebSocket 이벤트에 선택적 `attachments`가 포함됩니다. 각 첨부 파일에는 `url` 및 `name`이 필요하며 `mime_type`을 포함할 수 있습니다.

### 워크스페이스

- **API 키 플랫폼 한도**: 이제 서비스 계정 API 키 응답에 크레딧, 프로페셔널 음성 복제, TTS, 더빙 및 음악 동시성에 대한 엔터프라이즈 `platform_limits`가 포함될 수 있습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.67.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.67.0) - 대화 목록 및 텍스트 검색 요청에 `dynamicVariableParams`를 추가했습니다. Twilio 자동응답기 감지, 데이터 수집 값 제약 조건, API 키 플랫폼 한도, 에이전트 브랜치 초안 메타데이터, 지식 베이스 소스 URL의 유형을 다시 생성했습니다.

#### Python SDK

- [v2.67.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.67.0) - 동기 및 비동기 대화 목록과 텍스트 검색 메서드에 `dynamic_variable_params`를 추가했습니다. Twilio 자동응답기 감지, 데이터 수집 값 제약 조건, API 키 플랫폼 한도, 에이전트 브랜치 초안 메타데이터, 지식 베이스 소스 URL의 유형을 다시 생성했습니다. 실시간 텍스트 음성 변환 클라이언트는 더 이상 내부 omit sentinel을 연결에 전달하지 않습니다.

#### ElevenLabs CLI

- [v1.2.0](https://github.com/elevenlabs/cli/releases/tag/v1.2.0) - `elevenlabs say` 명령과 해당 에이전트 스킬을 추가하고, API 명령 바인딩을 다시 생성했으며, `eleven_v3`를 기본 TTS 모델로 설정했습니다.

#### 패키지

- [@elevenlabs/client@1.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.25.0), [@elevenlabs/react@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.2), [@elevenlabs/react-native@1.2.27](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.27), [@elevenlabs/convai-widget-core@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.1) 및 [@elevenlabs/convai-widget-embed@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.1) - 소비자가 유형을 직접 가져올 수 있도록 `@elevenlabs/client`에서 `MessageAttachment`를 다시 내보냈습니다.
- [@elevenlabs/client@1.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.24.0), [@elevenlabs/types@0.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.23.0), [@elevenlabs/react@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.1), [@elevenlabs/react-native@1.2.26](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.26), [@elevenlabs/convai-widget-core@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.0) 및 [@elevenlabs/convai-widget-embed@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.0) - 에이전트 응답 파일 첨부를 `onMessage`로 전달하고 선택적 `webRtc.singlePeerConnection` 세션 설정을 추가했습니다. 위젯은 인사말 버튼도 현지화하며, 누락되거나 중복된 텍스트 채팅 응답을 수정합니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- [워크스페이스 티켓 목록](/docs/ko/api-reference/triage-tickets/list-for-workspace) - `GET /v1/convai/triage-tickets`
  - 호출자가 액세스할 수 있는 모든 에이전트의 대화 트리아지 티켓을 가장 최근 생성된 순으로 나열합니다.
  - 선택적 `page_size`(정수, 1~100, 기본값 `100`), `status`(`AgentConversationTicketStatus`), `assignee_user_id`(문자열 또는 `unassigned`), `cursor`(문자열) 쿼리 매개변수를 추가했습니다.
  - `GetAgentConversationTicketsPageResponseModel`을 반환합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 목록](/docs/ko/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 선택적 nullable `dynamic_variable_params`(반복 가능한 문자열 배열)를 추가했습니다. 각 값은 `name:op:value` 형식을 사용하며, `op`는 `eq`, `gt`, `gte`, `lt`, `lte`입니다.
- [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 동일한 구문을 사용하는 선택적 nullable `dynamic_variable_params`(반복 가능한 문자열 배열)를 추가했습니다.
- [Twilio 발신 통화](/docs/ko/api-reference/twilio/outbound-call), [SIP 트렁크 발신 통화](/docs/ko/api-reference/sip-trunk/outbound-call), [Exotel 발신 통화](/docs/ko/api-reference/exotel/outbound-call), [일괄 통화 제출](/docs/ko/api-reference/batch-calling/submit)
  - 이제 `telephony_call_config`에서 별도의 입력 및 출력 스키마를 사용합니다.
  - 선택적 nullable `twilio_machine_detection`(`TwilioMachineDetectionConfig`)을 추가했습니다. `mode`는 `enable` 또는 `detect_message_end`를 허용하며 기본값은 `enable`입니다. 이 설정은 Twilio 이외의 제공업체와 수신 통화에서는 무시됩니다.
- [전화번호 가져오기](/docs/ko/api-reference/phone-numbers/create) - `POST /v1/convai/phone-numbers`
  - Twilio API 키 가져오기에서 수신 웹훅 서명을 검증하기 위한 선택적 nullable `account_auth_token`(문자열)을 추가했습니다.

## 스키마 변경 사항

### ElevenAgents

- `WebhookEventType`에 `answering_machine_detection`을 추가했습니다.
- `AgentBranchSummary`에 선택적 nullable `draft_created_at`(정수) 및 선택적 `draft_is_behind_tip`(불리언, 기본값 `false`)을 추가했습니다.
- `AgentKnowledgeBaseRagChunkResponseModel`에 필수 nullable `source_url`(문자열)을 추가했습니다.
- `AgentSummaryResponseModel` 및 `SpeechEngineSummaryResponse`에 필수 `voice_id`(문자열)를 추가했습니다.
- `AnalysisProperty`에 선택적 nullable `name`(문자열) 및 `allowed_values`(`AllowedValues`)를 추가했습니다. `LiteralJsonSchemaProperty`에도 `allowed_values`를 추가했습니다. 두 항목 모두 `allowed_values_dynamic_variable`을 더 이상 사용하지 않습니다.
- `DataCollectionResultCommonModel`에 선택적 nullable `name`(문자열)을 추가했습니다.
- `WorkspaceApiKeyResponseModel`에 선택적 nullable `platform_limits`(`PlatformLimits`)를 추가했습니다.
- MCP 도구 `Icon`에 선택적 nullable `theme`(`light` 또는 `dark`)을 추가했습니다.
- `SMBToolConfig`에 `send_custom_email`, `create_service_quote_request`, `create_product_quote_request` 매개변수 변형을 추가했습니다.
- 이제 웹훅 쿼리 매개변수 스키마와 전화 통화 구성에서 별도의 입력 및 출력 모델을 사용합니다.
- `agent_response` WebSocket 이벤트에 선택적 `attachments`(배열)를 추가했습니다. 각 항목에는 `url` 및 `name`(문자열)이 필요하며 선택적 `mime_type`(문자열)을 허용합니다.

### ElevenCreative

- 이제 `ReferenceVideo.studio_clip`에서 `StudioClipReference` 대신 `StudioClipLocator`를 사용합니다. 필드와 와이어 형식은 변경되지 않았습니다.

</Accordion>

## August 31, 2026

### ElevenAgents

- **전화 키패드 입력**: 이제 에이전트 대화 구성에서 [DTMF 입력](/docs/ko/eleven-agents/customization/multimodal-input#dtmf-input)을 위한 선택적 `dtmf_input_settings`를 지원합니다. 숫자 입력 제한 시간을 설정하고, `#`을 종료 문자로 사용하며, 기록, 로그 및 분석에서 키패드 입력을 숨길 수 있습니다.
- **대화 첨부 파일 기록**: 이제 [대화 가져오기](/docs/ko/api-reference/conversations/get)의 트랜스크립트 항목에 연결된 모든 파일의 ID, 이름, MIME 유형 및 URL이 포함된 배열 `file_inputs`가 포함됩니다.
- **에이전트 태그 필터링**: 이제 [에이전트 목록](/docs/ko/api-reference/agents/list)에서 선택적 `tags` 쿼리 매개변수를 사용할 수 있습니다. 매개변수를 반복하여 제공된 태그 중 하나와 일치하는 에이전트를 찾을 수 있습니다.
- **일괄 캠페인 컨텍스트**: 이제 [대화 가져오기](/docs/ko/api-reference/conversations/get)에서 필수 `campaign_id` 및 `campaign_lead_id`를 포함하는 nullable `campaign` 메타데이터로 일괄 통화를 식별합니다.

### 음악

- **파형 시각화 데이터**: 이제 [상세 음악 생성](/docs/ko/api-reference/music/compose-detailed), [세부 정보와 함께 음악 스트리밍](/docs/ko/api-reference/music/compose-detailed-stream), [음악 업로드](/docs/ko/api-reference/music/upload)에서 선택적 `with_waveform_visual`(불리언, 기본값 `false`)을 지원합니다. 이 옵션을 선택한 응답은 초당 4개 샘플로 구성된 저해상도 `waveform_visual` 정수 배열을 반환합니다.

### 더빙

- **프로젝트 페이지네이션 동작**: 이제 [더빙 프로젝트 목록](/docs/ko/api-reference/dubbing/list-projects) 및 [언어 대상 목록](/docs/ko/api-reference/dubbing/language-targets/list-language-targets)에서 `page_size`를 1~100으로 제한합니다. 프로젝트 상태 필터에 `queued`가 포함되며, 두 엔드포인트 모두 다음 페이지를 가져오기 위해 `next_cursor`를 사용하는 방법을 안내합니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.66.0) - `sendMultimodalMessage`에 `fileIds`를 추가하여 하나의 메시지에 여러 파일 첨부를 포함할 수 있습니다.

#### Python SDK

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.66.0) - `send_multimodal_message`에 `file_ids`를 추가하여 하나의 메시지에 여러 파일 첨부를 포함할 수 있습니다.

#### Android SDK

- [v0.12.2](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.2) - 세션 이벤트를 연결할 때 `onUnhandledClientToolCall` 콜백을 유지했습니다. 응답을 예상하는 처리되지 않은 클라이언트 도구 호출은 더 이상 미해결 상태로 남지 않고 자동 오류 응답을 받습니다.

#### ElevenLabs CLI

- [v1.1.0](https://github.com/elevenlabs/cli/releases/tag/v1.1.0) - API 명령 바인딩을 다시 생성하고 ElevenAgents 워크플로에 명령 범위 요청 어트리뷰션을 추가했습니다. 이 명령은 CLI `User-Agent`에 `cmd/<command>`를 추가하여 `agents push` 및 `agents create`와 같은 워크플로의 요청을 구분할 수 있게 합니다.

#### 패키지

- [@elevenlabs/client@1.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.23.0), [@elevenlabs/react@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.0), [@elevenlabs/types@0.22.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.1), [@elevenlabs/react-native@1.2.25](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.25), [@elevenlabs/convai-widget-core@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.1) 및 [@elevenlabs/convai-widget-embed@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.1) - `sendMultimodalMessage`에 `fileIds`를 추가했습니다. 호환성을 위해 클라이언트가 `file` 및 `files` 필드를 모두 전송하며, React에서 업데이트된 클라이언트 API를 제공합니다.

### API

<Accordion title="API 변경 사항 보기">

## 업데이트된 엔드포인트

### ElevenAgents

- [에이전트 목록](/docs/ko/api-reference/agents/list) - `GET /v1/convai/agents`
  - 선택적 nullable `tags`(문자열 배열)를 추가했습니다. 쿼리 매개변수를 반복하여 제공된 태그 중 하나와 일치시킬 수 있습니다.
- [에이전트 생성](/docs/ko/api-reference/agents/create), [에이전트 가져오기](/docs/ko/api-reference/agents/get), [에이전트 업데이트](/docs/ko/api-reference/agents/update)
  - 선택적 nullable `conversation_config.conversation.dtmf_input_settings`(`DTMFInputConfig`)를 추가했습니다. `dtmf_input_timeout`(숫자, 0.5~10초, 기본값 `2`), `hash_terminator`(불리언, 기본값 `true`), `redact_input`(불리언, 기본값 `false`)을 지원합니다.
  - 전화번호 전송 구성에 선택적 `sip_refer_play_dialtone`(불리언, 기본값 `true`)을 추가했습니다. SIP REFER 전송이 완료되는 동안 원래 통화 레그를 무음으로 유지하려면 `false`로 설정하세요.
  - 시작 및 종료 절차 시스템 도구는 이제 `ProcedureVersionRef` 또는 `ProcedureDraftRef`를 받을 수 있습니다. 초안 참조에는 `procedure_id`(문자열)가 필요하며 `version_id`는 `null`로 설정됩니다.
- [대화 가져오기](/docs/ko/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - 트랜스크립트 항목에 `file_inputs`(`ConversationHistoryTranscriptFileInputResponseModel` 배열)를 추가했습니다. 각 항목에는 `file_id`, `original_filename`, `mime_type`, `file_url`(문자열)이 필요합니다.
  - 일괄 통화 메타데이터에 선택적 nullable `campaign`(`BatchCallingCampaignInformation`)을 추가했습니다. 객체에는 `campaign_id` 및 `campaign_lead_id`(문자열)가 필요합니다.
  - `ChatSourceMedium`에 `dtmf`를 추가했습니다.
- 대화 트리아지 티켓 이슈 유형에 `incorrect_information`, `documentation_gap`, `platform_bug`, `wrong_action`을 추가했습니다.

### 음악

- [상세 음악 생성](/docs/ko/api-reference/music/compose-detailed)(`POST /v1/music/detailed`) 및 [세부 정보와 함께 음악 스트리밍](/docs/ko/api-reference/music/compose-detailed-stream)(`POST /v1/music/detailed/stream`)
  - 선택적 `with_waveform_visual`(불리언, 기본값 `false`)을 추가했습니다.
  - 상세 응답에 nullable `waveform_visual`(정수 배열)을 추가했습니다. `-1000`에서 `1000` 범위로 초당 4회 샘플링됩니다.
- [음악 업로드](/docs/ko/api-reference/music/upload) - `POST /v1/music/upload`
  - 응답에 선택적 `with_waveform_visual`(불리언, 기본값 `false`) 및 nullable `waveform_visual`(정수 배열)을 추가했습니다.

### ElevenCreative

- [Studio 프로젝트 생성](/docs/ko/api-reference/studio/add-project) 및 [팟캐스트 생성](/docs/ko/api-reference/studio/create-podcast)
  - 이제 `quality_preset`에서 `null`을 허용하며, `standard` 스키마 기본값을 제거했습니다.

### 더빙

- [더빙 프로젝트 목록](/docs/ko/api-reference/dubbing/list-projects) - `GET /v1/dubbing/project`
  - `page_size`는 기본값 `20`의 선택적 정수로 유지되지만, 이제 값이 거부되는 대신 1~100으로 제한됩니다.
  - 이제 `status` 필터에서 `queued`, `preparing`, `ready`, `failed`를 안내합니다.
  - 이전 응답의 `next_cursor`를 `cursor`에 전달하세요. 첫 페이지에서는 생략하세요.
- [언어 대상 목록](/docs/ko/api-reference/dubbing/language-targets/list-language-targets) - `GET /v1/dubbing/project/{project_id}/language`
  - `page_size`는 기본값 `20`의 선택적 정수로 유지되지만, 이제 값이 거부되는 대신 1~100으로 제한됩니다.
  - `status` 필터는 `queued`, `processing`, `completed`, `stale`, `failed`를 지원합니다.
  - 이전 응답의 `next_cursor`를 `cursor`에 전달하세요. 첫 페이지에서는 생략하세요.

## 스키마 변경 사항

### 워크스페이스

- `PendingSubscriptionSwitchResponseModel.next_tier`에 `grant`를 추가했습니다.

</Accordion>

## August 24, 2026

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### ElevenLabs CLI

[ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0)을 이제 사용할 수 있습니다. 모든 ElevenLabs API 작업을 하위 명령으로 제공하며, JSON, 표, YAML, CSV 출력, 자동 페이지네이션 및 셸 자동 완성을 지원합니다.

CLI는 ElevenAgents를 위한 로컬 구성 워크플로도 제공합니다. 에이전트, 도구, 테스트 구성을 파일로 저장하고 push 및 pull 명령으로 동기화하며, 브랜치를 관리하고, 테스트를 실행하고, ElevenLabs UI 구성 요소를 설치하고, 데이터 레지던시 리전을 선택할 수 있습니다.

<YoutubeEmbed id="MuORAEVtJIQ" />

<CardGroup cols={1}>
  <Card
    title="CLI 문서"
    icon="duotone book"
    href="/docs/ko/eleven-agents/operate/cli"
  >
    CLI를 설치하고, 인증하고, 에이전트를 코드로 관리하세요.
  </Card>
</CardGroup>

### 절차

이제 ElevenAgents에서 절차를 정식으로 사용할 수 있습니다. 절차에는 작업별 지침과 적용 시점을 결정하는 트리거가 포함됩니다. 대화 중 에이전트는 관련 절차를 로드하므로, 모든 지침을 시스템 프롬프트에 넣지 않고도 하나의 에이전트가 서로 다른 작업을 처리할 수 있습니다.

에이전트가 지침의 표현이나 순서를 조정할 수 있는 경우 자유 형식 절차를 사용하세요. 단계가 정해진 순서로 실행되어야 하는 경우 구조화된 절차를 사용하세요. 두 유형 모두 동일한 에이전트에서 워크플로와 함께 사용할 수 있습니다.

<CardGroup cols={3}>
  <Card
    title="절차 개요"
    icon="duotone book"
    href="/docs/ko/eleven-agents/customization/procedures"
  >
    절차를 사용해야 하는 시점과 프롬프트 및 워크플로와의 차이점을 알아보세요.
  </Card>
  <Card
    title="자유 형식 절차"
    icon="duotone code"
    href="/docs/ko/eleven-agents/customization/procedures/free-form-procedures"
  >
    에이전트가 대화에 맞게 조정할 수 있는 자연어 지침을 작성하세요.
  </Card>
  <Card
    title="구조화된 절차"
    icon="duotone list-check"
    href="/docs/ko/eleven-agents/customization/procedures/structured-procedures"
  >
    에이전트가 일관된 순서로 따르는 타입 지정 단계를 정의하세요.
  </Card>
</CardGroup>

### ElevenAgents

- **대화 분류 티켓**: 에이전트 성능 관련 티켓 생성, 수동 후속 조치 티켓 생성, 티켓 나열, 워크스페이스 멤버 할당, 상태 및 담당자 업데이트, 티켓 수준 또는 턴 수준 댓글 추가를 위한 API를 추가했습니다.
- **대화 관측성**: 실시간 클라이언트는 완료된 각 에이전트 턴 후 `context_usage` 이벤트를 받을 수 있습니다. 이 이벤트는 모델, 프롬프트 토큰 수 및 모델 컨텍스트 한도를 보고합니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - 대화 분류 티켓 및 경량 대화 요약을 위한 클라이언트와 타입을 추가했습니다. 대화 API에는 절차, 잘못된 도구 호출 및 정렬 필터가 추가되었고, 절차 API에는 에이전트 버전 선택이 추가되었으며, 주제 API에는 평가 세부 정보 제어 및 불만 정렬이 추가되었습니다. 또한 지식 베이스 새로 고침 빈도, 테스트 환경 및 알림 통합 필드와 실시간 더빙 메시지 타입을 추가했습니다.

#### Python SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - 대화 분류 티켓 및 경량 대화 요약을 위한 클라이언트와 타입을 추가했습니다. 대화 API에는 절차, 잘못된 도구 호출 및 정렬 필터가 추가되었고, 절차 API에는 에이전트 버전 선택이 추가되었으며, 주제 API에는 평가 세부 정보 제어 및 불만 정렬이 추가되었습니다. 또한 지식 베이스 새로 고침 빈도, 테스트 환경 및 알림 통합 필드를 추가하고, 음성-텍스트 변환 `keyterms` 및 더빙 `webhook_ids`의 반복된 multipart 필드를 유지합니다.

#### Swift SDK

- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - 타입 지정 클라이언트 오류 파싱, `expects_response` 처리 및 타입 안전 도구 결과를 추가했습니다. 이제 WebRTC 시작은 오디오 트랙 구독을 기다리는 대신 에이전트가 참여하면 준비 상태가 됩니다. 이 릴리스는 URL 처리를 강화하고, 알 수 없는 이벤트 노이즈를 억제하며, 소프트웨어 음소거 처리에서 실시간 스레드 할당을 제거합니다.

#### 패키지

- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) 및 [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - 이제 WebRTC 출력 캡처는 엄격한 콘텐츠 보안 정책에서 자체 호스팅 AudioWorklet 경로를 사용합니다. Worklet 캐싱에는 요청된 소스가 포함되어, 이전 인라인 URL이 자체 호스팅 경로를 대체하지 못하도록 합니다. 이제 React Native 설정 오류는 `@elevenlabs/react-native`를 가리킵니다.
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) 및 [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - 선택 사항인 `webRtc.iceTransportPolicy`를 추가했습니다. 직접 UDP 트래픽을 차단하는 네트워크에서 WebRTC ICE 후보를 TURN 릴레이로 제한하려면 이를 `relay`로 설정하세요.
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) 및 [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - `onContextUsage` 콜백과 `ContextUsageEvent` 타입을 추가했습니다. React는 `useConversation`을 통해 콜백을 노출합니다. 이제 React Native는 브라우저 전역 감지 대신 패키지 export 조건을 통해 확인됩니다.
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) 및 [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - 속성이 지정된 버튼 응답이 포함된 첫 메시지 리치 콘텐츠, `onExternalAgentDisconnected`, `onMCPToolApprovalRequest`를 추가했습니다. 이제 WebRTC는 선택한 입력 장치를 사용하고, 마이크 전환 시 음소거 상태를 유지하며, 시작 데이터를 전송할 수 없으면 설정에 실패합니다. 위젯에는 동시성 대기열 상태, 접힌 트리거에서의 선택적 언어 선택, 텍스트와 음성을 모두 지원하는 에이전트를 위한 첫 메시지 렌더링이 추가되었습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- 대화 분류 티켓 엔드포인트 9개를 추가했습니다.
  - [대화 티켓 생성](/docs/ko/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`. 요청에는 `conversation_id`(문자열)가 필요하며, `qa_comment`(nullable 문자열, 1~10,000자) 및 최대 200개의 턴 댓글을 허용합니다.
  - [티켓 나열](/docs/ko/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`, 커서 페이지네이션을 지원합니다.
  - [수동 티켓 생성](/docs/ko/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`. 요청에는 `qa_comment`(문자열, 1~10,000자)가 필요합니다.
  - [할당 가능한 사용자 나열](/docs/ko/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`. 응답은 서비스 계정이 아닌 워크스페이스 멤버와 각 멤버의 에이전트 액세스 여부를 나열합니다.
  - [티켓 가져오기](/docs/ko/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [티켓 업데이트](/docs/ko/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`. 요청은 선택 사항인 `status`와 nullable `assignee_user_id`를 허용합니다.
  - [티켓 삭제](/docs/ko/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`.
  - [댓글 추가](/docs/ko/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`. 요청에는 `comment`(문자열, 1~10,000자)가 필요합니다.
  - [턴 댓글 추가](/docs/ko/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`. 요청에는 0부터 시작하는 `turn_index`(정수)와 `comment`(문자열, 1~10,000자)가 필요합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [서명된 URL 가져오기](/docs/ko/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
  - 선택 사항인 `debug_events_request`(불리언, 기본값 `false`)를 추가했습니다. 디버그 이벤트에는 에이전트 편집자 액세스가 필요합니다.
- [WebRTC 토큰 가져오기](/docs/ko/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - 선택 사항인 `debug_events_request`(불리언, 기본값 `false`)를 추가했습니다. 레거시 `GET /v1/convai/conversation/get_signed_url` 경로도 동일한 파라미터를 허용합니다.
- [대화 나열](/docs/ko/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 지정된 절차 중 하나가 실행된 대화를 일치시키기 위한 선택 사항인 `triggered_procedure_ids`(nullable 문자열 배열, 최대 50개)를 추가했습니다.
  - 실행되지 않은 도구 호출을 포함하기 위한 선택 사항인 `include_invalid_tool_calls`(불리언, 기본값 `false`)를 추가했습니다.
  - 통화 시작 시간에 대한 선택 사항인 `sort_direction`(`asc` 또는 `desc`, 기본값 `desc`)을 추가했습니다.
- [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 선택 사항인 `triggered_procedure_ids`(nullable 문자열 배열, 최대 50개)를 추가했습니다.
  - 선택 사항인 `include_invalid_tool_calls`(불리언, 기본값 `false`)를 추가했습니다.
- [에이전트 대화 주제 가져오기](/docs/ko/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - 선택 사항인 `include_evaluation_criteria`(불리언, 기본값 `true`)를 추가했습니다.
  - `sort_by`에 `frustration`을 추가했습니다.
  - 주제 응답에 nullable `success_rate`(숫자)를 추가하고, 전체 응답에는 `aggregated_run_count`(정수, 기본값 `0`)를 추가했습니다.
  - `from_unix_secs`는 UTC 날짜 시작 시점으로 내림 처리됩니다. 범위가 지정되면 완료된 일별 탐색 실행을 집계하며, 두 경계를 모두 생략하면 최신 실행을 반환합니다.
- [절차 나열](/docs/ko/api-reference/agents/procedures/list) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`) 및 [절차 가져오기](/docs/ko/api-reference/agents/procedures/get) (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`)
  - 특정 에이전트 버전에서 절차를 가져오기 위한 선택 사항 nullable `agent_version_id`(문자열)를 추가했습니다.
- [테스트 생성](/docs/ko/api-reference/tests/create) 및 [테스트 업데이트](/docs/ko/api-reference/tests/update)
  - 응답, 시뮬레이션 및 도구 호출 단위 테스트 스키마에 선택 사항 nullable `environment`(문자열)를 추가했습니다. 이 값은 환경별 URL, 헤더 및 인증 연결을 선택하며, 기본값은 `production`입니다.
- [URL 문서 생성](/docs/ko/api-reference/knowledge-base/create-from-url), [크롤 작업 생성](/docs/ko/api-reference/knowledge-base/create-crawl-job) 및 [폴더 생성](/docs/ko/api-reference/knowledge-base/create-folder)
  - 자동 동기화를 위한 선택 사항 nullable `minimum_frequency_days`(정수, 1~180)를 추가했습니다. 기본값은 `7`이며, 더 엄격한 상위 폴더 빈도가 우선합니다.

### 음악

- [음악 Finetune 나열](/docs/ko/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - 최대 `page_size`를 100에서 150으로 늘렸습니다. 기본값은 50으로 유지됩니다.

## 스키마 변경 사항

### ElevenAgents

- 에이전트 업데이트 요청에 선택 사항 nullable `procedures`(`object<string, ProcedureVersionRef>`)를 추가했습니다. 각 값에는 `procedure_id`와 `version_id`(문자열)가 필요합니다. 빈 객체는 모든 절차를 제거합니다.
- 대화 시작 구성에 `enable_procedure_ids_from_client`(불리언, 기본값 `false`)를 추가했습니다. 시작 데이터에 선택 사항 nullable `procedure_ids`(문자열 배열)를 추가했으며, 빈 배열은 시작 에이전트의 모든 절차를 비활성화합니다.
- `ClientEvent`에 `context_usage`를 추가했습니다.
- 소프트 타임아웃 재정의에 선택 사항 nullable `additional_soft_timeout_messages`(문자열 배열)를 추가했습니다.
- 분석 및 스키마 재정의 모델의 상수 값이 이제 `null`을 허용합니다.
- `mic_muting_enabled` 및 `transcript_enabled`의 위젯 구성 기본값이 `false`에서 `true`로 변경되었습니다. 이전 동작을 유지하려면 명시적으로 `false`로 설정하세요.

### 워크스페이스

- [사용자 가져오기](/docs/ko/api-reference/user/get) 응답에서 `UserResponseModel`의 `xi_api_key`를 제거했습니다.
- 이제 `ResourceMetadataResponseModel.role_to_group_ids`는 키를 `admin`, `editor`, `commenter`, `viewer`로 제한하지 않고 사용자 지정 역할 ID를 키로 허용합니다.
- 직접 게시 응답에 선택 사항 nullable `restricted_to_user_email_domains`(문자열 배열)를 추가했습니다.
- 보류 중인 구독 전환 응답의 `next_tier`에 `go`를 추가했습니다.

</Accordion>

## August 22, 2026

### MCP 서버

- **로컬 MCP 서버 지원 중단**: 로컬 [ElevenLabs MCP 서버](https://github.com/elevenlabs/elevenlabs-mcp)와 [MCP 플레이어](https://github.com/elevenlabs/elevenlabs-mcp-player)는 [호스팅형 MCP 서버](/docs/ko/eleven-agents/operate/hosted-mcp)를 위해 지원이 중단되었습니다. 두 리포지토리는 보관 처리되었으며 더 이상 업데이트를 받지 않습니다. 호스팅형 서버는 `https://api.elevenlabs.io/v1/mcp`에서 이용할 수 있으며, OAuth를 통해 ElevenLabs 계정으로 로그인하고 로컬 설치나 API 키가 필요하지 않습니다. Claude, Cursor 및 기타 MCP 클라이언트의 설정 방법은 [호스팅형 MCP 서버 문서](/docs/ko/eleven-agents/operate/hosted-mcp)를 참조하세요.

## August 17, 2026

### ElevenCreative

- **이미지, 비디오 및 음성 생성 API**: 새로운 비동기 Flows API로 비디오, 이미지, 음성 생성을 만들고, 목록을 조회하고, 가져올 수 있습니다. 생성 응답은 `pending`, `generating`, `completed`, `failed` 상태를 제공하며, 요청에 완료 이벤트용 웹훅 대상을 포함할 수 있습니다.
- **재사용 가능한 미디어 에셋**: 새로운 에셋 API로 워크스페이스 미디어를 업로드, 목록 조회, 가져오기, 삭제할 수 있습니다. 이미지, 비디오, 오디오 참조에는 업로드된 에셋, 이전 생성 또는 인라인 base64 데이터를 사용할 수 있어 생성 작업을 연결할 수 있습니다. [참조 및 에셋](/docs/ko/eleven-api/guides/how-to/image-and-video/references)을 참조하세요.

### ElevenAgents

- **경량 대화 요약**: [대화 요약 가져오기](/docs/ko/api-reference/conversations/get-summary)는 전체 트랜스크립트를 불러오지 않고 생성된 제목, 트랜스크립트 요약, 통화 결과, 일반 사용자 또는 에이전트 메시지를 반환합니다. 선택적 `max_messages` 쿼리 파라미터는 1~200 사이의 정수이며 기본값은 `40`입니다. 더 긴 대화에서는 `messages_omitted`가 `true`로 설정됩니다. 컨텍스트를 유지해야 하는 에이전트에 유용합니다.
- **대화 주제 페이지네이션 및 정렬**: [에이전트 대화 주제 가져오기](/docs/ko/api-reference/conversations/topics/get)에 선택적 커서 페이지네이션과 정렬이 추가되었습니다. `page_size`(정수, 1~100), `cursor`(문자열), `sort_by`(`conversations`, `sentiment` 또는 `success_rate`), `sort_direction`(`asc` 또는 `desc`)를 사용하세요. 응답에 `has_more`와 null 허용 `next_cursor`가 추가됩니다.
- **동시성 대기열**: 에이전트 플랫폼 설정에 선택적 `queueing`(`AgentQueueingConfig`)이 추가됩니다. 에이전트가 동시성 한도에 도달했을 때 발신자를 대기시키려면 `enabled`를 `true`로 설정하세요. `wait_timeout_seconds`는 최대 1,800의 정수이며 기본값은 `180`입니다.
- **턴 및 워크플로 제어**: 턴 구성에 사용자 지정 인터럽션 용어와 선별된 기본값을 결합하는 `merge_with_default_ignore_terms`(불리언, 기본값 `false`)가 추가됩니다. 소프트 타임아웃에 `disable_until_first_user_message`(불리언, 기본값 `false`)가 추가되고, 워크플로 도구 로케이터에 노드별 파라미터 오버라이드를 위한 선택적 `schema_overrides`가 추가됩니다.
- **배경 오디오 기본값**: `BackgroundSoundConfig.volume`의 기본값이 `0.6`에서 `0.15`로 변경되었으며, `crossfade_loop`의 기본값이 `false`에서 `true`로 변경되었습니다. 이전 동작을 유지하려면 이 필드를 명시적으로 설정하세요.

### SDK 릴리스

#### JavaScript SDK

- [v2.64.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.64.0) - 에셋 업로드, 목록 조회, 가져오기, 삭제를 위한 `client.assets`와 비동기 비디오, 이미지, 음성 생성을 위한 `client.flows`를 추가했습니다. 턴 구성에 `mergeWithDefaultIgnoreTerms`가 추가되었습니다. `WorkspaceGroupResponseModel`에서 `CustomToolApiSchemaConfig` 및 `scimExternalId`를 제거했습니다.

#### Python SDK

- [v2.64.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.64.0) - 비동기 비디오, 이미지, 음성 생성을 위한 에셋 및 Flows 클라이언트와 턴 구성의 `merge_with_default_ignore_terms`를 추가했습니다. 온프레미스 세션 설정에 추가 설정 메시지 필드를 전달하기 위한 `extra_setup_config`가 추가되었습니다.

#### 패키지

- [@elevenlabs/client@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.18.0), [@elevenlabs/react@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.1), [@elevenlabs/types@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.20.0), [@elevenlabs/react-native@1.2.19](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.19), [@elevenlabs/convai-widget-core@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.0) 및 [@elevenlabs/convai-widget-embed@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.0) - 실험적인 자체 호스팅 오케스트레이터 세션과 리치 콘텐츠 이벤트를 추가했습니다. 이제 엄격한 콘텐츠 보안 정책을 위해 Scribe 오디오 워크릿을 자체 호스팅할 수 있습니다. 연결 해제 처리가 이제 일관되게 `disconnected` 상태에 도달하며, 늦게 도착한 콜백이 새 세션을 지우지 않도록 방지합니다. 위젯은 빠른 답변과 링크를 인라인으로 렌더링하고, 음성 트랜스크립트의 Markdown을 복원하며, 컨테이너 쿼리 레이아웃 내 언어 메뉴 위치 문제를 수정합니다.
- [@elevenlabs/client@1.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.0), [@elevenlabs/react@1.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.2), [@elevenlabs/types@0.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.0), [@elevenlabs/react-native@1.2.20](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.20) 및 [@elevenlabs/convai-widget-core@0.16.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.1) - 보조 언어, 엔터티 감지, 배경 오디오 필터링을 위한 실시간 음성 인식 옵션을 추가했습니다. 최종 트랜스크립트, 감지된 엔터티, 잘못된 요청 이벤트를 추가하고, 타임스탬프 단어 유형을 라이브 스키마에 맞췄으며, `useScribe` 재연결을 막는 마이크 권한 실패 문제를 수정했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenCreative

- [비디오 생성 만들기](/docs/ko/api-reference/flows/video/create) - `POST /v1/flows/video`
- [비디오 생성 목록](/docs/ko/api-reference/flows/video/list) - `GET /v1/flows/video`
- [비디오 생성 가져오기](/docs/ko/api-reference/flows/video/get) - `GET /v1/flows/video/{generation_id}`
- [이미지 생성 만들기](/docs/ko/api-reference/flows/image/create) - `POST /v1/flows/image`
- [이미지 생성 목록](/docs/ko/api-reference/flows/image/list) - `GET /v1/flows/image`
- [이미지 생성 가져오기](/docs/ko/api-reference/flows/image/get) - `GET /v1/flows/image/{generation_id}`
- [음성 생성 만들기](/docs/ko/api-reference/flows/text-to-speech/create) - `POST /v1/flows/text-to-speech`
- [음성 생성 목록](/docs/ko/api-reference/flows/text-to-speech/list) - `GET /v1/flows/text-to-speech`
- [음성 생성 가져오기](/docs/ko/api-reference/flows/text-to-speech/get) - `GET /v1/flows/text-to-speech/{generation_id}`
- [에셋 업로드](/docs/ko/api-reference/assets/create) - `POST /v1/assets`
- [에셋 목록](/docs/ko/api-reference/assets/list) - `GET /v1/assets`
- [에셋 가져오기](/docs/ko/api-reference/assets/get) - `GET /v1/assets/{asset_id}`
- [에셋 삭제](/docs/ko/api-reference/assets/delete) - `DELETE /v1/assets/{asset_id}`

### ElevenAgents

- [대화 요약 가져오기](/docs/ko/api-reference/conversations/get-summary) - `GET /v1/convai/conversations/{conversation_id}/summary`
  - 선택적 `max_messages`(정수, 1~200, 기본값 `40`) 허용
  - 필수 `conversation_id`, `agent_id`, `status`, `message_count`, `note`가 포함된 `GetConversationSummaryResponseModel` 반환
  - 일반 `messages`에는 `role`(`user` 또는 `agent`)과 `message`만 포함되며, 한도를 초과하는 대화는 `messages_omitted: true`를 반환

## 업데이트된 엔드포인트

### ElevenAgents

- [라이브 수 가져오기](/docs/ko/api-reference/analytics/get) - `GET /v1/convai/analytics/live-count`
  - `agent_id`보다 우선하는 선택적 `agent_ids`(문자열 배열, 최대 25) 추가
- [에이전트 대화 주제 가져오기](/docs/ko/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - 선택적 `page_size`(정수, 1~100), `cursor`(문자열), `sort_by`(`conversations`, `sentiment` 또는 `success_rate`), `sort_direction`(`asc` 또는 `desc`) 추가
  - 응답에 `has_more`(불리언, 기본값 `false`) 및 null 허용 `next_cursor`(문자열) 추가

## 스키마 변경 사항

### ElevenAgents

- 에이전트 플랫폼 설정에 선택적 `queueing`(`AgentQueueingConfig`) 추가. 여기에는 `enabled`(불리언, 기본값 `false`) 및 `wait_timeout_seconds`(0보다 크고 최대 1,800인 정수, 기본값 `180`)가 포함됩니다.
- `WorkflowToolLocator`에 선택적 `schema_overrides` 추가. 노드별 상수, 동적 변수, LLM 또는 생략 오버라이드가 도구 수준 오버라이드보다 우선합니다.
- 턴 구성 및 관련 오버라이드 스키마에 `merge_with_default_ignore_terms`(불리언, 기본값 `false`) 추가
- 소프트 타임아웃 구성 및 관련 오버라이드 스키마에 `disable_until_first_user_message`(불리언, 기본값 `false`) 추가
- 실시간 에이전트 도구 응답 이벤트에 필수 읽기 전용 `status`(`success`, `error`, `blocked` 또는 `skipped`) 추가
- 대화 시작 소스에 `avaya` 추가, 인증 방법에 `avaya_api_key` 추가
- 지원되는 에이전트 LLM 값에 `gemini-3.6-flash` 및 `gemini-3.7-flash` 추가
- `BackgroundSoundConfig.volume` 기본값을 `0.6`에서 `0.15`로, `crossfade_loop` 기본값을 `false`에서 `true`로 변경
- `CustomToolApiSchemaConfig` 제거. 이 유형을 import하는 생성된 SDK 사용자는 import를 제거해야 합니다.
- `WorkspaceGroupResponseModel`에서 `scim_external_id` 제거

</Accordion>

## August 10, 2026

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### 더빙 v2 API

이제 API를 통해 더빙 v2를 사용할 수 있습니다. 각 화자의 목소리, 톤, 속도를 유지하면서 오디오와 비디오를 90개 이상의 언어로 번역합니다.

새로운 프로젝트 기반 API는 원본 트랜스크립트와 번역을 편집 가능한 JSON으로 유지합니다. 파일 또는 URL에서 프로젝트를 만들고 하나 이상의 대상 언어를 추가한 다음, 개별 트랜스크립트 세그먼트 또는 번역을 편집하고 변경된 구간만 다시 생성할 수 있습니다. [더빙 빠른 시작](/docs/ko/eleven-api/guides/cookbooks/dubbing)을 따라 첫 더빙을 만들어 보세요.

<YoutubeEmbed id="GSk5JyiT4sU" />

<CardGroup cols={3}>
  <Card
    title="빠른 시작"
    icon="duotone code"
    href="/docs/ko/eleven-api/guides/cookbooks/dubbing"
  >
    첫 더빙 v2 프로젝트를 만들고 번역된 오디오 트랙을 생성하세요.
  </Card>
  <Card
    title="수정 및 재생성"
    icon="/docs/_fern-files/elevenlabs.docs.buildwithfern.com/77d8c519257eb198dd8c1be0c00e24edfbbf36bf99d5edcc5dcf5598c8e9ae36/assets/icons/dubbing.svg"
    href="/docs/ko/eleven-api/guides/how-to/dubbing/refine-and-regenerate"
  >
    원본 트랜스크립트와 번역을 수정한 후 변경된 구간을 다시 생성하세요.
  </Card>
  <Card
    title="API 레퍼런스"
    icon="duotone book"
    href="/docs/ko/api-reference/dubbing/create-project"
  >
    더빙 프로젝트, 언어 및 트랜스크립트 엔드포인트를 살펴보세요.
  </Card>
</CardGroup>

### ElevenAgents

- **대화 가드레일 필터**: [대화 목록](/docs/ko/api-reference/conversations/list)에 선택적 `guardrail_types` (`GuardrailType[]`) 및 `custom_guardrail_names`(문자열 배열) 쿼리 파라미터가 추가되었습니다. 기존 대화 계층 구조는 이제 선택적 `parent_conversation_id`(문자열)로 필터링할 수 있습니다.
- **브랜치 차이 상태**: [에이전트 브랜치 목록](/docs/ko/api-reference/agents/branches/list)에 선택적 `include_commit_status`(불리언, 기본값 `false`)가 추가되었습니다. 활성화하면 브랜치 요약에 null 허용 `commits_ahead`, `commits_behind`, `merged_into_branch_id` 필드가 포함됩니다.
- **대화 및 도구 제어**: 이제 클라이언트 오버라이드에서 `max_duration_seconds`와 `pronunciation_dictionary_locators`를 지원합니다. MCP 서버 구성에는 도구 호출에 MCP `_meta` 값을 전달하기 위한 `request_meta`가 추가되었으며, 웹훅 도구 타임아웃은 이제 최대 300초까지 지원합니다.
- **통화 후 분석 사용량**: 대화 과금에 기능별 누적 합계와 실행 스냅샷을 포함하는 `analysis` 분석 항목이 추가되었습니다. 트랜스크립트 메시지에 `triggered_guardrails`가 추가되었고, 대화 턴에는 선택적 `producing_llm`이 추가되었습니다.

### 음성

- **음성 검색 필터**: [모든 음성 v2 가져오기](/docs/ko/api-reference/voices/search)에 선택적 `gender`, `age`, `language`, `accent`, `use_cases`, `min_notice_period_days`, `include_custom_rates`, `include_live_moderated`, `high_quality` 쿼리 파라미터가 추가되었습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.63.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.63.0) - 보조 언어, 언어 및 엔터티 감지, 배경 오디오 필터링, 로깅, 일회용 토큰 인증을 위한 실시간 음성 인식 옵션을 추가했습니다. 최종 트랜스크립트, 엔터티, 잘못된 요청 이벤트를 추가했으며, 미수락 약관 디스패치, 중복 `audio_format` 파라미터, 포함형 VAD 범위 문제를 수정했습니다.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.62.0) - 더빙 대량 트랜스크립트 업데이트 메서드와 `DubbingRegenerateResponse`를 추가했습니다. 대화 가드레일 필터, 에이전트 브랜치 커밋 상태, 에이전트 알림, MCP `requestMeta` 지원을 추가했습니다. 이제 언어 대상 생성에서 `modelId`를 허용하지 않습니다.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.61.0) - 대화 계층 구조 필터링, 통화 후 분석 과금, 트리거된 가드레일 메타데이터, 브랜치 병합 충돌 세부정보, DTMF 입력 마스킹, 더빙 트랜스크립트 업로드를 추가했습니다. 내보낸 OpenAI 실시간 세션 유형과 `run_subagent_*` 도구 결과 변형을 제거했습니다.

#### Python SDK

- [v2.63.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.63.0) - 보조 언어, 언어 및 엔터티 감지, 배경 오디오 필터링, 로깅, 일회용 토큰 인증을 위한 실시간 음성 인식 옵션을 추가했습니다. 최종 트랜스크립트, 엔터티, 잘못된 요청 이벤트를 추가했으며, 미수락 약관 디스패치 문제를 수정하고 이제 API 키 또는 토큰 없이 연결하면 거부합니다.
- [v2.62.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.62.0) - 더빙 `update_segments` 메서드와 `DubbingRegenerateResponse`를 추가했습니다. `guardrail_types`, `custom_guardrail_names`, `include_commit_status`, MCP `request_meta` 지원을 추가했습니다. 이제 더빙 세그먼트 업데이트는 요청 본문 모델을 사용하며, 언어 대상 생성에서 더 이상 `model_id`를 허용하지 않습니다.
- [v2.61.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.61.0) - `parent_conversation_id`, 분석 과금, 트리거된 가드레일 메타데이터, 브랜치 병합 충돌, DTMF 입력 마스킹, 더빙 트랜스크립트 업로드를 추가했습니다. OpenAI 실시간 세션 유형과 `run_subagent_*` 결과 모델을 제거했습니다.

#### Android SDK

- [v0.12.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.1) - 의도적인 텍스트 전용 세션 연결 해제가 `ConversationStatus.ERROR`로 보고되는 문제를 수정했습니다.
- [v0.12.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.0) - 대화 오디오를 Android 미디어 스트림으로 라우팅하기 위한 `ConversationConfig.useMediaStream`을 추가했습니다. 원격의 정상적인 WebSocket 종료는 이제 `DisconnectionDetails.Agent`로 보고되며, 로컬에서 시작한 종료는 `DisconnectionDetails.User`로 보고됩니다.

#### MCP 서버

- [v0.12.2](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.2) - 경로 탐색 문제를 수정했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### 더빙

- [원본 세그먼트 일괄 업데이트](/docs/ko/api-reference/dubbing/source-transcript/batch-update-source-segments) - `PATCH /v1/dubbing/project/{project_id}/transcript/segments`
  - `DubbingBulkSegmentUpdateRequest` 필요
  - 원본 세그먼트 텍스트, 화자 또는 타이밍을 원자적으로 업데이트
  - 업데이트된 `segments` 및 `revision`이 포함된 `DubbingBulkSourceSegmentUpdateResponse` 반환
- [대상 세그먼트 일괄 업데이트](/docs/ko/api-reference/dubbing/target-transcript/batch-update-target-segments) - `PATCH /v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments`
  - `DubbingBulkTargetSegmentUpdateRequest` 필요
  - 여러 대상 세그먼트의 번역을 원자적으로 업데이트
  - 업데이트된 `segments` 및 `revision`이 포함된 `DubbingBulkTargetSegmentUpdateResponse` 반환

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 목록](/docs/ko/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 선택적 `parent_conversation_id`(문자열) 추가
  - 선택적으로 반복 가능한 `guardrail_types` (`GuardrailType[]`) 및 `custom_guardrail_names`(문자열 배열) 추가
- [에이전트 브랜치 목록](/docs/ko/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
  - 선택적 `include_commit_status`(불리언, 기본값 `false`) 추가
  - 브랜치 요약에 null 허용 `commits_ahead`(정수), `commits_behind`(정수), `merged_into_branch_id`(문자열) 추가

### 음성

- [모든 음성 v2 가져오기](/docs/ko/api-reference/voices/search) - `GET /v2/voices`
  - 선택적 `gender`, `age`, `accent`(문자열) 필터 추가
  - 선택적 `language`, `use_cases`(문자열 배열) 필터 추가
  - 선택적 `min_notice_period_days`(정수), `include_custom_rates`, `include_live_moderated`, `high_quality`(불리언) 필터 추가

## 스키마 변경 사항

### ElevenAgents

- 클라이언트 오버라이드 스키마에 `max_duration_seconds`(정수) 및 `pronunciation_dictionary_locators`(배열) 추가
- MCP 서버 입력 및 출력 스키마에 `request_meta` 맵 추가
- 에이전트 플랫폼 설정에 `alerting` 추가, 언어 감지에 `only_at_conversation_start`(불리언) 추가
- `AnalysisCharging.last_run`이 이제 필수이며 null을 허용하지 않음. 누적 합계에 필수 `runs`(정수) 추가
- 이제 RAG 청크 응답에 `content_format` 및 `document_type` 필요

</Accordion>

## August 3, 2026

### ElevenAgents

- **테스트별 도구 모의 객체**: 이제 에이전트 시뮬레이션 및 단위 테스트에서 도구 ID를 키로 하는 `tool_mock_overrides`를 정의하여 하나의 테스트에 대해 공유 모의 객체를 대체할 수 있습니다. `ToolResponseMockConfig`에는 모의 객체가 도구 실패 경로를 테스트할 수 있도록 선택적 `is_error`(불리언, 기본값 `false`)도 추가됩니다.
- **번역된 워크플로 메시지**: 리터럴 Say 노드 메시지에 언어 키와 `TranslatedString` 객체의 맵인 `text_translations`가 추가됩니다. 이 필드는 입력에서는 선택 사항이고 출력에서는 필수이므로 엄격한 응답 검증기는 이를 허용해야 합니다.
- **대화 버전 필터**: [대화 나열](/docs/ko/api-reference/conversations/list) 및 [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search)에 에이전트 버전별로 결과를 필터링하는 선택적 `version_id` 쿼리 매개변수(문자열)가 추가됩니다.
- **지식 베이스 시스템 도구**: 에이전트 구성에 구성 가능한 `enabled_strategies`(`SearchStrategy[]`)를 갖는 `knowledge_base` 시스템 도구가 추가됩니다. 에이전트 지식 베이스 RAG 쿼리에 선택적 `use_agent_defaults`(불리언, 기본값 `true`)가 추가됩니다. 이를 `false`로 설정하면 에이전트의 임베딩 모델은 유지하면서 중립적인 검색 설정을 사용합니다.
- **에이전트 음성 활동 감지**: 에이전트 생성, 업데이트, 응답 및 워크플로 오버라이드 스키마에 `vad` 구성이 추가됩니다. 현재 `VADConfig`는 `background_voice_detection`(불리언, 기본값 `false`)을 지원합니다.
- **WebSocket 사용자 지정 LLM**: `CustomLLMAPIType`에 `websocket`이 추가됩니다.
- **파일 메모리 제어**: 위젯 파일 입력 구성에 `max_files_in_memory`(정수, 1~30, 기본값 `10`)가 추가됩니다. 제한을 초과한 파일은 요약된 후 메모리에서 해제되며, `max_files_per_conversation`은 `-1`이거나 최소 메모리 제한 이상이어야 합니다.
- **DTMF 입력 마스킹**: `DTMFInputConfig`에 통화자의 키패드 숫자를 트랜스크립트, 대화 로그 및 분석에서 대체하는 선택적 `redact_input`(불리언, 기본값 `false`)이 추가됩니다. 에이전트가 반복하거나 도구로 전달한 숫자는 변경되지 않습니다.

### 음성 텍스트 변환

- **실시간 엔터티 감지**: Scribe v2 Realtime에 `entity_detection` 쿼리 옵션이 추가됩니다. `all`, 하나의 엔터티 유형 또는 카테고리, 혹은 유형 및 카테고리 배열을 허용하며 감지된 엔터티를 `committed_transcript_entities` 이벤트로 내보냅니다. 지원되는 카테고리는 [엔터티 감지 가이드](/docs/ko/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)를 참조하세요.

### 음성

- **데이터 레지던시 간 음성 복제**: 동일한 통합 결제 그룹의 워크스페이스로 Instant Voice Clone 또는 Voice Design 음성을 복사하는 `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`를 추가했습니다. 요청에는 `target_workspace_id`(문자열)가 필요하며 `preserve_voice_id`(불리언, 기본값 `true`)를 받을 수 있습니다. 응답은 대상 `voice_id`를 반환합니다.
- **캐릭터 메타데이터**: 캐릭터 응답에 `recommended_voice_ids`(문자열 배열, 기본값 `[]`)가 추가되고, 메타데이터에 nullable `role`(`CharacterRole`)이 추가되며, `CharacterAge`에서는 `middle-aged`가 `middle_aged`로 대체됩니다.

### SDK 릴리스

#### 패키지

- [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0), [@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0), [@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0), [@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17), [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - `start`, `delta`, `stop` 유형의 스트리밍 에이전트 추론 이벤트를 수신하는 `onAgentReasoningResponsePart`를 추가했습니다.
- [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0), [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - `show_resize_button` 및 `show-resize-button` 임베드 속성을 추가했습니다. 둘 중 하나를 `false`로 설정하면 위젯 헤더의 확장 및 축소 컨트롤이 숨겨집니다.
- [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0), [@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0), [@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0), [@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18), [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - `Scribe.connect` 및 `useScribe`에 `enableLogging` 옵션을 추가했습니다. 이를 `false`로 설정하면 엔터프라이즈 제로 보존 세션이 시작됩니다. 이제 Scribe `session_started` 유형은 `enable_logging`을 보고하며, 사용되지 않는 `disable_logging` 필드는 제거되었습니다.

#### MCP 서버

- [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - v0.11 도구 업데이트와 44개의 보안 경고를 해결하는 종속성 새로 고침을 포함합니다.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - 구성 가능한 시뮬레이션 사용자 동작, 평가 기준, 트랜스크립트 출력, 통과/실패 분석을 갖춘 `simulate_conversation`을 추가했습니다. 이제 `speech_to_text` 도구는 기본적으로 `scribe_v2`를 사용하며, `voice_clone`은 경로 문자열 대신 오디오 파일 콘텐츠를 전송합니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### 음성

- `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`
  - Instant Voice Clone 또는 Voice Design 음성을 다른 워크스페이스의 격리된 환경으로 복제합니다.
  - `target_workspace_id`(문자열)가 필요합니다.
  - 선택적 `preserve_voice_id`(불리언, 기본값 `true`)를 받습니다.
  - 필수 `voice_id`(문자열)를 반환합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 나열](/docs/ko/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 선택적 `version_id`(문자열) 쿼리 매개변수를 추가했습니다.
- [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 선택적 `version_id`(문자열) 쿼리 매개변수를 추가했습니다.
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - 선택적 `use_agent_defaults`(불리언, 기본값 `true`) 요청 필드를 추가했습니다.

## 스키마 변경 사항

### ElevenAgents

- 시뮬레이션 및 단위 테스트 페이로드에 선택적 `tool_mock_overrides` 맵이 추가되고, `ToolResponseMockConfig`에 선택적 `is_error`(불리언, 기본값 `false`)가 추가됩니다.
- `SayNodeLiteralMessage`에 `text_translations`(`TranslatedString` 맵)가 추가됩니다. 이 필드는 입력에서는 선택 사항이고 출력에서는 필수입니다.
- 에이전트 구성에 `knowledge_base`(`KnowledgeBaseToolConfig`) 및 `vad`(`VADConfig`)가 추가됩니다.
- `CustomLLMAPIType`에 `websocket`이 추가됩니다.
- `FileInputConfig`에 `max_files_in_memory`(정수, 1~30, 기본값 `10`)가 추가됩니다.
- `DTMFInputConfig`에 선택적 `redact_input`(불리언, 기본값 `false`)이 추가됩니다.
- 이제 실시간 에이전트 구성의 기본값은 `eleven_realtime_v1_mini`입니다.

### 음성

- 캐릭터 응답에 `recommended_voice_ids`(문자열 배열, 기본값 `[]`)가 추가됩니다.
- 캐릭터 메타데이터에 nullable `role`(`CharacterRole`)이 추가됩니다.
- 호환성 깨짐: `CharacterAge`에서 `middle-aged`가 `middle_aged`로 대체됩니다. 이전 값을 전송하는 클라이언트는 마이그레이션해야 합니다.

### 텍스트 음성 변환

- 호환성 깨짐: ElevenAgents 텍스트 음성 변환 구성 스키마에서 `AudioFilterId` 및 `audio_filter`를 제거했습니다.

</Accordion>

## July 27, 2026

### ElevenAgents

- **WhatsApp 브랜치 및 환경 재정의**: [발신 WhatsApp 메시지](/docs/ko/api-reference/whats-app/outbound-message) 및 [발신 통화](/docs/ko/api-reference/whats-app/outbound-call)가 이제 `conversation_initiation_client_data`에 전달된 `branch_id`와 `environment`를 따릅니다. 메시지가 전송되기 전에 재정의 값이 검증되며, 존재하지 않는 브랜치나 환경은 오류와 함께 거부됩니다. 재정의 값은 대화 중에도 유지되므로 고객의 답변이 요청된 [브랜치](/docs/ko/eleven-agents/operate/versioning) 및 [환경](/docs/ko/eleven-agents/integrate/environment-variables)에서 이어집니다. 예시는 [WhatsApp 가이드](/docs/ko/eleven-agents/whatsapp)를 참조하세요.
- **프로시저 API**: [프로시저](/docs/ko/eleven-agents/customization/procedures)를 관리하기 위한 브랜치 범위의 공개 작업 8개를 추가했습니다. 프로시저를 생성, 나열, 조회, 삭제할 수 있으며, 초안 변경 사항을 생성, 조회, 폐기하고 프로시저 초안을 에이전트 workflow로 컴파일할 수 있습니다. 프로시저 생성에는 `name`, `content`, `type`, `trigger`를 사용할 수 있습니다. 비어 있는 `trigger`는 하위 프로시저를 생성하며, 생략되거나 `null`인 trigger는 프로시저 콘텐츠에서 파생됩니다.
- **지식 베이스 크롤 작업**: 크롤 작업을 생성, 나열, 검사, 취소하는 API를 추가했습니다. 생성 요청에는 `url`(문자열)이 필요하며 크롤 깊이, 페이지 제한, URL 패턴, 사이트맵 URL, 폴더 배치, 자동 동기화 및 사용할 수 없는 문서 제거를 지원합니다.
- **대량 지식 베이스 관리**: 고유한 문서 또는 폴더 ID 1~20개에 대한 [대량 종속성 검사](/docs/ko/api-reference/knowledge-base/dependent-agents-multiple) 및 [대량 삭제](/docs/ko/api-reference/knowledge-base/bulk-delete)를 추가했습니다. 종속성 검사는 페이지네이션과 `dependent_type`을 지원하며, 삭제는 각 ID에 대해 독립적인 성공 또는 실패 결과를 반환합니다. `force: true`를 설정하면 종속성도 제거하고 비어 있지 않은 폴더를 재귀적으로 삭제합니다.
- **일괄 통화 결과 내보내기**: 완료된 일괄 작업에서 수신자와 대화 결과를 CSV로 다운로드하는 [일괄 통화 결과 내보내기](/docs/ko/api-reference/batch-calling/export)를 추가했습니다.
- **대화 필터 및 분석 데이터**: [대화 목록](/docs/ko/api-reference/conversations/list) 및 [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search)에 각각 최대 50개 값으로 제한되는 선택적 `visited_agent_ids` 및 `visited_agent_branch_ids` 배열 필터를 추가했습니다. 목록 요청은 각 대화 요약에 해당 결과를 포함하기 위해 `data_collection_ids`와 `evaluation_criteria_ids`도 받을 수 있습니다. 요약에는 선택적 `data_collection_results`, `evaluation_criteria_results`, `tag_ids`가 추가됩니다.
- **참조 분석 구성**: 에이전트 플랫폼 설정에 평가 및 데이터 수집 항목을 참조로 연결하기 위한 `AgentAnalysisItems` 타입의 선택적 nullable `analysis_items` 필드를 추가했습니다. `null` 값은 에이전트가 여전히 기존 인라인 필드를 사용함을 나타내며, 빈 값은 연결된 항목이 없는 마이그레이션된 에이전트를 나타냅니다.
- **프로시저 종속성 메타데이터**: 프로시저 참조에 `trigger`(문자열) 및 `referenced_tool_ids`, `referenced_kb_ids`, `referenced_procedure_ids`, `referenced_dynamic_variables` 배열을 추가했습니다.
- **WebRTC 토큰 응답**: [WebRTC 토큰 가져오기](/docs/ko/api-reference/conversations/get-webrtc-token) 응답에 이제 `token` 외에도 `conversation_id`(문자열)가 필요합니다. 이는 응답 형태를 검증하거나 역직렬화하는 클라이언트에 대한 호환성이 깨지는 스키마 변경입니다.
- **지식 베이스 RAG 결과**: `KnowledgeBaseRagToolResultModel`에 RAG 결과를 도구 결과에 포함하는 모드를 위한 `chunks`(`KnowledgeBaseRagChunkModel[]`)를 추가했습니다.

### Studio

- **프로젝트 초안 상태**: `ProjectCreationMetaResponseModel.status`에 `draft`를 추가했습니다. 이제 프로젝트 생성 타입은 동일한 기존 값을 가진 공유 `ProjectCreationMetaType` enum을 사용합니다.

### Voices

- **음성 억양**: 공유 보이스 라이브러리에서 사용할 수 있는 억양을 나열하는 `GET /v1/voices/accents`를 추가했습니다. 결과는 `language`와 `model_id`로 필터링할 수 있으며, 각 억양은 `accent`, `language`, `code`, 사람이 읽을 수 있는 `name`을 반환합니다. `accent` 값은 공유 음성을 필터링하기 위해 [공유 음성 가져오기](/docs/ko/api-reference/voices/voice-library/get-shared)의 `accent` 쿼리 매개변수에 전달할 수 있습니다.

### Workspaces

- **Webhook 사용량 보고**: `WebhookUsageType`에 `Flows`를 추가했습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - 공유 보이스 라이브러리의 음성 억양을 나열하는 `voices.accents.get`과 최신 스키마의 ElevenAgents 프로시저, 지식 베이스 크롤 작업 및 대량 관리 API, 참조 분석 구성을 추가했습니다.

#### Python SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - 최신 스키마의 음성 억양, ElevenAgents 프로시저, 지식 베이스 크롤 작업 및 대량 관리 API를 추가했습니다. 또한 더 이상 차단되지 않도록 `AsyncConversation` 시작 방식을 수정하고, 기본 타입 목록 multipart 필드가 반복된 양식 필드로 전송되도록 수정했습니다.

#### Packages

- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - 오디오 재생은 LiveKit 트랙에서 유지하면서 오디오 메시지의 정렬 메타데이터를 전달하도록 WebRTC 전송의 `onAudioAlignment`를 수정했습니다.
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2), [@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16), [@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12), [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - `@elevenlabs/client@1.15.2`의 WebRTC 정렬 수정 사항을 포함하도록 종속성을 업데이트했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - 프로시저를 생성하고 `procedure_id`(문자열)를 반환합니다.
  - 선택적 `name`(문자열, 최대 200자), `content`(문자열), `type`(`ProcedureType`, 기본값 `free_form`), `trigger`(nullable 문자열)를 받습니다.
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - `procedure_id`, `version_id`, `name`, `type`, `trigger`, `has_draft`와 함께 브랜치 프로시저를 나열합니다.
  - 프로시저 콘텐츠는 제외됩니다. 콘텐츠를 읽으려면 개별 프로시저를 조회하세요.
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - 선택적 `version_id`(문자열)를 받으며, 그렇지 않으면 브랜치 헤드의 버전을 반환합니다.
  - `name`, `content`, `type`, `trigger`를 반환합니다.
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - 브랜치의 초안 작업 세트에서 프로시저를 제거합니다.
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 현재 프로시저 초안을 반환합니다.
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 초안을 생성하거나 업데이트합니다.
  - `name`(문자열, 최대 200자), `content`(문자열, 최대 50,000자), `type`(`ProcedureType`)이 필요하며, 선택적 `trigger`(nullable 문자열)를 받습니다.
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 초안 변경 사항을 폐기하고 프로시저를 커밋된 버전으로 재설정합니다.
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
  - 프로시저 초안을 `AgentWorkflowResponseModel`로 컴파일합니다.
- [크롤 작업 생성](/docs/ko/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
  - `url`(문자열)이 필요합니다.
  - 선택적 `max_depth`(정수, 1~5, 기본값 `3`), `max_pages`(정수, 1~10,000, 기본값 `1000`), `pattern`(문자열), `sitemap_urls`(문자열 배열), `parent_folder_id`(문자열), `enable_auto_sync`(불리언, 기본값 `false`), `auto_remove`(불리언, 기본값 `false`)를 받습니다.
- [크롤 작업 목록](/docs/ko/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
  - 선택적 `include_job_ids`(문자열 배열), `page_size`(정수, 1~100, 기본값 `30`), `cursor`(문자열)를 받습니다.
- [크롤 작업 가져오기](/docs/ko/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [크롤 작업 취소](/docs/ko/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [여러 문서의 종속 에이전트 가져오기](/docs/ko/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
  - `document_ids`(고유 문자열 1~20개 배열)가 필요합니다.
  - 선택적 `dependent_type`(`KnowledgeBaseDependentType`, 기본값 `all`), `page_size`(정수, 1~100, 기본값 `30`), `cursor`(문자열)를 받습니다.
- [지식 베이스 문서 대량 삭제](/docs/ko/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
  - `document_ids`(고유 문자열 1~20개 배열)가 필요합니다.
  - 선택적 `force`(불리언, 기본값 `false`)를 받습니다.
  - 각 문서 ID에 대한 성공 또는 실패 결과를 반환합니다.
- [일괄 통화 결과 내보내기](/docs/ko/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
  - 완료된 일괄 작업의 수신자와 대화 결과를 CSV로 반환합니다.

### Voices

- `GET /v1/voices/accents`
  - 공유 보이스 라이브러리에서 사용할 수 있는 억양을 나열합니다.
  - 선택적 `language`(문자열) 및 `model_id`(문자열) 쿼리 매개변수를 받습니다.
  - 각 억양은 `accent`, `language`, `code`, `name`을 반환합니다.

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 목록](/docs/ko/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 각각 최대 50개 값으로 제한되는 선택적 `visited_agent_ids` 및 `visited_agent_branch_ids` 문자열 배열 필터를 추가했습니다.
  - 각 요약의 분석 결과를 선택하기 위한 선택적 `data_collection_ids` 및 `evaluation_criteria_ids` 문자열 배열을 추가했습니다.
  - 응답 요약에 선택적 객체 필드 `data_collection_results`, `evaluation_criteria_results`와 문자열 배열 `tag_ids`를 추가했습니다.
- [대화 메시지 텍스트 검색](/docs/ko/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 각각 최대 50개 값으로 제한되는 선택적 `visited_agent_ids` 및 `visited_agent_branch_ids` 문자열 배열 필터를 추가했습니다.
- [WebRTC 토큰 가져오기](/docs/ko/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - 이제 응답에 `conversation_id`(문자열)가 필요합니다.
  - 호환성 깨짐: 엄격한 응답 검증기와 역직렬화기는 새 필수 필드를 허용해야 합니다.

## 스키마 변경 사항

### ElevenAgents

- 에이전트 플랫폼 요청 및 응답 설정에 참조 평가 및 데이터 수집 구성을 위한 `AgentAnalysisItems` 타입의 선택적 nullable `analysis_items` 필드를 추가했습니다.
- 프로시저 참조에 `trigger`(문자열), `referenced_tool_ids`(문자열 배열), `referenced_kb_ids`(문자열 배열), `referenced_procedure_ids`(문자열 배열), `referenced_dynamic_variables`(문자열 배열)를 추가했습니다.
- `KnowledgeBaseRagToolResultModel`에 `chunks`(`KnowledgeBaseRagChunkModel[]`)를 추가했습니다.

### Studio

- `ProjectCreationMetaResponseModel.status`에 `draft`를 추가했습니다.
- 이제 `ProjectCreationMetaResponseModel.type`이 공유 `ProjectCreationMetaType` enum을 참조합니다.

### Workspaces

- `WebhookUsageType`에 `Flows`를 추가했습니다.

</Accordion>

## July 20, 2026

### 음악

- **Music Finetunes API**: [Music Finetunes](/docs/ko/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`(정수)가 추가되었습니다.
- **대화 텍스트 검색 필터**: [대화 메시지 텍스트 검색](/docs/ko/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)가 추가되었습니다.

### 음성 텍스트 변환

- **일회용 일괄 인증**: [음성을 텍스트로 변환](/docs/ko/api-reference/speech-to-text/convert)에 API 키 또는 bearer 인증의 대안으로 선택적 `token`(문자열)이 추가되었습니다. `POST /v1/single-use-token/batch_scribe`로 일회용 토큰을 생성할 수 있으며, 15분 후 만료됩니다.
- **Realtime 클라이언트 안정성**: 이제 `@elevenlabs/client`는 `RealtimeEvents.ERROR`를 통해 마이크 설정 및 잘못된 서버 오류를 보고하고, 설정 실패 및 연결 종료 후 마이크 리소스를 해제하며, 소켓 해제 후 늦게 도착한 마이크 프레임을 삭제합니다.

### 텍스트 음성 변환

- **보관된 발음 사전**: [발음 사전 목록](/docs/ko/api-reference/pronunciation-dictionaries/list)에 선택적 `include_archived`(boolean, 기본값 `true`)가 추가되었습니다.

### 워크스페이스

- **웹훅 이벤트 구독**: [워크스페이스 웹훅 업데이트](/docs/ko/api-reference/webhooks/update) 요청에 `voice_library_removal_notice`, `speech_to_text`, `agent_qa`를 포함하는 선택적 `events` (`WorkspaceWebhookEventType[]`)가 추가되었습니다. 웹훅 응답은 구독한 이벤트 목록을 반환할 수 있습니다.
- **사용량 분석 차원**: [워크스페이스 사용량 가져오기](/docs/ko/api-reference/analytics/workspace/usage)의 `group_by` 값에 `surface` 및 `actor`가 추가되었습니다.
- **서비스 계정 한도 삭제**: [서비스 계정 API 키 업데이트](/docs/ko/api-reference/service-accounts/api-keys/update)는 `"no_update"` 및 정수 값과 함께 월간 문자 한도를 제거하는 `character_limit: "clear"`를 허용합니다.
- **알림 웹훅 참조**: 알림 웹훅 알리미 스키마는 이제 `url`, `method`, `headers`를 포함하는 대신 필수 `webhook_id`(문자열)로 워크스페이스 웹훅을 식별합니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Music Finetunes를 나열, 생성, 가져오기, 업데이트, 삭제하는 `music.finetunes` 메서드가 추가되었습니다. 또한 대화 참조 확인, 보관된 발음 사전 필터링, 일회용 음성 텍스트 변환 토큰이 추가되었습니다.

#### Python SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - 최신 API 스키마의 Music Finetunes 및 대화 참조 확인 기능이 추가되었습니다. `OnPremInitiationData`에도 서명된 통화 후 웹훅을 위한 선택적 `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) 및 [@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) - R8 및 ProGuard가 `text`, `type`과 같은 발신 WebSocket 및 WebRTC 이벤트 필드를 난독화하지 않도록 했습니다.

#### 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/ko/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - 커서 페이지네이션, 공개 범위 및 생성자 필터, 생성 시간 또는 이름 기준 정렬을 지원합니다.
- [Music Finetune 생성](/docs/ko/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
  - `name` 및 `primary_genre`가 필요합니다.
  - 최대 50개의 오디오 파일, 태그, 공개 범위 및 `model_id`를 허용합니다.
- [Music Finetune 가져오기](/docs/ko/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Music Finetune 업데이트](/docs/ko/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - `name`, `tags`, `primary_genre` 또는 `visibility`를 업데이트합니다.
- [Music Finetune 삭제](/docs/ko/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/ko/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 선택적 `exclude_statuses` 및 `termination_reasons` 배열 쿼리 매개변수가 추가되었습니다.

### 음성 텍스트 변환

- [음성을 텍스트로 변환](/docs/ko/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - 일회용 일괄 Scribe 토큰을 위한 선택적 `token`(문자열) 쿼리 매개변수가 추가되었습니다.

### 텍스트 음성 변환

- [발음 사전 목록](/docs/ko/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
  - 선택적 `include_archived`(boolean, 기본값 `true`) 쿼리 매개변수가 추가되었습니다.

### 워크스페이스

- [워크스페이스 웹훅 업데이트](/docs/ko/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
  - 선택적 `events` (`WorkspaceWebhookEventType[]`) 요청 필드가 추가되었습니다.
- [워크스페이스 사용량 가져오기](/docs/ko/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
  - 선택적 `group_by` 배열에 `surface` 및 `actor`가 추가되었습니다.
- [서비스 계정 API 키 업데이트](/docs/ko/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`(정수)가 추가되었습니다.
- 에이전트 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 요청, 응답, 페이지네이션, 공개 범위, 생성자, 상태 및 실패 사유 스키마가 추가되었습니다.
- 모든 음악 생성 요청 스키마는 생성된 SDK에 `finetune_id`를 제공합니다.

### 워크스페이스

- 워크스페이스 웹훅 요청 및 응답 스키마에 선택적 `events` (`WorkspaceWebhookEventType[]`)가 추가되었습니다.
- 알림 웹훅 알리미 스키마는 `url`, `method`, `headers` 대신 필수 `webhook_id`(문자열)를 사용합니다.

</Accordion>

## July 13, 2026

### ElevenAgents

- **에이전트별 감정 분석**: 플랫폼 설정에 에이전트별 통화 후 감정 점수 설정을 위한 선택적 `sentiment_analysis` (`SentimentAnalysisSettings`)가 추가되었습니다.
- **트랜스크립트 자동 번역**: 플랫폼 설정에 기록에서 대화 트랜스크립트를 조회자의 앱 언어로 번역하는 선택적 `auto_translate_transcript_to_app_language`(불리언)가 추가되었습니다.
- **중첩 에이전트 전환**: 워크플로에 중첩 에이전트 전환을 위한 push, pop, replace 작업이 추가되었습니다.
- **백채널 감지**: 트랜스크립트 사용자 턴 모델에 백채널로 필터링된 발화를 표시하는 선택적 `ignored_as_backchannel`(불리언)이 추가되었습니다.
- **보조 대화 오디오**: [대화 가져오기](/docs/ko/api-reference/conversations/get) 응답에 기존 오디오 플래그와 함께 필수 `has_auxiliary_audio`(불리언)가 추가되었습니다.
- **MCP 환경 범위 지정**: MCP 서버 및 도구 경로의 도구 목록 조회, 도구 조회, 도구 구성 생성, 도구 구성 업데이트 엔드포인트에 선택적 `environment` 쿼리 파라미터(기본값: production)가 추가되었습니다.
- **도구 호출 사운드 재정의**: 도구 및 MCP 재정의 스키마에서 `tool_call_sound: "off"`를 사용해 도구별 호출 사운드를 끄는 동시에, 설정하지 않으면 서버 기본값을 상속할 수 있습니다.
- **Twilio SMS 라우팅**: Twilio 전화번호 가져오기 요청에 번호 설정 중 수신 SMS 라우팅을 제어하는 선택적 `enable_sms`(불리언, 기본값: 켜짐)가 추가되었습니다.
- **사용자 감정 정렬**: [사용자 목록](/docs/ko/api-reference/users/list)에 선택적 `sort_direction`이 추가되었으며, `average_sentiment_score` 기준 정렬을 지원합니다.
- **지식 베이스 외부 동기화**: 외부 동기화 스키마에서 `ExternalSyncType`의 이름이 `ExternalSyncProvider`로 변경되었고, `KbExternalSyncJob`과 동기화 작업 트리거 및 유형 열거형이 추가되었습니다. 폴더 응답에는 진행 중이거나 완료된 동기화 상태를 위한 `active_sync_job`이 포함될 수 있습니다.
- **TTS 지연 시간 설정 지원 중단**: 에이전트 TTS 설정의 `optimize_streaming_latency`가 지원 중단으로 표시되었으며, 아무 작업도 수행하지 않는 것으로 문서화되었습니다.

### 워크스페이스

- **서비스 계정 생성**: 프로그래밍 방식의 서비스 계정 프로비저닝을 위해 선택적 `default_sharing_groups` (`DefaultSharingGroupConfig`)를 포함하는 [서비스 계정 생성](/docs/ko/api-reference/service-accounts/create) (`POST /v1/service-accounts`)이 추가되었습니다.
- **워크스페이스 멤버 목록**: 사용자 ID, 이메일, 시트 상태, 소유자 및 잠금 플래그가 포함된 `WorkspaceMemberResponseModel` 항목을 반환하는 [워크스페이스 멤버 가져오기](/docs/ko/api-reference/workspace/members/list) (`GET /v1/workspace/members`)가 추가되었습니다. 서비스 계정은 제외됩니다.
- **초대 크레딧 한도**: 워크스페이스 초대 페이로드(단일 및 일괄)에 초대받는 사용자의 월간 크레딧 한도를 위한 선택적 `usage_limit`이 추가되었습니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.57.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.57.0) - `run_subagent` 시스템 도구 유형, 에이전트별 감정 분석 설정, 중첩 에이전트 전환 워크플로 모델, 지식 베이스 외부 동기화 유형 및 MCP `environment` 쿼리 파라미터를 포함한 최신 OpenAPI 스키마에서 재생성되었습니다.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.58.0) - 서비스 계정 생성, 워크스페이스 멤버 목록, 초대 `usage_limit`, 대화 `has_auxiliary_audio`, 다중 컨텍스트 텍스트-대화 WebSocket 메시지 유형을 포함한 최신 OpenAPI 스키마에서 재생성되었습니다.

#### Python SDK

- [v2.57.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.57.0) - `run_subagent` 시스템 도구 모델, 에이전트별 감정 분석 설정, 중첩 에이전트 전환 워크플로 모델, 지식 베이스 외부 동기화 유형 및 MCP `environment` 쿼리 파라미터를 포함한 최신 OpenAPI 스키마에서 재생성되었습니다.
- [v2.58.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.58.0) - 서비스 계정 생성, 워크스페이스 멤버 목록, 초대 `usage_limit`, 대화 `has_auxiliary_audio`, 다중 컨텍스트 텍스트-대화 WebSocket 메시지 유형을 포함한 최신 OpenAPI 스키마에서 재생성되었습니다.

#### 패키지

- [@elevenlabs/client@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.0) - 연결 지연 시간 모니터링을 위해 `ping` 이벤트와 예상 `ping_ms`를 제공하는 `onPing` 콜백이 추가되었습니다.
- [@elevenlabs/react@1.10.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.0) - React 훅에서 `@elevenlabs/client@1.15.0`의 `onPing` 콜백을 노출했습니다.
- [@elevenlabs/types@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.17.1), [@elevenlabs/convai-widget-core@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.10) 및 [@elevenlabs/convai-widget-embed@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.10) - `@elevenlabs/client@1.15.0`에 맞춰 종속성을 정렬했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### 워크스페이스

- [서비스 계정 생성](/docs/ko/api-reference/service-accounts/create) - `POST /v1/service-accounts`
- [워크스페이스 멤버 가져오기](/docs/ko/api-reference/workspace/members/list) - `GET /v1/workspace/members`

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 가져오기](/docs/ko/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - 응답에 필수 `has_auxiliary_audio`(불리언)가 추가되었습니다.
- [사용자 목록](/docs/ko/api-reference/users/list) - `GET /v1/convai/users`
  - 선택적 `sort_direction` 쿼리 파라미터가 추가되었습니다.
  - 정렬 옵션으로 `average_sentiment_score`가 추가되었습니다.
- [도구 가져오기](/docs/ko/api-reference/tools/get) - `GET /v1/convai/tools/{tool_id}`
  - 선택적 `environment` 쿼리 파라미터가 추가되었습니다.
- [MCP 서버 도구 목록](/docs/ko/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
  - 선택적 `environment` 쿼리 파라미터가 추가되었습니다.
- [MCP 도구 구성 생성](/docs/ko/api-reference/mcp/tool-configuration/create) - `POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs`
  - 선택적 `environment` 쿼리 파라미터가 추가되었습니다.
- [MCP 도구 구성 업데이트](/docs/ko/api-reference/mcp/tool-configuration/update) - `PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}`
  - 선택적 `environment` 쿼리 파라미터가 추가되었습니다.

### 워크스페이스

- [사용자 초대](/docs/ko/api-reference/workspace/invites/create) - `POST /v1/workspace/invites/add`
  - 초대받는 사용자의 월간 크레딧 한도를 위한 선택적 `usage_limit`이 추가되었습니다.
- [여러 사용자 초대](/docs/ko/api-reference/workspace/invites/create-batch) - `POST /v1/workspace/invites/add/bulk`
  - 초대받는 사용자의 월간 크레딧 한도를 위한 선택적 `usage_limit`이 추가되었습니다.

## 스키마 변경 사항

### ElevenAgents

- 시스템 도구
  - 필수 `agents` 배열을 포함하는 `run_subagent` (`RunSubagentToolConfig`)가 추가되었습니다.
- 플랫폼 설정
  - 선택적 `sentiment_analysis` (`SentimentAnalysisSettings`)가 추가되었습니다.
  - 선택적 `auto_translate_transcript_to_app_language`(불리언)가 추가되었습니다.
- 워크플로
  - `AgentTransferOp`의 push, pop, replace를 포함하는 중첩 `AgentTransfer` 모델링이 추가되었습니다.
- 트랜스크립트
  - 사용자 턴 모델에 선택적 `ignored_as_backchannel`(불리언)이 추가되었습니다.
- 도구 및 MCP
  - 도구 구성 모델에 `tool_call_sound: "off"` 재정의 지원이 추가되었습니다.
  - TTS 에이전트 설정의 `optimize_streaming_latency`가 지원 중단되었습니다(아무 작업도 수행하지 않음).
- 전화 기능
  - Twilio 전화번호 가져오기 요청에 선택적 `enable_sms`(불리언)가 추가되었습니다.
- 지식 베이스
  - `ExternalSyncType`의 이름이 `ExternalSyncProvider`로 변경되었습니다.
  - `KbExternalSyncJob`, 동기화 작업 트리거 및 유형 열거형이 추가되었습니다.
  - 폴더 응답에 선택적 `active_sync_job`이 추가되었습니다.
- 감정
  - `SentimentAggregate`에 최근 기간 수와 평균 점수가 확장되었습니다.

### 워크스페이스

- 서비스 계정
  - 생성 응답을 위한 `WorkspaceCreateServiceAccountResponseModel`이 추가되었습니다.
  - 생성 요청에 선택적 `default_sharing_groups`가 추가되었습니다.
- 멤버
  - 목록 응답을 위한 `WorkspaceMemberResponseModel`이 추가되었습니다.
- 초대
  - 단일 및 일괄 초대 요청 본문에 선택적 `usage_limit`이 추가되었습니다.

</Accordion>

## July 6, 2026

### 음악

- **세부 정보와 함께 음악 스트리밍**: 작곡 계획, 곡 메타데이터, base64 오디오 청크 및 `with_timestamps`를 통한 선택적 단어 타임스탬프를 포함하여 작곡된 오디오와 상세 메타데이터를 SSE로 스트리밍하는 [세부 정보와 함께 음악 스트리밍](/docs/ko/api-reference/music/compose-detailed-stream) (`POST /v1/music/detailed/stream`)을 추가했습니다.

### ElevenAgents

- **대화 시뮬레이션 지원 중단**: [대화 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation) 및 [스트리밍 대화 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation-stream)은 지원 중단되었으며, 대신 [테스트 생성](/docs/ko/api-reference/tests/create) 및 [에이전트에서 테스트 실행](/docs/ko/api-reference/tests/run-tests)을 사용하세요.
- **도구 인터럽션 모드**: 에이전트 도구 및 MCP 서버 스키마 전반에서 `disable_interruptions`가 지원 중단되었습니다. 대신 `interruption_mode`(`ToolInterruptionMode`: `allow`, `disable_during_tool`, `disable_during_tool_and_turn`)를 사용하세요. 도구 재정의 모델의 `interruption_mode`를 통해 도구별로 재정의할 수 있습니다.
- **숫자 평가 점수**: 평가 기준 스키마에 선택적 `scoring_mode`(`binary` | `numeric_uniform`), 선택적 `max_score`(정수), 선택적 `score_instructions`(문자열)가 추가됩니다. 평가 결과에 선택적 숫자 `score`가 추가됩니다. 대화 분석 페이로드에 선택적 `call_success_score` 및 `success_score`가 추가됩니다.
- **대화 추론**: 트랜스크립트 및 기록 모델에 선택적 `reasoning`(`ConversationReasoningModel`)이 추가되고, 트랜스크립트 응답에 선택적 `reasoned`(부울)가 추가됩니다. 에이전트 프롬프트 및 LLM 스키마에 선택적 `enable_reasoning_summary`(부울)가 추가됩니다.
- **대화 플랫폼 청구**: 대화 관련 모델에 `PlatformCategory` 및 `PlatformCategoryUsage`를 통한 카테고리별 분석과 함께 선택적 `platform_charge`, `platform_price`, `platform_usage`가 추가됩니다.
- **대화 비용 메타데이터**: 대화 기록 메타데이터에 필수 읽기 전용 `cost_fiat`(숫자, USD)가 추가됩니다.
- **마스킹되지 않은 웹훅 이벤트**: `WebhookEventType`에 마스킹되지 않은 페이로드가 필요한 웹훅 구독을 위한 `unredacted_transcript` 및 `unredacted_audio`가 추가됩니다.
- **워크플로 전화 전환 UUI 제한**: SIP REFER 전환 시 RFC 7433 User-to-User Information을 위한 `UUITransferConfig.data`의 최대 길이가 256자에서 8192자로 늘어납니다.

### Speech Engine

- **선택적 인증 우회**: JavaScript 및 Python SDK v2.56.0의 Speech Engine WebSocket 클라이언트에 선택적 `disableAuth` / `disable_auth`가 추가됩니다. 이는 API 키 인증 대신 IP 허용 목록 또는 사용자 지정 인증 헤더와 같은 다른 방법으로 연결을 보호하는 통합을 위한 기능입니다.

### 워크스페이스

- **프로페셔널 음성 슬롯 추적**: 통합 청구 가시성을 위해 구독 스타일 모델에 그룹 전체 `professional_voice_slots_used`를 명확히 하는 것과 함께 선택적 `professional_voice_slots_used_in_workspace`가 추가됩니다.

### ElevenCreative Studio

- **캡션 스타일링**: 캡션 스타일 모델에 블러 및 테두리 반경 필드가 추가됩니다. 진입 및 퇴장 애니메이션 열거형에 `slam`, `scale_down`, `slide_in`이 추가됩니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.56.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.56.0) - Speech Engine WebSocket 클라이언트에 선택적 `disableAuth`를 추가했습니다. 음악 상세 스트리밍, 도구 `interruption_mode`, 평가 점수 모드, 대화 추론 및 플랫폼 청구 필드를 포함한 최신 OpenAPI 스키마로 재생성했습니다.

#### Python SDK

- [v2.56.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.56.0) - Speech Engine WebSocket 클라이언트에 선택적 `disable_auth`를 추가했습니다. 음악 상세 스트리밍, 도구 `interruption_mode`, 평가 점수 모드, 대화 추론 및 플랫폼 청구 필드를 포함한 최신 OpenAPI 스키마로 재생성했습니다.

#### CLI

- [@elevenlabs/cli@0.5.5](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs%2Fcli%400.5.5) - 구성 왕복 충실도를 유지하기 위해 에이전트 생성 및 업데이트 요청을 이제 원시 JSON으로 전송합니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### 음악

- [세부 정보와 함께 음악 스트리밍](/docs/ko/api-reference/music/compose-detailed-stream) - `POST /v1/music/detailed/stream`

## 업데이트된 엔드포인트

### ElevenAgents

- [대화 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation) - `POST /v1/convai/agents/{agent_id}/simulate-conversation`
  - 지원 중단됨으로 표시되었습니다. 대신 [테스트 생성](/docs/ko/api-reference/tests/create) 및 [에이전트에서 테스트 실행](/docs/ko/api-reference/tests/run-tests)을 사용하세요.
- [스트리밍 대화 시뮬레이션](/docs/ko/api-reference/agents/simulate-conversation-stream) - `POST /v1/convai/agents/{agent_id}/simulate-conversation/stream`
  - 지원 중단됨으로 표시되었습니다. 대신 [테스트 생성](/docs/ko/api-reference/tests/create) 및 [에이전트에서 테스트 실행](/docs/ko/api-reference/tests/run-tests)을 사용하세요.

## 스키마 변경 사항

### ElevenAgents

- 도구 및 MCP
  - `disable_interruptions`는 지원 중단되었으며, 대신 `interruption_mode`(`allow`, `disable_during_tool`, `disable_during_tool_and_turn`)를 사용하세요.
  - MCP 및 도구 재정의 모델에 도구별 `interruption_mode` 재정의를 추가했습니다.
- 평가 및 분석
  - 평가 기준에 선택적 `scoring_mode`, `max_score`, `score_instructions`를 추가했습니다.
  - 평가 결과에 선택적 숫자 `score`를 추가했습니다.
  - 대화 분석 페이로드에 선택적 `call_success_score` 및 `success_score`를 추가했습니다.
- 트랜스크립트 및 추론
  - 트랜스크립트 및 기록 모델에 선택적 `reasoning`(`ConversationReasoningModel`)을 추가했습니다.
  - 트랜스크립트 응답에 선택적 `reasoned`(부울)를 추가했습니다.
  - 에이전트 프롬프트 및 LLM 스키마에 선택적 `enable_reasoning_summary`(부울)를 추가했습니다.
- 청구 및 메타데이터
  - 대화 모델에 선택적 `platform_charge`, `platform_price`, `platform_usage`를 추가했습니다.
  - 대화 기록 메타데이터에 필수 읽기 전용 `cost_fiat`(USD)를 추가했습니다.
- 웹훅
  - `WebhookEventType`에 `unredacted_transcript` 및 `unredacted_audio`를 추가했습니다.
- 워크플로
  - `UUITransferConfig.data`의 최대 길이를 256자에서 8192자로 늘렸습니다.

### 워크스페이스

- 청구
  - 구독 스타일 모델에 선택적 `professional_voice_slots_used_in_workspace`를 추가했습니다.

### ElevenCreative Studio

- 캡션
  - 캡션 스타일 모델에 블러 및 테두리 반경 필드를 추가했습니다.
  - `slam`, `scale_down`, `slide_in` 애니메이션 유형을 추가했습니다.

</Accordion>

## June 29, 2026

### ElevenAgents

- **브랜치 병합 및 리베이스 미리보기**: 커밋하기 전에 병합되거나 리베이스된 에이전트 구성을 확인할 수 있도록 [병합된 구성 미리보기](/docs/ko/api-reference/agents/branches/preview) (`GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`) 및 리베이스된 구성 미리보기 (`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`)를 추가했습니다. 둘 다 결과 구성, `overridden_fields`, `source_identical_to_target`를 포함한 `MergePreviewResponseModel`을 반환합니다.
- **브랜치 사용량 지표**: [에이전트 브랜치 목록](/docs/ko/api-reference/agents/branches/list) 브랜치 요약 응답에 브랜치별 지난 7일간의 통화량을 나타내는 선택적 `calls_7d`(정수)가 추가됩니다.
- **인증 연결 상태**: 워크스페이스 인증 연결 응답 모델에서 OAuth 전용 `OAuthConnectionStatus`를 공통 `AuthConnectionStatus`(`active`, `refresh_failed`, `revoked`, `credential_invalid`)로 대체했습니다. Bearer, Basic, mTLS, 사용자 지정 헤더, OAuth, OAuth2 JWT, Slack, URL 시크릿 및 WhatsApp 인증 응답에 선택적 `status`, `status_detail`, `status_updated_at` 필드가 추가됩니다.
- **도구 응답 필터링**: HTTP 및 에이전트 도구 구성 스키마에 도구 응답이 LLM에 도달하기 전에 정리할 수 있는 선택적 `response_filter`가 추가되고, 관련 재정의 모델에는 `response_filter_mode` 및 `response_filters`가 추가됩니다.
- **워크플로 전화 전환**: 워크플로 전화번호 전환 노드에 SIP REFER 전환 시 RFC 7433 16진수 User-to-User Information을 위한 선택적 `uui`(`UUITransferConfig`)가 추가됩니다.
- **전화 에이전트 할당**: Twilio, Exotel 및 SIP 트렁크 전화번호 가져오기 요청 스키마에 번호 설정 중 에이전트를 할당하는 선택적 `agent_id`(문자열)가 추가됩니다.
- **인터럽션 비활성화 시 턴 트랜스크립션**: 턴 구성 스키마에 인터럽션이 비활성화된 경우 사용자 음성을 트랜스크립션할지 제어하는 선택적 `transcribe_on_disabled_interruptions`(부울, 기본값 `false`)가 추가됩니다.
- **대화 감정**: 대화 요약 스키마에 선택적 `sentiment_analysis`가 추가됩니다. 대화 사용자 모델에 불만이 있는 대화 참조가 포함된 선택적 `sentiment`가 추가됩니다.

### 음성 텍스트 변환

- **통합 멀티채널 출력**: [음성을 텍스트로 변환](/docs/ko/api-reference/speech-to-text/convert)에 `use_multi_channel`이 활성화된 경우 선택적 `multichannel_output_style`(`separate` 기본값 | `combined`)이 추가됩니다. 채널별 트랜스크립트 대신 모든 채널을 병합하고 시간순으로 정렬한 단일 트랜스크립트를 받으려면 `combined`를 설정하세요. 멀티채널 모드가 활성화되면 단어 수준 응답의 각 단어에 `channel_index`가 포함됩니다.

### 텍스트 음성 변환

- **`language_code` 동작 **: TTS 요청 스키마에서 지원되지 않는 `language_code` 값은 거부되지 않고 무시되며, `language_code`는 `multilingual_v2` 모델에서 지원되지 않음을 명확히 했습니다.

### 워크스페이스

- **타사 API 키 비활성화 정책**: API 키 보유자가 타사 비활성화 엔드포인트를 통해 직접 키를 비활성화할 수 있는지 워크스페이스 전체에서 제어할 수 있도록 [워크스페이스 타사 비활성화 정책 설정](/docs/ko/api-reference/api-keys/set-third-party-disabling-policy) (`POST /v1/workspaces/api-keys/third-party-disabling`)을 추가했습니다. 워크스페이스 API 키 생성, 패치 및 응답 모델에 선택적 `third_party_disable_allowed`(부울)가 추가됩니다.
- **Bearer 인증 연결 업데이트**: [워크스페이스 인증 연결 업데이트](/docs/ko/api-reference/workspace/auth-connections/update) 요청 유니온에 Bearer 토큰 자격 증명 업데이트를 위한 `UpdateBearerAuthRequest`가 추가됩니다.
- **워크스페이스 권한**: 권한 열거형에 `conversation_privacy_manage` 및 `synthid_detector`가 추가됩니다. 워크스페이스 그룹 모델에 선택적 `scim_group`(문자열)이 추가됩니다.

### SDK 릴리스

#### JavaScript SDK

- [v2.55.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.55.0) - 브랜치 병합 및 리베이스 미리보기 클라이언트, 브랜치 통화량 지표, 인증 연결 상태 필드, 도구 응답 필터링 유형, 음성 텍스트 변환 통합 멀티채널 출력, 워크스페이스 타사 API 키 비활성화 정책을 포함한 최신 OpenAPI 스키마로 재생성했습니다.

#### Python SDK

- [v2.55.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.55.0) - 브랜치 병합 및 리베이스 미리보기 클라이언트, 브랜치 통화량 지표, 인증 연결 상태 필드, 도구 응답 필터링 모델, 음성 텍스트 변환 통합 멀티채널 출력, 워크스페이스 타사 API 키 비활성화 정책을 포함한 최신 OpenAPI 스키마로 재생성했습니다.

#### 패키지

- [@elevenlabs/client@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.13.0) - `sendFeedback(like, eventId?)`가 특정 과거 메시지를 평가하기 위한 선택적 `event_id`를 허용합니다. 이제 `canSendFeedback`은 연결 상태를 반영하므로 세션이 활성화된 동안 모든 메시지에 피드백을 보낼 수 있습니다.
- [@elevenlabs/client@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.14.0) - `sendFeedback`가 이벤트의 피드백을 지우기 위해 첫 번째 인수로 `null`을 허용합니다(`score: null`).
- [@elevenlabs/react@1.8.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.8.0) 및 [@elevenlabs/react@1.9.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.9.0) - React 훅에서 `@elevenlabs/client@1.13.0` 및 `@elevenlabs/client@1.14.0`의 메시지별 및 피드백 지우기 `sendFeedback` 변경 사항을 노출했습니다.
- [@elevenlabs/react-native@1.2.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.11) 및 [@elevenlabs/react-native@1.2.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.12) - `@elevenlabs/client@1.13.0`–`1.14.0` 및 `@elevenlabs/react@1.8.0`–`1.9.0`에 대한 종속성 정렬.
- [@elevenlabs/types@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.16.0), [@elevenlabs/convai-widget-core@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.8) 및 [@elevenlabs/convai-widget-embed@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.8) - `@elevenlabs/client@1.13.0`–`1.14.0`에 대한 종속성 정렬.

#### Android SDK

- [v0.10.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.10.0) - 조정된 메시지 트랜스크립트를 `StateFlow`로 노출했습니다. 텍스트 및 에이전트 콜백은 이벤트 ID 변형으로 대체하기 위해 지원 중단되었습니다.
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.0) - 대화 중 프레임별 오디오 검사를 위한 오디오 프레임 콜백을 추가했습니다.

#### iOS SDK

- [v3.2.2](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.2) - 올바른 룸 이벤트 처리를 위해 LiveKit 룸 델리게이트 메서드 구현을 수정했습니다.

### API

<Accordion title="API 변경 사항 보기">

## 새 엔드포인트

### ElevenAgents

- `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview` - 병합 전 병합된 구성 미리보기
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview` - 리베이스 전 리베이스된 구성 미리보기

### 워크스페이스

- `POST /v1/workspaces/api-keys/third-party-disabling` - 워크스페이스 타사 API 키 비활성화 정책 설정

## 업데이트된 엔드포인트

### ElevenAgents

- [에이전트 브랜치 목록](/docs/ko/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches`
  - 브랜치 요약 응답에 선택적 `calls_7d`(정수)가 추가됩니다.
- [병합된 구성 미리보기](/docs/ko/api-reference/agents/branches/preview) - `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`
  - 병합된 구성, `overridden_fields`, `source_identical_to_target`를 포함한 `MergePreviewResponseModel`을 반환합니다.
- 리베이스된 구성 미리보기 - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`
  - 리베이스된 구성 미리보기를 포함한 `MergePreviewResponseModel`을 반환합니다.

### 음성 텍스트 변환

- [음성을 텍스트로 변환](/docs/ko/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - `use_multi_channel`이 활성화된 경우 선택적 `multichannel_output_style`(`separate` | `combined`)가 추가됩니다.
  - 멀티채널 모드에서 단어 수준 응답은 단어별 `channel_index`를 포함합니다.

### 워크스페이스

- [워크스페이스 타사 비활성화 정책 설정](/docs/ko/api-reference/api-keys/set-third-party-disabling-policy) - `POST /v1/workspaces/api-keys/third-party-disabling`
  - API 키 보유자가 타사 비활성화 흐름을 통해 직접 키를 비활성화할 수 있는지 제어합니다.
- [워크스페이스 인증 연결 업데이트](/docs/ko/api-reference/workspace/auth-connections/update) - `PATCH /v1/workspace/auth-connections/{auth_connection_id}`
  - 요청 유니온에 `UpdateBearerAuthRequest`가 추가됩니다.

## 스키마 변경 사항

### ElevenAgents

- 인증 연결
  - `OAuthConnectionStatus`를 `AuthConnectionStatus`(`active`, `refresh_failed`, `revoked`, `credential_invalid`)로 대체했습니다.
  - 인증 연결 응답 모델에 선택적 `status`, `status_detail`, `status_updated_at`를 추가했습니다.
- 도구 및 워크플로
  - HTTP 및 에이전트 도구 구성에 선택적 `response_filter`를 추가했습니다.
  - 전환 관련 워크플로 모델에 선택적 `uui`(`UUITransferConfig`)를 추가했습니다.
- 턴 구성
  - 선택적 `transcribe_on_disabled_interruptions`(부울, 기본값 `false`)를 추가했습니다.
- 전화 가져오기
  - Twilio, Exotel 및 SIP 트렁크 가져오기 요청 스키마에 선택적 `agent_id`를 추가했습니다.
- 대화 모델
  - 대화 요약 유형에 선택적 `sentiment_analysis`를 추가했습니다.
  - 대화 사용자 모델에 선택적 `sentiment`를 추가했습니다.

### 텍스트 음성 변환

- `language_code`는 지원되지 않을 경우 무시되며 `multilingual_v2`에서는 지원되지 않음을 명확히 했습니다.

### 워크스페이스

- API 키
  - 생성, 패치 및 응답 모델에 선택적 `third_party_disable_allowed`(부울)를 추가했습니다.
- 권한
  - `conversation_privacy_manage` 및 `synthid_detector`를 추가했습니다.
- 그룹
  - 워크스페이스 그룹 모델에 선택적 `scim_group`(문자열)을 추가했습니다.

</Accordion>

_Showing the 20 most recent of 101 entries. Append `/llms.txt` to the changelog URL for the complete index._