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

### Apresentando o Speech Engine

O ElevenLabs Speech Engine adiciona voz em tempo real ao seu próprio agente de chat ou LLM. A ElevenLabs cuida da conversão de fala em texto, alternância de turnos, conversão de texto em fala e reprodução no navegador, enquanto seu servidor controla a lógica do agente e transmite o texto de resposta por um WebSocket do Speech Engine. Use-o quando quiser adicionar voz a uma infraestrutura personalizada, em vez de uma configuração totalmente hospedada do ElevenAgents.

<CardGroup cols={3}>
  <Card
    title="Início rápido"
    icon="duotone code"
    href="/docs/pt/eleven-api/guides/cookbooks/speech-engine"
  >
    Crie um agente com voz usando o SDK do Speech Engine em minutos.
  </Card>
  <Card
    title="Habilidade do agente"
    icon="duotone sparkles"
    href="https://github.com/elevenlabs/skills/blob/main/speech-engine/SKILL.md"
  >
    Orientações para assistentes de programação com IA que integram o Speech Engine.
  </Card>
  <Card
    title="Referência da API"
    icon="duotone book"
    href="/docs/pt/api-reference/speech-engine/create"
  >
    Crie, atualize e gerencie recursos do Speech Engine pela API REST.
  </Card>
</CardGroup>

### ElevenAgents

- **Substituições de comportamento de texto**: Adicionado `text_behavior_overrides`, um mapa por `ConversationInitiationSource` de objetos `BehaviorOverride` com campos opcionais `verbosity`, `output_format` e `interaction_budget` para o comportamento do agente específico de cada canal.
- **Fontes de integração**: Adicionados Intercom, Telegram e Freshdesk.
- **Rastreios de conversa OTLP**: [Obter detalhes da conversa](/docs/pt/api-reference/conversations/get) agora aceita um parâmetro de consulta opcional `format`. Defina `format=otlp_traces` para retornar dados de rastreio compatíveis com OTLP junto à carga padrão da conversa.
- **Substituições de palavras-chave do ASR**: Adicionados os esquemas `ASRConversationalConfigOverride` e `ASRConversationalConfigOverrideConfig` com matrizes opcionais `keywords`, integrados aos modelos de substituição de cliente da configuração de conversa.
- **Metadados de autenticação de webhook**: Os esquemas de configuração de ferramentas de webhook agora expõem `auth_resolved_params` opcional (matriz de strings), documentando os marcadores de posição de URL resolvidos pela conexão de autenticação.

### Música

- **Modo de geração**: Adicionado `MusicGenerationMode` (`track`, `loop`, `ambience`) e um campo opcional `generation_mode` nos corpos de solicitação de prompt de música.
- **Modelo de vídeo para música**: [Vídeo para música](/docs/pt/api-reference/music/video-to-music) (`POST /v1/music/video-to-music`) agora aceita `model_id` opcional (string, padrão `music_v1`).

### ElevenCreative Studio

- **Créditos de conversão**: Os modelos de resposta de estatísticas de conversão de capítulos e vozes agora incluem `credits_needed_to_convert` opcional (inteiro), que indica os créditos necessários antes da conversão.

### Espaços de trabalho

- **Tipos de recurso**: Adicionado `studio_projects` a `WorkspaceResourceType`.

### Lançamentos de SDK

#### SDK Python

- [v2.50.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.50.0) - SDK regenerado para o esquema da API de 25 de maio de 2026.
- [v2.49.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.49.1) - Chamadas da API do Speech Engine atualizadas para retornar o objeto de resposta completo.
- [v2.49.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.49.0) - SDK regenerado para o esquema da API de 18 a 25 de maio de 2026, incluindo substituições de comportamento de texto do ElevenAgents, `generation_mode` de música e `studio_projects` de espaços de trabalho.

#### SDK JavaScript

- [v2.50.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.50.0) - Adicionados métodos e testes ausentes da API de Música, e SDK regenerado para o esquema da API de 25 de maio de 2026.
- [v2.49.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.49.1) - Chamadas da API do Speech Engine atualizadas para retornar o objeto de resposta completo.
- [v2.49.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.49.0) - SDK regenerado para o esquema da API de 18 a 25 de maio de 2026, incluindo substituições de comportamento de texto do ElevenAgents, `generation_mode` de música e `studio_projects` de espaços de trabalho.

#### Pacotes

- [@elevenlabs/client@1.8.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.8.1) - Corrigido o Safari no iOS, que descartava a primeira mensagem do agente em sessões de voz por WebSocket, desbloqueando um `AudioContext` no primeiro gesto do usuário e inicializando o grafo de reprodução após o carregamento do audio worklet.
- [@elevenlabs/convai-widget-core@0.12.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.8) e [@elevenlabs/convai-widget-embed@0.12.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.8) - Estilizadas tags de emoção e áudio em transcrições de voz quando `strip_audio_tags` está desativado, e tratados `terms_html` ou `terms_text` nulos no nível superior como um interruptor de desativação para o modal de termos e condições.
- [@elevenlabs/convai-widget-core@0.12.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.7) e [@elevenlabs/convai-widget-embed@0.12.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.7) - Dependências do widget atualizadas para `@elevenlabs/client@1.8.1`.

### API

<Accordion title="Ver alterações da API">

## Endpoints e esquemas atualizados

### ElevenAgents

- [Obter detalhes da conversa](/docs/pt/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - Adicionado o parâmetro de consulta opcional `format`; `otlp_traces` retorna dados de rastreio compatíveis com OTLP
- Esquemas de configuração do agente
  - Adicionado o mapa `text_behavior_overrides`, indexado por `ConversationInitiationSource`, com valores `BehaviorOverride` (`verbosity`, `output_format`, `interaction_budget`)
- Enum `ConversationInitiationSource`
  - Adicionados `intercom_integration`, `telegram_integration` e `freshdesk_integration`
- Esquemas de substituição do ASR
  - Adicionados `ASRConversationalConfigOverride` e `ASRConversationalConfigOverrideConfig` com `keywords` opcional (matriz de strings)
- Esquemas de ferramentas de webhook
  - Adicionado `auth_resolved_params` opcional (matriz de strings) aos modelos de configuração de webhook

### Música

- [Vídeo para música](/docs/pt/api-reference/music/video-to-music) - `POST /v1/music/video-to-music`
  - Adicionado `model_id` opcional (string, padrão `music_v1`)
- Esquemas de solicitação de prompt de música
  - Adicionado `generation_mode` opcional que faz referência a `MusicGenerationMode` (`track`, `loop`, `ambience`)

### ElevenCreative Studio

- Esquemas de estatísticas de conversão de capítulos e vozes
  - Adicionado `credits_needed_to_convert` opcional (inteiro)

### Espaços de trabalho

- Enum `WorkspaceResourceType`
  - Adicionado `studio_projects`

</Accordion>