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

### Vi introducerar Music v2

Music v2 är nu tillgängligt via ElevenLabs API. Ange `model_id` till `music_v2` i [Generera musik](/docs/sv/api-reference/music/compose), [Streama musik](/docs/sv/api-reference/music/stream), [Generera musik med detaljer](/docs/sv/api-reference/music/compose-detailed) och [Ladda upp musik](/docs/sv/api-reference/music/upload) för att använda den nya modellen. Music v2 introducerar chunk-baserade kompositionsplaner som byggs av segmenten `GenerationChunk` och `AudioRefChunk`, vilket ger dig mer detaljerad kontroll över struktur, tempo och arrangemang än det promptbaserade flödet `music_v1`.

Använd kompositionsplaner för `music_v2` i genererings- och uppladdningsförfrågningar, eller generera först en plan via endpointen för kompositionsplaner. Förfrågnings- och svarsbrödtexter accepterar antingen v1- eller v2-planformat, så att du kan migrera endpoint för endpoint. `MusicPrompt` är fortfarande endast tillgängligt för `music_v1`.

<CardGroup cols={3}>
  <Card
    title="Snabbstart"
    icon="duotone code"
    href="/docs/sv/eleven-api/guides/cookbooks/music"
  >
    Generera ditt första spår med Music API på några minuter.
  </Card>
  <Card
    title="Kompositionsplaner"
    icon="duotone layer-group"
    href="/docs/sv/eleven-api/guides/how-to/music/composition-plans"
  >
    Skapa chunk-baserade kompositionsplaner för strukturerade spår med flera sektioner.
  </Card>
  <Card
    title="API-referens"
    icon="duotone book"
    href="/docs/sv/api-reference/music/compose"
  >
    Komponera, streama och ladda upp musik med `music_v2` via REST API.
  </Card>
</CardGroup>

- **Tidsstämplar vid uppladdning**: [Ladda upp musik](/docs/sv/api-reference/music/upload) accepterar valfria `with_timestamps`; svar kan innehålla `words_timestamps`.

### ElevenAgents

- **Kör konversationsutvärdering**: Lade till endpointen [Kör konversationsutvärdering](/docs/sv/api-reference/conversations/analysis/run-evaluation) (`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`) för att köra om ett enskilt utvärderingskriterium mot en avslutad konversation med `RunConversationEvaluationsRequest`.
- **Beteende vid workflow-start**: Workflow-noder för åsidosättningsagenter lägger till valfria `entry_behavior` (`generate_immediately`, `wait_for_user`, `auto`) för att styra om underagenten talar först eller väntar på användarindata.
- **Systemverktyg för att avsluta procedur**: Lade till systemverktygskonfigurationen `end_procedure` med matchande felstatusar. Verktyget `start_procedure` lägger till `already_active` i sina felstatusar.
- **TTS-åsidosättanden vid överföring**: `AgentTransfer`, fristående agentnoder i workflow och lyckade verktygsresultat från `transfer_to_agent` lägger till valfria `preserve_client_tts_overrides` (boolean) för att behålla TTS-åsidosättanden på klientsidan efter en överföring.
- **Enum för interaktionsbudget**: `InteractionBudget` tar bort `async` och lägger till `5_minutes`, `10_minutes` och `1_hour`. Uppdatera konfigurationer eller SDK-enumeringar som fortfarande refererar till `async`.
- **Val av modell för anpassade skyddsräcken**: Konfigurationen för anpassade skyddsräcken lägger till valfria `model` med Gemini-, Claude- och GPT-varianter. Konfigurationen för skyddsräcken lägger också till valfria `history_message_count` (heltal).
- **Filter för telefonnummerlista**: [Lista telefonnummer](/docs/sv/api-reference/phone-numbers/list) lägger till valfria frågeparametrarna `provider`, `agent_id` och `branch_id` för att filtrera importerade nummer.
- **Filtrering av WhatsApp-konton**: [Lista WhatsApp-konton](/docs/sv/api-reference/whats-app/accounts/list) lägger till den valfria frågeparametern `agent_id` för att filtrera konton efter tilldelad agent.
- **Tidsintervallfilter för ämnen**: [Hämta agentens konversationsämnen](/docs/sv/api-reference/conversations/topics/get) lägger till valfria frågeparametrarna `from_unix_secs` och `to_unix_secs` för att begränsa resultat för ämnesidentifiering.
- **SIP-codec-konfiguration**: Begärande- och svarsmodeller för utgående SIP-trunk lägger till valfria `enabled_codecs` (`MediaCodec`-enum).
- **Typer för minnesverktyg**: Lade till schemana `LoadableMemoryEntry` och `LoadMemoryEntryToolErrorStatus` för felhantering i minnesverktyg.
- **Batchgränser för agenttester**: Begärandescheman för att koppla, köra och skicka in agenttester på nytt höjer maximalt antal kopplade tester från 1000 till 5000.
- **Stöd för fonemtaggar**: Agentens TTS-inställningar lägger till valfria `enable_phoneme_tags` (boolean) för valfri V3-hantering av SSML-fonem.
- **Åsidosättanden för utelämning i arrayschema**: JSON-schemaegenskaper för arrayer lägger till valfria `is_omitted` (ömsesidigt uteslutande med andra värdekällor). `ConstantSchemaOverride` kan använda konstanta arrayvärden.
- **Felkontext vid överföring**: Felpayloads för överföring till nummer kan innehålla valfria `agent_message` (sträng).

