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

### Muzyka

- **API Music Finetunes**: Dodano obsługę API do zarządzania [Music Finetunes](/docs/pl/eleven-creative/products/music/finetunes). Pięć endpointów pozwala utworzyć Finetune z przesłanego audio, wyświetlić dostępne Finetunes, pobrać status treningu, zaktualizować metadane i widoczność lub usunąć Finetune. Wszystkie metody SDK do generowania muzyki udostępniają teraz `finetune_id`.

### ElevenAgents

- **Rozwiązywanie zewnętrznych odwołań do rozmów**: Dodano `GET /v1/convai/conversations/resolve`, aby rozwiązywać URL wiadomości Slack lub zgłoszenia Zendesk do rozmowy. Żądania wymagają parametrów zapytania `agent_id` i `reference` (string).
- **Wyszukiwanie w bazach wiedzy agentów**: Dodano `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` do zapytań RAG tylko do odczytu w bazie wiedzy agenta. Żądanie wymaga `query` (string), akceptuje opcjonalne `branch_id` (string) i zwraca uszeregowane fragmenty z metadanymi dokumentu, fragmentu, tekstu i odległości wektorowej. Ten endpoint jest wykluczony z generowanych SDK.
- **Formaty treści bazy wiedzy**: Odpowiedzi dla plików, tekstów i URL-i bazy wiedzy dodają opcjonalne `content_format` (`html` | `markdown`, domyślnie `html`).
- **Konfiguracja głosu agenta**: Schematy nadpisywania TTS dodają opcjonalne `model_id` (`TTSConversationalModel`), które może być nadpisane przez klienta. Wartość domyślna `enable_phoneme_tags` zmienia się z `false` na `true`.
- **Szybsza kaskada zapasowego LLM**: Domyślne `cascade_timeout_seconds` zmienia się z 8 na 4 sekundy. Dozwolony zakres nadal wynosi 2–15 sekund.
- **Źródła wartości parametrów narzędzi**: Parametry narzędzi typu obiekt mogą teraz używać `dynamic_variable`, `constant_value` lub `is_omitted`, zgodnie z istniejącymi kontrolkami dla wartości skalarnych i tablic. Nadpisania stałego schematu akceptują teraz dowolne tablice i obiekty.
- **Guardraile pełnej odpowiedzi**: Niestandardowe guardraile dodają opcjonalne `evaluate_full_response_only` (boolean, domyślnie `false`) do jednokrotnej oceny pełnej odpowiedzi bez TTS. Ta opcja wymaga trybu blokującego.
- **Nagrywanie rozmów Twilio**: Konfiguracja połączeń telefonicznych dodaje opcjonalne `twilio_call_recording_enabled` (boolean, domyślnie `false`). Nagrania są przechowywane na połączonym koncie Twilio, a to ustawienie jest ignorowane przez innych dostawców.
- **Teksty przesyłania plików w widżecie**: Konfiguracja tekstów widżetu dodaje opcjonalne etykiety i komunikaty błędów do dołączania i usuwania plików, błędów przesyłania, nieobsługiwanych typów, zbyt dużych plików, limitów liczby plików i wskaźnika pisania.
- **Status synchronizacji bazy wiedzy**: Odpowiedzi plików bazy wiedzy dodają opcjonalne `auto_sync_info` i `refresh_status` (`FileRefreshStatus`). Odpowiedzi folderów dodają wymagane `document_count` (integer), czyli rekurencyjną liczbę dokumentów niebędących folderami, ograniczoną do 1000.
- **Filtry wyszukiwania tekstowego rozmów**: [Wyszukiwanie tekstowe wiadomości rozmowy](/docs/pl/api-reference/conversations/messages/text-search) dodaje opcjonalne parametry zapytania tablic `exclude_statuses` i `termination_reasons`.
- **Opcje LLM**: Konfiguracja LLM agenta dodaje `gpt-5.6-sol`, `gpt-5.6-terra` i `gpt-5.6-luna`. `LLMReasoningEffort` dodaje `max`.
- **Wskaźniki pisania WhatsApp**: Schematy żądań i odpowiedzi kont WhatsApp dodają opcjonalne `enable_typing_indicator` (boolean).

