Przejdź do nawigacji

Łączenie wielu żądań

Z tego przewodnika dowiesz się, jak zachować prozodię głosu w wielu fragmentach tekstu/generacjach.

Przewodnik · Zakłada, że masz za sobą szybki start z ElevenAPI .

Podczas zamiany dużej ilości tekstu na audio możesz zauważyć nagłe zmiany prozodii między fragmentami. Jest to szczególnie wyraźne przy zamianie tekstu obejmującego wiele akapitów lub sekcji. Aby zachować prozodię głosu w wielu fragmentach, możesz użyć funkcji Request Stitching.

Ta funkcja pozwala przekazać kontekst tego, co zostało już wygenerowane i co zostanie wygenerowane później, pomagając zachować spójny głos i prozodię w całym tekście.

Łączenie żądań nie jest dostępne dla modelu eleven_v3.

Oto przykład bez Request Stitching:

Ten sam przykład z Request Stitching:

Jak używać Request Stitching

Z Request Stitching najłatwiej skorzystać za pomocą SDK ElevenLabs.

Ten przewodnik zakłada, że skonfigurowałeś klucz API i SDK. Jeśli jeszcze tego nie zrobiłeś, najpierw ukończ szybki start.

1

Połącz wiele żądań

Utwórz nowy plik o nazwie example.py lub example.mts, zależnie od wybranego języka, i dodaj poniższy kod:

W previous_request_ids możesz podać maksymalnie 3 identyfikatory żądań. Większa liczba zwróci błąd 400. Przekaż 3 najnowsze identyfikatory, a żądanie najbliższe obecnemu umieść na końcu.

import os
from io import BytesIO
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
from dotenv import load_dotenv
load_dotenv()
ELEVENLABS_API_KEY = os.getenv("ELEVENLABS_API_KEY")
elevenlabs = ElevenLabs(
api_key=ELEVENLABS_API_KEY,
)
paragraphs = [
"The advent of technology has transformed countless sectors, with education ",
"standing out as one of the most significantly impacted fields.",
"In recent years, educational technology, or EdTech, has revolutionized the way ",
"teachers deliver instruction and students absorb information.",
"From interactive whiteboards to individual tablets loaded with educational software, ",
"technology has opened up new avenues for learning that were previously unimaginable.",
"One of the primary benefits of technology in education is the accessibility it provides.",
]
request_ids = []
audio_buffers = []
for paragraph in paragraphs:
# Usually we get back a stream from the convert function, but with_raw_response is
# used to get the headers from the response
with elevenlabs.text_to_speech.with_raw_response.convert(
text=paragraph,
voice_id="T7QGPtToiqH4S8VlIkMJ",
model_id="eleven_v4",
# The API accepts at most 3 previous request IDs
previous_request_ids=request_ids[-3:]
) as response:
request_ids.append(response._response.headers.get("request-id"))
# response._response.headers also contains useful information like 'character-cost',
# which shows the cost of the generation in characters.
audio_data = b''.join(chunk for chunk in response.data)
audio_buffers.append(BytesIO(audio_data))
combined_stream = BytesIO(b''.join(buffer.getvalue() for buffer in audio_buffers))
play(combined_stream)
2

Uruchom kod

python example.py

Powinieneś usłyszeć połączone audio.

FAQ

Aby użyć identyfikatorów poprzedniego żądania jako kontekstu, musi ono zostać w pełni przetworzone. W przypadku streamingu oznacza to, że audio musi zostać w całości odczytane z treści odpowiedzi.

Różnica zależy od użytego modelu, głosu i ustawień głosu.

Identyfikatory żądań nie powinny być starsze niż dwie godziny.

Tak, chyba że jesteś użytkownikiem Enterprise z podwyższonymi wymaganiami dotyczącymi prywatności.

Kolejne kroki