Setting the file. One moment.
Subchapter 2.2
references/installation.mdMarkdown3 KBView on GitHub
The Dubbing Projects API is available via the elevenlabs CLI under elevenlabs dubbing project, in the official SDKs under dubbing.project.*, and via REST at /v1/dubbing/project. The older client.dubbing.* methods (create, get, audio.get) are the legacy v1 dubbing API — do not use them for new work.
npm (any platform with Node.js):
npm install -g @elevenlabs/climacOS / Linux (Homebrew):
brew install elevenlabs/tap/elevenlabsWindows (Scoop):
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabsShell installer:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | shAuthenticate with an API key (picked up automatically from the environment):
export ELEVENLABS_API_KEY="your-api-key"Or log in via OAuth, which stores credentials in the OS keyring:
elevenlabs auth loginVerify it works:
elevenlabs dubbing project listpip install --upgrade elevenlabs requests(requests is used to download the dubbed audio from the signed output URL.)
import os
from elevenlabs.client import ElevenLabs
# Reads ELEVENLABS_API_KEY from the environment
elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
page = elevenlabs.dubbing.project.list(page_size=20)npm install @elevenlabs/elevenlabs-js@latestImportant: Always use
@elevenlabs/elevenlabs-js. The oldelevenlabsnpm package (v1.x) is deprecated and should not be used.
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
// Reads ELEVENLABS_API_KEY from the environment
const elevenlabs = new ElevenLabsClient();
const page = await elevenlabs.dubbing.project.list({ pageSize: 20 });The REST base URL is https://api.elevenlabs.io, with your API key in the xi-api-key header on every request. For command-line use, prefer the CLI — it wraps the same endpoints and reads ELEVENLABS_API_KEY automatically:
elevenlabs dubbing project create --file promo.mp4 --source-language enOr use the setup-api-key skill for guided setup.
| Variable | Description |
|---|---|
ELEVENLABS_API_KEY | Your ElevenLabs API key (required) |