### Arbetsytor

- **Uppdateringar av API-nycklar för tjänstekonton**: [Uppdatera API-nyckel för tjänstekonto](/docs/sv/api-reference/service-accounts/api-keys/update) kräver inte längre en begärandetext. Redigeringsfält har stöd för partiella uppdateringar via `no_update` och nullable `name`, inklusive `permissions` och `character_limit`.
- **Tidszonsindelning av användning**: Förfrågningar om arbetsytans användning per produkt över tid lägger till valfria `time_zone` (IANA-tidszonsträng) med förtydligade regler för `interval_seconds`-intervall.
- **Källfilter för historik**: Filtren `source` för historiklistor och -detaljer lägger till `Flows`.

### ElevenCreative Studio

- **Projektröstreferenser**: Projektmodeller, kapitel-TTS-noder, röstlistor och röststatistik övergår till `project_voice_ref_id` som det kanoniska röstfältet. Tidigare fält `voice_id` finns kvar i svar som föråldrade, skrivskyddade speglingar för kompatibilitet.

### Speech to Text

- **Diarisering med röstbibliotek**: [Konvertera tal till text](/docs/sv/api-reference/speech-to-text/convert) lägger till valfria `use_speaker_library` (boolean, standard `false`) för diariserad batchtranskribering.

### Röster

- **Sortering av delade röster**: Frågeparametern `sort` i [Lista delade röster](/docs/sv/api-reference/voices/voice-library/get-shared) får en explicit enum, standardvärdet `created_date` och en uppdaterad beskrivning.

### SDK-versioner

#### JavaScript SDK

- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.0) - Återgenererad från det senaste OpenAPI-schemat med stöd för att köra om konversationsutvärderingar, unioner för kompositionsplaner i music v2, workflow-`entry_behavior`, listfilter för telefonnummer och WhatsApp, parametrar för tidsintervall för ämnen, uppdateringar av aviseringsschema, studiofält för `project_voice_ref_id` och utökade batchgränser för agenttester.

#### Python SDK

- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.53.0) - Återgenererad från det senaste OpenAPI-schemat med stöd för att köra om konversationsutvärderingar, kompositionsplaner för music v2, workflow-startbeteende och verktyg för att avsluta procedurer, telekomfilterparametrar, modeller för partiella uppdateringar av aviseringar och tjänstekonton samt röstreferensfält för studio.

#### Paket

