About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/elevenlabs-install-auth/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill elevenlabs-install-auth. Copyright stays with the author (MIT).

ElevenLabs Install & Auth

Name: elevenlabs-install-auth
Author: jeremylongshore

Overview

Set up the ElevenLabs SDK and configure API key authentication. ElevenLabs uses a single API key (xi-api-key header) for all endpoints at api.elevenlabs.io.

Prerequisites

Node.js 18+ or Python 3.10+
ElevenLabs account (free tier works) at https://elevenlabs.io
API key from Profile > API Keys in the ElevenLabs dashboard

Instructions

Step 1: Install the SDK

Node.js (official package: @elevenlabs/elevenlabs-js):

npm install @elevenlabs/elevenlabs-js
# or
pnpm add @elevenlabs/elevenlabs-js

Python (official package: elevenlabs):

pip install elevenlabs

Step 2: Configure API Key

# Set environment variable (all SDKs auto-detect this)
export ELEVENLABS_API_KEY="sk_your_key_here"

# Or create .env file
echo 'ELEVENLABS_API_KEY=sk_your_key_here' >> .env

Add to .gitignore:

.env
.env.local
.env.*.local

Step 3: Initialize the Client

Both SDKs auto-detect ELEVENLABS_API_KEY. Minimal TypeScript skeleton:

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const client = new ElevenLabsClient({
  apiKey: process.env.ELEVENLABS_API_KEY,
});

The Python client mirrors this with ElevenLabsClient(api_key=...). For retry, timeout, and the full Python skeleton, see implementation.md.

Step 4: Verify Connection

Confirm auth by listing voices — a successful call proves the key is valid and not over quota:

const voices = await client.voices.getAll();
console.log(`Connected. ${voices.voices.length} voices available.`);

Full TypeScript + Python + cURL verification (including subscription/quota inspection) is in implementation.md.

Output

SDK installed in node_modules or site-packages
API key stored in .env (git-ignored)
Successful voice listing confirms authentication
Subscription tier and character quota displayed

Error Handling

Error	HTTP	Cause	Solution
`invalid_api_key`	401	Key missing, expired, or malformed	Regenerate at elevenlabs.io > Profile > API Keys
`ENOTFOUND api.elevenlabs.io`	N/A	DNS/network failure	Check internet; ensure outbound HTTPS on port 443
`MODULE_NOT_FOUND`	N/A	SDK not installed	Run `npm install @elevenlabs/elevenlabs-js`
`quota_exceeded`	401	Character limit reached for billing period	Upgrade plan or wait for reset

Examples

Two full setup walkthroughs (Node.js and Python) plus a no-SDK CI smoke test live in examples.md. The shortest complete path for a new Node.js project:

npm install @elevenlabs/elevenlabs-js
echo 'ELEVENLABS_API_KEY=sk_your_key_here' >> .env
printf '.env\n' >> .gitignore

import "dotenv/config";
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const client = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY });
const voices = await client.voices.getAll();
console.log(`Connected. ${voices.voices.length} voices available.`);

See examples.md for the Python equivalent and the curl-only pipeline gate.

API Key Best Practices

Never hardcode keys in source files
Use separate keys for dev/staging/prod
Rotate keys quarterly via the dashboard
Free tier: 10,000 characters/month, Starter: 30,000, Creator: 100,000

Full best-practices notes are in implementation.md.

Resources

Next Steps

After auth is confirmed, proceed to the elevenlabs-hello-world skill for your first text-to-speech generation, then explore voice listing and streaming in the rest of the ElevenLabs pack.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-elevenlabs-in-010964/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-elevenlabs-in-010964.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-elevenlabs-in-010964",
  "kind": "skill",
  "name": "elevenlabs-install-auth",
  "description": "Install and configure ElevenLabs SDK authentication for Node.js or Python. Use when setting up a new ElevenLabs project, configuring API keys, or initializing the elevenlabs npm/pip package. Trigger with \"install elevenlabs\", \"setup elevenlabs\", \"elevenlabs auth\", \"configure elevenlabs API key\", \"elevenlabs credentials\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "saas",
      "voice",
      "ai",
      "elevenlabs",
      "tts",
      "audio",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Install and configure ElevenLabs SDK authentication for Node.js or Python. Use when setting up a new ElevenLabs project, configuring API keys, or initializing the elevenlabs npm/pip package. Trigger with \"install elevenlabs\", \"setup elevenlabs\", \"elevenlabs auth\", \"configure elevenlabs API key\", \"elevenlabs credentials\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/elevenlabs-install-auth/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/elevenlabs-install-auth/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/elevenlabs-install-auth/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Write,",
      "Bash(npm:*),",
      "Bash(pip:*),",
      "Bash(pnpm:*)"
    ],
    "license": "MIT"
  },
  "instructions": "# ElevenLabs Install & Auth\n\n## Overview\n\nSet up the ElevenLabs SDK and configure API key authentication. ElevenLabs uses a single API key (`xi-api-key` header) for all endpoints at `api.elevenlabs.io`.\n\n## Prerequisites\n\n- Node.js 18+ or Python 3.10+\n- ElevenLabs account (free tier works) at https://elevenlabs.io\n- API key from Profile > API Keys in the ElevenLabs dashboard\n\n## Instructions\n\n### Step 1: Install the SDK\n\n**Node.js** (official package: `@elevenlabs/elevenlabs-js`):\n\n```bash\nnpm install @elevenlabs/elevenlabs-js\n# or\npnpm add @elevenlabs/elevenlabs-js\n```\n\n**Python** (official p",
  "cost": {
    "context_tokens": 1017
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-elevenlabs-in-010964/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.