Przejdź do nawigacji

Szybki start z ElevenAPI

Dowiedz się, jak wysłać pierwsze żądanie do API ElevenLabs.

Po tym przewodniku skonfigurujesz ElevenLabs w swoim projekcie i wyślesz pierwsze żądanie zamiany tekstu na mowę. Możesz to zrobić na dwa sposoby: zlecić konfigurację agentowi programistycznemu lub zrobić ją ręcznie.

Przewodniki o innych możliwościach — streamingu, klonowaniu głosu i zamianie mowy na tekst — znajdziesz w sekcji Tutoriale.

Skonfiguruj z agentem programistycznym

Przed rozpoczęciem nie potrzebujesz konta ani klucza API. Wklej to do swojego agenta programistycznego:

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

CLI ElevenLabs zajmie się resztą i poda agentowi kolejne kroki. Przeglądarka otworzy się raz, abyś mógł się zalogować lub utworzyć konto i kliknąć Autoryzuj. Klucz zostanie zapisany w pliku env projektu (.env.local lub .env w projekcie Python) i wykluczony z gita; nigdy nie pojawi się na czacie. Następnie agent zapyta, co chcesz stworzyć, zainstaluje SDK, doda kod do aplikacji i zapyta, czy wysłać żądanie testowe.

Jeśli agent działa w miejscu, do którego nie ma dostępu twoja przeglądarka, np. na zdalnej maszynie przez SSH lub w sandboxie w chmurze, CLI poprosi cię o samodzielne utworzenie klucza i wklejenie go do pliku env, po czym będzie kontynuować. Polecenie wymaga Node.js do npx. Jeśli go nie masz, zainstaluj CLI ElevenLabs przez Homebrew (macOS i Linux) lub Scoop (Windows), albo zaktualizuj je, jeśli masz je już zainstalowane (brew upgrade elevenlabs, scoop update elevenlabs), i poproś agenta o uruchomienie elevenlabs onboard init.

Skonfiguruj ręcznie

1

Utwórz klucz API

Utwórz klucz API w panelu tutaj, którego użyjesz, aby bezpiecznie uzyskać dostęp do API.

Przechowuj klucz jako zarządzany sekret i przekaż go do SDK jako zmienną środowiskową w pliku .env lub bezpośrednio w konfiguracji aplikacji — zależnie od preferencji.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Zainstaluj SDK

Użyjemy też biblioteki dotenv, aby wczytać klucz API ze zmiennej środowiskowej.

pip install elevenlabs
pip install python-dotenv

Aby odtwarzać audio przez głośniki, może pojawić się prośba o zainstalowanie MPV i/lub ffmpeg.

3

Wyślij pierwsze żądanie

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

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
text="The first move is what sets everything in motion.",
voice_id="JBFqnCBsd6RMkjVDRZzb", # "George" - browse voices at elevenlabs.io/app/voice-library
model_id="eleven_v4",
output_format="mp3_44100_128",
)
play(audio)

Następnie go uruchom:

python example.py

Audio powinno odtworzyć się przez głośniki.

Kolejne kroki