Hoppa till navigering

ElevenAPI-snabbstart

Lär dig göra din första API-begäran till ElevenLabs.

När du har gått igenom den här guiden har du konfigurerat ElevenLabs i ditt projekt och kan göra din första begäran om text till tal. Det finns två sätt att komma dit: låt din kodagent göra konfigurationen eller gör den själv.

Guider för andra funktioner – streaming, Voice Cloning, tal-till-text – finns i avsnittet Självstudier.

Konfigurera med din kodagent

Du behöver inget konto eller någon API-nyckel innan du börjar. Klistra in det här i din kodagent:

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

ElevenLabs CLI tar hand om resten och berättar för din agent vad som ska göras i varje steg. Webbläsaren öppnas en gång så att du kan logga in eller skapa ett konto och klicka på Authorize. Nyckeln sparas i projektets miljöfil (.env.local, eller .env i ett Python-projekt) och hålls borta från git; den visas aldrig i chatten. Agenten frågar sedan vad du vill bygga, installerar SDK:t, lägger till koden i din app och frågar om en testbegäran ska skickas.

Om din agent körs någonstans som din webbläsare inte kan nå, till exempel på en fjärrdator via SSH eller i en molnsandlåda, ber CLI:t dig att skapa en nyckel själv och klistra in den i miljöfilen, innan det fortsätter. Kommandot kräver Node.js för npx. Utan det kan du installera ElevenLabs CLI med Homebrew (macOS och Linux) eller Scoop (Windows), eller uppdatera det om du redan har det (brew upgrade elevenlabs, scoop update elevenlabs), och be din agent att köra elevenlabs onboard init i stället.

Konfigurera manuellt

1

Skapa en API-nyckel

Skapa en API-nyckel i dashboarden här, som du använder för att säkert få åtkomst till API:t.

Spara nyckeln som en hanterad hemlighet och skicka den till SDK:erna antingen som en miljövariabel via en .env-fil eller direkt i appens konfiguration, beroende på vad du föredrar.

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

Installera SDK:t

Vi använder också biblioteket dotenv för att läsa in vår API-nyckel från en miljövariabel.

pip install elevenlabs
pip install python-dotenv

För att spela upp ljudet via dina högtalare kan du bli ombedd att installera MPV och/eller ffmpeg.

3

Gör din första begäran

Skapa en ny fil med namnet example.py eller example.mts, beroende på vilket språk du väljer, och lägg till följande 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)

Kör den sedan:

python example.py

Du bör höra ljudet spelas upp via dina högtalare.

Nästa steg