### Speech to Text

- **Jednorazowe uwierzytelnianie wsadowe**: [Zamień mowę na tekst](/docs/pl/api-reference/speech-to-text/convert) dodaje opcjonalne `token` (string) jako alternatywę dla uwierzytelniania kluczem API lub bearer. Utwórz token jednorazowy przez `POST /v1/single-use-token/batch_scribe`; wygasa po 15 minutach.
- **Większa niezawodność klienta Realtime**: `@elevenlabs/client` zgłasza teraz błędy konfiguracji mikrofonu i nieprawidłowe błędy serwera przez `RealtimeEvents.ERROR`, zwalnia zasoby mikrofonu po błędach konfiguracji i zamknięciu połączenia oraz odrzuca opóźnione klatki mikrofonu po zamknięciu socketu.

### Text to Speech

- **Zarchiwizowane słowniki wymowy**: [Lista słowników wymowy](/docs/pl/api-reference/pronunciation-dictionaries/list) dodaje opcjonalne `include_archived` (boolean, domyślnie `true`).

### Obszary robocze

- **Subskrypcje zdarzeń webhooków**: Żądania [Aktualizuj webhook obszaru roboczego](/docs/pl/api-reference/webhooks/update) dodają opcjonalne `events` (`WorkspaceWebhookEventType[]`) z `voice_library_removal_notice`, `speech_to_text` i `agent_qa`. Odpowiedzi webhooków mogą zwracać listę subskrybowanych zdarzeń.
- **Wymiary analityki użycia**: [Pobierz użycie obszaru roboczego](/docs/pl/api-reference/analytics/workspace/usage) dodaje `surface` i `actor` do wartości `group_by`.
- **Usuwanie limitów konta serwisowego**: [Zaktualizuj klucz API konta serwisowego](/docs/pl/api-reference/service-accounts/api-keys/update) akceptuje `character_limit: "clear"`, aby usunąć miesięczny limit znaków, obok wartości `"no_update"` i integer.
- **Odwołania do webhooków alertów**: Schematy powiadamiacza webhooków alertów identyfikują teraz webhook obszaru roboczego za pomocą wymaganego `webhook_id` (string), zamiast osadzać `url`, `method` i `headers`.

### Wydania SDK

#### JavaScript SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Dodano metody `music.finetunes` do wyświetlania, tworzenia, pobierania, aktualizacji i usuwania Music Finetunes. Dodano też rozwiązywanie odwołań do rozmów, filtrowanie zarchiwizowanych słowników wymowy i jednorazowe tokeny Speech to Text.

#### Python SDK

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - Dodano Music Finetunes i rozwiązywanie odwołań do rozmów z najnowszego schematu API. `OnPremInitiationData` dodaje też typowane konfiguracje `post_call_transcription_webhook` i `post_call_audio_webhook` z opcjonalnym `hmac_secret` dla podpisanych webhooków po rozmowie.

#### Pakiety

- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - Ulepszono dostarczanie błędów Scribe Realtime i czyszczenie mikrofonu podczas błędów konfiguracji, zamknięcia przez klienta lub serwer oraz opóźnionych klatek audio.
- [@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) i [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - Zaktualizowano zależności, aby uwzględnić poprawki Scribe Realtime z `@elevenlabs/client@1.15.1`.

#### Android SDK

- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - Uniemożliwiono R8 i ProGuard zaciemnianie pól wychodzących zdarzeń WebSocket i WebRTC, takich jak `text` i `type`.

#### CLI

- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - Zaktualizowano domyślne szablony agentów, aby używały `scribe_realtime` zamiast usuniętego dostawcy ASR `elevenlabs`. Minimalne szablony nadal używają domyślnego ustawienia serwera.

### API

<Accordion title="Zobacz zmiany w API">

## Nowe endpointy

### Muzyka

- [Lista Music Finetunes](/docs/pl/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - Obsługuje paginację kursorem, filtry widoczności i twórcy oraz sortowanie według czasu utworzenia lub nazwy
- [Utwórz Music Finetune](/docs/pl/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
  - Wymaga `name` i `primary_genre`
  - Akceptuje do 50 plików audio, tagi, widoczność i `model_id`
- [Pobierz Music Finetune](/docs/pl/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Zaktualizuj Music Finetune](/docs/pl/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - Aktualizuje `name`, `tags`, `primary_genre` lub `visibility`
- [Usuń Music Finetune](/docs/pl/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}`

### ElevenAgents

- `GET /v1/convai/conversations/resolve`
  - Wymaga parametrów zapytania `agent_id` (string) i `reference` (string)
  - Zwraca `GetConversationResponseModel`
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - Wymaga `query` (string) w treści żądania
  - Akceptuje opcjonalny parametr zapytania `branch_id` (string)
  - Zwraca `AgentKnowledgeBaseRagQueryResponseModel`
  - Wykluczony z generowanych SDK

## Zaktualizowane endpointy

### ElevenAgents

- [Wyszukiwanie tekstowe wiadomości rozmowy](/docs/pl/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Dodano opcjonalne parametry zapytania tablic `exclude_statuses` i `termination_reasons`

### Speech to Text

- [Zamień mowę na tekst](/docs/pl/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - Dodano opcjonalny parametr zapytania `token` (string) dla jednorazowego tokenu wsadowego Scribe

### Text to Speech

- [Lista słowników wymowy](/docs/pl/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
  - Dodano opcjonalny parametr zapytania `include_archived` (boolean, domyślnie `true`)

### Obszary robocze

- [Aktualizuj webhook obszaru roboczego](/docs/pl/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
  - Dodano opcjonalne pole żądania `events` (`WorkspaceWebhookEventType[]`)
- [Pobierz użycie obszaru roboczego](/docs/pl/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
  - Dodano `surface` i `actor` do opcjonalnej tablicy `group_by`
- [Zaktualizuj klucz API konta serwisowego](/docs/pl/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
  - Dodano `"clear"` do opcjonalnego pola `character_limit`

## Zmiany w schematach

### ElevenAgents

- Schematy odpowiedzi bazy wiedzy ElevenAgents dodają opcjonalne `content_format` (`html` | `markdown`, domyślnie `html`)
- Odpowiedzi plików bazy wiedzy dodają opcjonalne `auto_sync_info` i `refresh_status` (`FileRefreshStatus`)
- Odpowiedzi folderów bazy wiedzy dodają wymagane `document_count` (integer)
- Schematy nadpisywania TTS agenta dodają opcjonalne `model_id` (`TTSConversationalModel`)
- `enable_phoneme_tags` TTS agenta ma teraz domyślnie `true` zamiast `false`
- `cascade_timeout_seconds` zapasowego LLM ma teraz domyślnie 4 zamiast 8 sekund
- Konfiguracja LLM agenta dodaje `gpt-5.6-sol`, `gpt-5.6-terra` i `gpt-5.6-luna`; `LLMReasoningEffort` dodaje `max`
- Niestandardowe guardraile dodają opcjonalne `evaluate_full_response_only` (boolean, domyślnie `false`)
- Konfiguracja połączeń telefonicznych dodaje opcjonalne `twilio_call_recording_enabled` (boolean, domyślnie `false`)
- Parametry narzędzi typu obiekt dodają `dynamic_variable`, `constant_value` i `is_omitted`; stałe nadpisania akceptują dowolne wartości tablic i obiektów
- Konfiguracja tekstów widżetu dodaje opcjonalne etykiety przesyłania plików i wskaźnika pisania
- Schematy kont WhatsApp dodają opcjonalne `enable_typing_indicator` (boolean)
- Schematy symulacji i testowania dodają `AutoGenerationMetadata` i `SimulationLibrarySettings`

### Muzyka

- Dodano schematy żądań, odpowiedzi, paginacji, widoczności, twórcy, statusu i przyczyny błędu Music Finetune
- Wszystkie schematy żądań generowania muzyki udostępniają `finetune_id` generowanym SDK

### Obszary robocze

- Schematy żądań i odpowiedzi webhooków obszaru roboczego dodają opcjonalne `events` (`WorkspaceWebhookEventType[]`)
- Schematy powiadamiacza webhooków alertów używają wymaganego `webhook_id` (string) zamiast `url`, `method` i `headers`

</Accordion>