elevenlabs-prod-checklist

name	elevenlabs-prod-checklist
description	Execute ElevenLabs production deployment checklist with health checks and rollback. Use when deploying TTS/voice integrations to production, preparing for launch, or implementing go-live procedures for ElevenLabs-powered apps. Trigger: "elevenlabs production", "deploy elevenlabs", "elevenlabs go-live", "elevenlabs launch checklist", "production TTS".
allowed-tools	Read, Bash(curl:*), Bash(node:*), Grep
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","voice","ai","elevenlabs","production","deployment"]
compatible-with	claude-code

ElevenLabs Production Checklist

Overview

Complete checklist for deploying ElevenLabs TTS/voice integrations to production. Covers API configuration, health checks, circuit breakers, monitoring, and rollback procedures.

Prerequisites

• Staging environment tested and verified
• Production API key (separate from dev/staging)
• Monitoring and alerting infrastructure ready

Instructions

Step 1: Pre-Deployment Verification

Configuration:

• Production API key stored in secure vault (not in code)
• ELEVENLABS_API_KEY set in deployment platform's secrets
• Webhook secret configured (if using webhooks)
• Using production model ID (eleven_multilingual_v2 or eleven_v3)

Code Quality:

• All tests passing with mocked ElevenLabs SDK
• No hardcoded API keys (scan with grep -r "sk_" src/)
• Error handling covers 400, 401, 404, 429, 5xx responses
• Rate limiting implemented matching plan concurrency limit
• Text splitting handles inputs > 5,000 characters
• Audio output format appropriate for use case

Quota Planning:

• Estimated monthly character usage fits within plan limit
• Usage-based billing enabled (Creator+ plans) if needed
• Flash/Turbo models used where latency matters more than quality

Step 2: Health Check Endpoint

// src/api/health.ts
import { ElevenLabsClient } from ;

  {
  :  |  | ;
  : {
    : ;
    : ;
    :  | ;
    :  | ;
  };
  : ;
}

   (): <> {
   client =  ();
   start = .();

   {
     user =  client..();
     latency = .() - start;
     { character_count, character_limit } = user.;
     remaining = character_limit - character_count;
     pctUsed = .((character_count / character_limit) * );

     {
      : pctUsed >  ?  : ,
      : {
        : ,
        : latency,
        : remaining,
        : pctUsed,
      },
      :  ().(),
    };
  }  (error) {
     {
      : ,
      : {
        : ,
        : .() - start,
        : ,
        : ,
      },
      :  ().(),
    };
  }
}