- [@elevenlabs/client@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Lade till export av delsökvägen `@elevenlabs/client/internal/unity` för Unity SDK:s WebGL-brygga, med `MediaDeviceInput`, `MediaDeviceOutput`, hjälpfunktioner för anslutning och typer för WebRTC-adapter.
- [@elevenlabs/client@1.11.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.1), [@elevenlabs/react@1.6.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.7), [@elevenlabs/react-native@1.2.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.7), [@elevenlabs/convai-widget-core@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.2) och [@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - Beroendejustering till `@elevenlabs/client@1.11.1` och `@elevenlabs/types@0.14.1`.
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - Lade till `"license": "MIT"` i `package.json` för kompatibilitet med license-checker.

#### iOS SDK

- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - Lade till stöd för datahemvist i Singapore och aktiverade `singlePeerConnection` för WebRTC-sessioner.

### API

<Accordion title="Visa API-ändringar">

## Nya endpoints

### ElevenAgents

- [Kör konversationsutvärdering](/docs/sv/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
  - Begärandetexten använder `RunConversationEvaluationsRequest` för att köra om ett enskilt utvärderingskriterium

## Uppdaterade endpoints

### ElevenAgents

- [Lista telefonnummer](/docs/sv/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
  - Lade till valfria frågeparametrarna `provider`, `agent_id` och `branch_id`
- [Hämta agentens konversationsämnen](/docs/sv/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - Lade till valfria frågeparametrarna `from_unix_secs` och `to_unix_secs`
- [Lista WhatsApp-konton](/docs/sv/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
  - Lade till valfri frågeparameter `agent_id`

### Musik

- [Generera musik](/docs/sv/api-reference/music/compose), [Generera musik med detaljer](/docs/sv/api-reference/music/compose-detailed), [Streama musik](/docs/sv/api-reference/music/stream) och [Ladda upp musik](/docs/sv/api-reference/music/upload)
  - Lade till `music_v2` bland värden som stöds för `model_id`
  - Uppladdning lägger till valfria `with_timestamps`; svar kan innehålla `words_timestamps`

### Speech to Text

- [Konvertera tal till text](/docs/sv/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - Lade till valfri frågeparameter `use_speaker_library` (boolean, standard `false`)

### Röster

- [Lista delade röster](/docs/sv/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
  - Frågeparametern `sort` använder nu en explicit enum med standardvärdet `created_date`

## Schemaändringar

### ElevenAgents

- Workflow-noder för åsidosättningsagenter
  - Lade till valfri `entry_behavior`-enum (`generate_immediately`, `wait_for_user`, `auto`)
- Systemverktyg
  - Lade till verktygskonfigurationen `end_procedure` och felstatusar
- Överförings- och interaktionsscheman
  - Lade till valfria `preserve_client_tts_overrides` för överföringar och verktygsresultat för överföring
  - `InteractionBudget` tar bort `async`; lägger till `5_minutes`, `10_minutes`, `1_hour`
- Skyddsräcken och TTS
  - Anpassade skyddsräcken lägger till valfria `model` och `history_message_count`
  - Agentens TTS-inställningar lägger till valfria `enable_phoneme_tags`
- Telekommunikation
  - SIP-trunkmodeller lägger till valfria `enabled_codecs` (`MediaCodec`-enum)
- Minnes- och kodverktyg
  - Lade till `LoadableMemoryEntry` och `LoadMemoryEntryToolErrorStatus`
- Agenttestning
  - Höjde gränserna för kopplade tester från 1000 till 5000 för kör- och återsändningsförfrågningar
- JSON-schemaegenskaper för verktyg
  - Arrayegenskaper lägger till valfria `is_omitted`

### Arbetsytor

- Tjänstekonton
  - PATCH för API-nycklar har stöd för partiella uppdateringar med `no_update`-sentinels
- Användning och historik
  - Användning per produkt över tid lägger till valfria `time_zone`
  - Historikfilter för `source` lägger till `Flows`

### Musik

- Kompositionsplaner
  - Lade till chunk-baserade `CompositionPlan`, `GenerationChunk` och `AudioRefChunk` för `music_v2`
  - Förfrågnings- och svarsbrödtexter accepterar `anyOf` v1- eller v2-planformat

### ElevenCreative Studio

- Projektröstmodeller
  - Lade till `project_voice_ref_id` som kanonisk röstreferens
  - Föråldrade skrivskyddade speglingar av `voice_id` behålls i svar

</Accordion>