elevenlabs_client 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b65be08b17b9ae232158f2c004511a7840688e76853c014f9be37984a9639d1
-  data.tar.gz: 2de88d74e59af044cfe943e32f0d2f2d8b45f71200469a69b3f95fc7605436d2
+  metadata.gz: 1ac0295ca5dadf36f14152af7d6c2f4fa39dd7a2c8b59837551fc3bd8839d419
+  data.tar.gz: dabd65a40bb17aa262f2251f125d8edadaccde957b4fe9084b91384f59b54ee5
 SHA512:
-  metadata.gz: f919ebdf7090d2f4cdd812589eccd1425e8be5e86615c04f3bf2882c7e8e8e07058db4f37cdf420e6b1948c668c3acbb177fe796b48c7f23563fa41a7204f4ce
-  data.tar.gz: 23b7dc77bb3ca90e2019d4098887b8555d103d66c1fdf259f883f7952b4c26f57671f9bd2e250e27491acc42c2518e85b37bcb48cdb678fd163f9b3be9b1d7e4
+  metadata.gz: ceb86051b205481e427aec671deeb55fbeaff5f68bf99fe7257e34ce926cd83b7ec7644d5daf4854dc67ff6ece921c23ba99e6301063beb1116084f6820de4be
+  data.tar.gz: e6ab2b8907aa8b02e4ba222a407d5aa3c67e0e86b303421b073f0ed7744a9a9712510d88f75247cd534ddc1c67ccfb8ed5c0d411cee9cd3632288cf35d544036

data/CHANGELOG.md

@@ -5,6 +5,146 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.6.0] - 2024-09-15
+
+### Added
+- **🏢 Admin API Suite** - Complete administrative functionality for account management
+  - **User Management** (`client.user.*`) - Access comprehensive user account information, subscription details, and feature availability
+  - **Usage Analytics** (`client.usage.*`) - Monitor character usage with detailed analytics, breakdowns by voice/model/source, and trend analysis
+  - **Voice Library** (`client.voice_library.*`) - Browse and manage community shared voices with advanced filtering and search capabilities
+  - All admin endpoints include comprehensive error handling and response validation
+
+### Enhanced
+- **📚 Documentation Expansion** - Comprehensive documentation for all admin functionality
+  - Added `docs/admin/USER.md` - User account and subscription management guide (589 lines)
+  - Added `docs/admin/USAGE.md` - Usage analytics and monitoring guide (604 lines)
+  - Added `docs/admin/VOICE_LIBRARY.md` - Voice library browsing and management guide (883 lines)
+  - Added `docs/admin/README.md` - Admin API overview and quick start guide (472 lines)
+  - Updated main README.md with admin endpoint documentation and examples
+  - Total: 3,512 lines of new admin documentation
+
+- **🎯 Example Controllers** - Production-ready Rails integration examples
+  - Added `examples/admin/user_controller.rb` - User dashboard with health monitoring (767 lines)
+  - Added `examples/admin/usage_controller.rb` - Usage analytics dashboard with real-time monitoring (584 lines)
+  - Added `examples/admin/voice_library_controller.rb` - Voice library browser with curation tools (844 lines)
+  - Added `examples/admin/models_controller.rb` - Model comparison and selection guide (983 lines)
+  - All controllers include comprehensive error handling, JSON API support, and export functionality
+
+### Improved
+- **🧪 Test Coverage** - Comprehensive testing for all admin functionality
+  - Added 88 endpoint tests covering all admin API methods and error scenarios
+  - Added 77 integration tests covering real-world usage patterns and workflows
+  - All tests include proper error handling validation and response structure verification
+  - Total: 165 new tests with 100% pass rate
+
+- **🔧 Client Integration** - Seamless integration of admin endpoints
+  - Updated `Client` class to expose all admin endpoints (`usage`, `user`, `voice_library`)
+  - Enhanced error handling for admin-specific scenarios
+  - Consistent API patterns across all admin endpoints
+  - Proper namespacing under `ElevenlabsClient::Admin` module
+
+### Technical Improvements
+- **📊 Advanced Analytics** - Sophisticated usage monitoring and insights
+  - Character usage breakdowns by voice, model, user, and source
+  - Time-based aggregation (hour, day, week, month, cumulative)
+  - Trend analysis and forecasting capabilities
+  - Cost estimation and optimization recommendations
+
+- **🎤 Voice Discovery** - Powerful voice library management
+  - Advanced filtering by category, gender, age, accent, language, and use case
+  - Voice recommendation engine based on requirements
+  - Bulk voice addition and collection curation tools
+  - Voice analytics and popularity tracking
+
+- **👤 Account Management** - Comprehensive user account oversight
+  - Real-time subscription monitoring and health checks
+  - Usage limit tracking with projections and alerts
+  - Feature availability matrix and upgrade recommendations
+  - Security and moderation status monitoring
+
+### Changed
+- **🔄 Code Organization** - Moved TextToDialogue class to its own file
+  - Extracted `TextToDialogue` class from `text_to_speech.rb` to `text_to_dialogue.rb`
+  - Improved code organization and modularity
+  - All tests and functionality remain unchanged
+  - Added Speech-to-Text delete transcript endpoint (`delete_transcript`)
+
+## [0.5.1] - 2024-09-15
+
+### Removed
+- **🧹 Dependency Optimization** - Removed unnecessary development dependencies
+  - Removed `rubocop` and `rubocop-rspec` dependencies
+  - Removed `brakeman` dependency (not suitable for gem libraries)
+  - Removed `.rubocop.yml` and `.brakeman.yml` configuration files
+  - Reduced bundle size from 49 to 31 gems (37% reduction)
+
+### Changed
+- **⚡ CI/CD Optimization** - Simplified and streamlined continuous integration
+  - Removed linting job from GitHub Actions workflow
+  - Focused CI pipeline on essential checks: tests, security, and build
+  - Updated CI to use only `bundler-audit` for dependency vulnerability scanning
+  - Faster CI builds with fewer dependencies and simpler workflow
+
+### Updated
+- **📚 Documentation Cleanup** - Updated documentation to reflect simplified toolchain
+  - Removed RuboCop references from README.md
+  - Updated CI/CD documentation section
+  - Simplified development workflow documentation
+  - Updated Rake task descriptions and help text
+- **🔧 Development Tools** - Streamlined development workflow
+  - Removed lint-related Rake tasks (`dev:lint`, `dev:lint_fix`, `dev:brakeman`)
+  - Simplified `release:prepare` task to focus on tests and security
+  - Updated help documentation for available Rake tasks
+
+### Technical Improvements
+- **📦 Leaner Dependencies** - More focused dependency management
+  - Kept only essential development tools: RSpec, WebMock, bundler-audit
+  - Maintained security scanning through bundler-audit
+  - Improved bundle install speed and reduced maintenance overhead
+- **🚀 Performance** - Faster development and CI workflows
+  - Reduced Docker image sizes for CI/CD
+  - Faster bundle installations
+  - Simplified toolchain reduces cognitive overhead
+
+### Notes
+- This release focuses on optimizing the development experience and CI/CD pipeline
+- Security scanning is maintained through bundler-audit, which is more appropriate for gem libraries
+- The simplified toolchain reduces maintenance overhead while maintaining code quality through comprehensive testing
+
+## [0.5.0] - 2025-09-14
+
+### Added
+
+- Text-to-Speech With Timestamps
+  - `client.text_to_speech_with_timestamps.generate(voice_id, text, **options)`
+  - Character-level `alignment` and `normalized_alignment`
+- Streaming Text-to-Speech With Timestamps
+  - `client.text_to_speech_stream_with_timestamps.stream(voice_id, text, **options, &block)`
+  - JSON streaming with audio chunks and timing per chunk
+- WebSocket Streaming Enhancements
+  - Single-context and multi-context improvements; correct query param ordering and filtering
+  - Docs: `docs/WEBSOCKET_STREAMING.md`
+- Text-to-Dialogue Streaming
+  - `client.text_to_dialogue_stream.stream(inputs, **options, &block)`
+  - Docs: `docs/TEXT_TO_DIALOGUE_STREAMING.md`
+
+### Improved
+
+- Client streaming JSON handling for timestamp streams (`post_streaming_with_timestamps`)
+- Robust parsing and block yielding across streaming tests
+- URL query parameter ordering to match expectations in tests
+
+### Tests
+
+- Added comprehensive unit and integration tests for all new endpoints
+- Full suite now: 687 examples, 0 failures
+
+### Notes
+
+- These features require valid ElevenLabs API keys and correct model/voice permissions
+
 ## [0.4.0] - 2025-09-12
 
 ### Added

data/README.md

@@ -2,7 +2,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/elevenlabs_client.svg)](https://badge.fury.io/rb/elevenlabs_client)
 
-A comprehensive Ruby client library for the ElevenLabs API, supporting voice synthesis, dubbing, dialogue generation, sound effects, and AI music composition.
+A comprehensive Ruby client library for the ElevenLabs API, supporting voice synthesis, dubbing, dialogue generation, sound effects, AI music composition, voice transformation, speech transcription, audio isolation, and advanced audio processing features.
 
 ## Features
 
@@ -13,7 +13,17 @@ A comprehensive Ruby client library for the ElevenLabs API, supporting voice syn
 🎵 **Music Generation** - AI-powered music composition and streaming  
 🎨 **Voice Design** - Create custom voices from text descriptions  
 🎭 **Voice Management** - Create, edit, and manage individual voices  
-🤖 **Models** - List available models and their capabilities  
+🔄 **Speech-to-Speech** - Transform audio from one voice to another (Voice Changer)  
+📝 **Speech-to-Text** - Transcribe audio and video files with advanced features  
+🔇 **Audio Isolation** - Remove background noise from audio files  
+📱 **Audio Native** - Create embeddable audio players for websites  
+⏱️ **Forced Alignment** - Get precise timing information for audio transcripts  
+📊 **Admin APIs** - Complete administrative functionality:
+  - **History** - Manage and analyze your generated audio history
+  - **Usage** - Monitor character usage and analytics  
+  - **User** - Access account information and subscription details
+  - **Voice Library** - Browse and manage community shared voices
+  - **Models** - List available models and their capabilities  
 📡 **Streaming** - Real-time audio streaming  
 ⚙️ **Configurable** - Flexible configuration options  
 🧪 **Well-tested** - Comprehensive test coverage  
@@ -113,6 +123,11 @@ audio_data = client.sound_generation.generate("Ocean waves crashing on rocks")
 design_result = client.text_to_voice.design("Warm, professional female voice")
 generated_voice_id = design_result["previews"].first["generated_voice_id"]
 
+# Stream the voice preview
+client.text_to_voice.stream_preview(generated_voice_id) do |chunk|
+  puts "Received preview chunk: #{chunk.bytesize} bytes"
+end
+
 voice_result = client.text_to_voice.create(
   "Professional Voice",
   "Warm, professional female voice",
@@ -134,6 +149,27 @@ File.open("sample1.mp3", "rb") do |sample|
   puts "Created voice: #{voice['voice_id']}"
 end
 
+# Admin APIs - Account Management
+user_info = client.user.get_user
+puts "Account: #{user_info['subscription']['tier']} (#{user_info['subscription']['status']})"
+puts "Usage: #{user_info['subscription']['character_count']} / #{user_info['subscription']['character_limit']}"
+
+# Usage Analytics
+usage_stats = client.usage.get_character_stats(
+  start_unix: (Time.now - 7.days).to_i * 1000,
+  end_unix: Time.now.to_i * 1000,
+  breakdown_type: "voice"
+)
+puts "7-day usage: #{usage_stats['usage']['All'].sum} characters"
+
+# History Management
+history = client.history.list(page_size: 10)
+puts "Recent history: #{history['history'].length} items"
+
+# Voice Library
+voices = client.voice_library.get_shared_voices(category: "professional", page_size: 5)
+puts "Professional voices available: #{voices['voices'].length}"
+
 # Music Generation
 music_data = client.music.compose(
   prompt: "Upbeat electronic dance track with synthesizers",
@@ -141,6 +177,66 @@ music_data = client.music.compose(
 )
 File.open("generated_music.mp3", "wb") { |f| f.write(music_data) }
 
+# Speech-to-Speech (Voice Changer)
+File.open("input_audio.mp3", "rb") do |audio_file|
+  converted_audio = client.speech_to_speech.convert(
+    "target_voice_id", 
+    audio_file, 
+    "input_audio.mp3",
+    remove_background_noise: true
+  )
+  File.open("converted_audio.mp3", "wb") { |f| f.write(converted_audio) }
+end
+
+# Speech-to-Text Transcription
+File.open("audio.mp3", "rb") do |audio_file|
+  transcription = client.speech_to_text.create(
+    "scribe_v1",
+    file: audio_file,
+    filename: "audio.mp3",
+    diarize: true,
+    timestamps_granularity: "word"
+  )
+  puts "Transcribed: #{transcription['text']}"
+  
+  # Get the transcript later
+  transcript = client.speech_to_text.get_transcript(transcription['transcription_id'])
+  
+  # Delete when no longer needed
+  client.speech_to_text.delete_transcript(transcription['transcription_id'])
+end
+
+# Audio Isolation (Background Noise Removal)
+File.open("noisy_audio.mp3", "rb") do |audio_file|
+  clean_audio = client.audio_isolation.isolate(audio_file, "noisy_audio.mp3")
+  File.open("clean_audio.mp3", "wb") { |f| f.write(clean_audio) }
+end
+
+# Audio Native (Embeddable Player)
+File.open("article.html", "rb") do |html_file|
+  project = client.audio_native.create(
+    "My Article",
+    file: html_file,
+    filename: "article.html",
+    voice_id: "voice_id",
+    auto_convert: true
+  )
+  puts "Player HTML: #{project['html_snippet']}"
+end
+
+# Forced Alignment
+File.open("speech.wav", "rb") do |audio_file|
+  alignment = client.forced_alignment.create(
+    audio_file,
+    "speech.wav",
+    "Hello world, this is a test transcript"
+  )
+  
+  alignment['words'].each do |word|
+    puts "#{word['text']}: #{word['start']}s - #{word['end']}s"
+  end
+end
+
 # Streaming Text-to-Speech
 client.text_to_speech_stream.stream("voice_id", "Streaming text") do |chunk|
   # Process audio chunk in real-time
@@ -160,7 +256,17 @@ end
 - **[Music Generation API](docs/MUSIC.md)** - AI-powered music composition and streaming
 - **[Text-to-Voice API](docs/TEXT_TO_VOICE.md)** - Design and create custom voices
 - **[Voice Management API](docs/VOICES.md)** - Manage individual voices (CRUD operations)
-- **[Models API](docs/MODELS.md)** - List available models and capabilities
+- **[Speech-to-Speech API](docs/SPEECH_TO_SPEECH.md)** - Transform audio from one voice to another
+- **[Speech-to-Text API](docs/SPEECH_TO_TEXT.md)** - Transcribe audio and video files
+- **[Audio Isolation API](docs/AUDIO_ISOLATION.md)** - Remove background noise from audio
+- **[Audio Native API](docs/AUDIO_NATIVE.md)** - Create embeddable audio players
+- **[Forced Alignment API](docs/FORCED_ALIGNMENT.md)** - Get precise timing information
+- **[Admin APIs](docs/admin/README.md)** - Complete administrative functionality:
+  - **[User Management](docs/admin/USER.md)** - Account information and subscription details
+  - **[Usage Analytics](docs/admin/USAGE.md)** - Character usage monitoring and analytics
+  - **[History Management](docs/admin/HISTORY.md)** - Generated audio history management
+  - **[Voice Library](docs/admin/VOICE_LIBRARY.md)** - Community voice browsing and management
+  - **[Models API](docs/admin/MODELS.md)** - List available models and capabilities
 
 ### Available Endpoints
 
@@ -174,7 +280,16 @@ end
 | `client.music.*` | AI music composition and streaming | [MUSIC.md](docs/MUSIC.md) |
 | `client.text_to_voice.*` | Voice design and creation | [TEXT_TO_VOICE.md](docs/TEXT_TO_VOICE.md) |
 | `client.voices.*` | Voice management (CRUD) | [VOICES.md](docs/VOICES.md) |
-| `client.models.*` | Model information and capabilities | [MODELS.md](docs/MODELS.md) |
+| `client.speech_to_speech.*` | Voice changer and audio transformation | [SPEECH_TO_SPEECH.md](docs/SPEECH_TO_SPEECH.md) |
+| `client.speech_to_text.*` | Audio/video transcription | [SPEECH_TO_TEXT.md](docs/SPEECH_TO_TEXT.md) |
+| `client.audio_isolation.*` | Background noise removal | [AUDIO_ISOLATION.md](docs/AUDIO_ISOLATION.md) |
+| `client.audio_native.*` | Embeddable audio players | [AUDIO_NATIVE.md](docs/AUDIO_NATIVE.md) |
+| `client.forced_alignment.*` | Audio-text timing alignment | [FORCED_ALIGNMENT.md](docs/FORCED_ALIGNMENT.md) |
+| `client.user.*` | User account and subscription information | [USER.md](docs/admin/USER.md) |
+| `client.usage.*` | Character usage analytics and monitoring | [USAGE.md](docs/admin/USAGE.md) |
+| `client.history.*` | Generated audio history management | [HISTORY.md](docs/admin/HISTORY.md) |
+| `client.voice_library.*` | Community voice browsing and management | [VOICE_LIBRARY.md](docs/admin/VOICE_LIBRARY.md) |
+| `client.models.*` | Model information and capabilities | [MODELS.md](docs/admin/MODELS.md) |
 
 ## Configuration Options
 
@@ -221,6 +336,9 @@ end
 - `AuthenticationError` - Invalid API key or authentication failure
 - `RateLimitError` - Rate limit exceeded
 - `ValidationError` - Invalid request parameters
+- `NotFoundError` - Resource not found (e.g., voice ID, transcript ID)
+- `BadRequestError` - Bad request with invalid parameters
+- `UnprocessableEntityError` - Request cannot be processed (e.g., invalid file format)
 - `APIError` - General API errors
 
 ## Rails Integration
@@ -235,6 +353,17 @@ The gem is designed to work seamlessly with Rails applications. See the [example
 - [MusicController](examples/music_controller.rb) - AI music composition and streaming
 - [TextToVoiceController](examples/text_to_voice_controller.rb) - Voice design and creation
 - [VoicesController](examples/voices_controller.rb) - Voice management (CRUD operations)
+- [SpeechToSpeechController](examples/speech_to_speech_controller.rb) - Voice changer and audio transformation
+- [SpeechToTextController](examples/speech_to_text_controller.rb) - Audio/video transcription with advanced features
+- [AudioIsolationController](examples/audio_isolation_controller.rb) - Background noise removal and audio cleanup
+- [AudioNativeController](examples/audio_native_controller.rb) - Embeddable audio players for websites
+- [ForcedAlignmentController](examples/forced_alignment_controller.rb) - Audio-text timing alignment and subtitle generation
+- **Admin Controllers** - Complete administrative functionality:
+  - [Admin::HistoryController](examples/admin/history_controller.rb) - Generated audio history management and analytics
+  - [Admin::UsageController](examples/admin/usage_controller.rb) - Character usage monitoring and analytics
+  - [Admin::UserController](examples/admin/user_controller.rb) - User account and subscription management
+  - [Admin::VoiceLibraryController](examples/admin/voice_library_controller.rb) - Community voice browsing and management
+  - [Admin::ModelsController](examples/admin/models_controller.rb) - Model information and selection guidance
 
 ## Development
 
@@ -245,6 +374,34 @@ bin/setup          # Install dependencies
 bundle exec rspec  # Run tests
 ```
 
+### Available Rake Tasks
+
+```bash
+# Testing
+rake spec                    # Run all tests (default)
+rake test:unit              # Run unit tests only
+rake test:integration       # Run integration tests only
+
+# Security
+rake dev:security           # Run security checks
+rake dev:audit              # Run bundler-audit
+
+# Development
+rake dev:test               # Run all tests
+rake dev:coverage           # Run tests with coverage
+rake release:prepare        # Run full CI suite locally
+```
+
+### Continuous Integration
+
+This gem uses GitHub Actions for CI/CD with the following checks:
+
+- **Tests**: Runs on Ruby 3.0, 3.1, 3.2, and 3.3
+- **Security**: bundler-audit for dependency vulnerability scanning
+- **Build**: Verifies gem can be built and installed
+
+All checks must pass before merging pull requests.
+
 To install this gem onto your local machine:
 
 ```bash
@@ -255,7 +412,8 @@ To release a new version:
 
 1. Update the version number in `version.rb`
 2. Update `CHANGELOG.md`
-3. Run `bundle exec rake release`
+3. Run `bundle exec rake release:prepare` to verify tests and security checks pass
+4. Run `bundle exec rake release`
 
 ## Testing
 

data/lib/elevenlabs_client/client.rb

@@ -2,12 +2,13 @@
 
 require "faraday"
 require "faraday/multipart"
+require "json"
 
 module ElevenlabsClient
   class Client
     DEFAULT_BASE_URL = "https://api.elevenlabs.io"
 
-    attr_reader :base_url, :api_key, :dubs, :text_to_speech, :text_to_speech_stream, :text_to_dialogue, :sound_generation, :text_to_voice, :models, :voices, :music
+    attr_reader :base_url, :api_key, :dubs, :text_to_speech, :text_to_dialogue, :sound_generation, :text_to_voice, :models, :voices, :music, :audio_isolation, :audio_native, :forced_alignment, :speech_to_speech, :speech_to_text, :websocket_text_to_speech, :history, :usage, :user, :voice_library
 
     def initialize(api_key: nil, base_url: nil, api_key_env: "ELEVENLABS_API_KEY", base_url_env: "ELEVENLABS_BASE_URL")
       @api_key = api_key || fetch_api_key(api_key_env)
@@ -15,13 +16,22 @@ module ElevenlabsClient
       @conn = build_connection
       @dubs = Dubs.new(self)
       @text_to_speech = TextToSpeech.new(self)
-      @text_to_speech_stream = TextToSpeechStream.new(self)
       @text_to_dialogue = TextToDialogue.new(self)
       @sound_generation = SoundGeneration.new(self)
       @text_to_voice = TextToVoice.new(self)
-      @models = Models.new(self)
+      @models = Admin::Models.new(self)
+      @history = Admin::History.new(self)
+      @usage = Admin::Usage.new(self)
+      @user = Admin::User.new(self)
+      @voice_library = Admin::VoiceLibrary.new(self)
       @voices = Voices.new(self)
       @music = Endpoints::Music.new(self)
+      @audio_isolation = AudioIsolation.new(self)
+      @audio_native = AudioNative.new(self)
+      @forced_alignment = ForcedAlignment.new(self)
+      @speech_to_speech = SpeechToSpeech.new(self)
+      @speech_to_text = SpeechToText.new(self)
+      @websocket_text_to_speech = WebSocketTextToSpeech.new(self)
     end
 
     # Makes an authenticated GET request
@@ -88,6 +98,17 @@ module ElevenlabsClient
       handle_response(response)
     end
 
+    # Makes an authenticated GET request expecting binary response
+    # @param path [String] API endpoint path
+    # @return [String] Binary response body
+    def get_binary(path)
+      response = @conn.get(path) do |req|
+        req.headers["xi-api-key"] = api_key
+      end
+
+      handle_response(response)
+    end
+
     # Makes an authenticated POST request expecting binary response
     # @param path [String] API endpoint path
     # @param body [Hash, nil] Request body
@@ -144,6 +165,62 @@ module ElevenlabsClient
       handle_response(response)
     end
 
+    # Makes an authenticated GET request with streaming response
+    # @param path [String] API endpoint path
+    # @param block [Proc] Block to handle each chunk
+    # @return [Faraday::Response] Response object
+    def get_streaming(path, &block)
+      response = @conn.get(path) do |req|
+        req.headers["xi-api-key"] = api_key
+        req.headers["Accept"] = "audio/mpeg"
+        
+        # Set up streaming callback
+        req.options.on_data = proc do |chunk, _|
+          block.call(chunk) if block_given?
+        end
+      end
+
+      handle_response(response)
+    end
+
+    # Makes an authenticated POST request with streaming response for timestamp data
+    # @param path [String] API endpoint path
+    # @param body [Hash, nil] Request body
+    # @param block [Proc] Block to handle each JSON chunk with timestamps
+    # @return [Faraday::Response] Response object
+    def post_streaming_with_timestamps(path, body = nil, &block)
+      buffer = ""
+      
+      response = @conn.post(path) do |req|
+        req.headers["xi-api-key"] = api_key
+        req.headers["Content-Type"] = "application/json"
+        req.body = body.to_json if body
+        
+        # Set up streaming callback for JSON chunks
+        req.options.on_data = proc do |chunk, _|
+          if block_given?
+            buffer += chunk
+            
+            # Process complete JSON objects
+            while buffer.include?("\n")
+              line, buffer = buffer.split("\n", 2)
+              next if line.strip.empty?
+              
+              begin
+                json_data = JSON.parse(line)
+                block.call(json_data)
+              rescue JSON::ParserError
+                # Skip malformed JSON lines
+                next
+              end
+            end
+          end
+        end
+      end
+
+      handle_response(response)
+    end
+
     # Helper method to create Faraday::Multipart::FilePart
     # @param file_io [IO] File IO object
     # @param filename [String] Original filename

data/lib/elevenlabs_client/endpoints/admin/history.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'cgi'
+
+module ElevenlabsClient
+  module Admin
+    class History
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /v1/history
+      # Returns a list of your generated audio
+      # Documentation: https://elevenlabs.io/docs/api-reference/history/get-generated-items
+      #
+      # @param options [Hash] Optional parameters
+      # @option options [Integer] :page_size How many history items to return at maximum (max 1000, default 100)
+      # @option options [String] :start_after_history_item_id After which ID to start fetching (for pagination)
+      # @option options [String] :voice_id ID of the voice to filter for
+      # @option options [String] :search Search term for filtering history items
+      # @option options [String] :source Source of the generated history item ("TTS" or "STS")
+      # @return [Hash] Response containing history items, pagination info
+      def list(**options)
+        endpoint = "/v1/history"
+        
+        # Build query parameters
+        query_params = {}
+        query_params[:page_size] = options[:page_size] if options[:page_size]
+        query_params[:start_after_history_item_id] = options[:start_after_history_item_id] if options[:start_after_history_item_id]
+        query_params[:voice_id] = options[:voice_id] if options[:voice_id]
+        query_params[:search] = options[:search] if options[:search]
+        query_params[:source] = options[:source] if options[:source]
+        
+        # Add query parameters to endpoint if any exist
+        if query_params.any?
+          query_string = query_params.map { |k, v| "#{k}=#{CGI.escape(v.to_s)}" }.join("&")
+          endpoint += "?#{query_string}"
+        end
+
+        @client.get(endpoint)
+      end
+
+      # GET /v1/history/:history_item_id
+      # Retrieves a history item by ID
+      # Documentation: https://elevenlabs.io/docs/api-reference/history/get-history-item
+      #
+      # @param history_item_id [String] ID of the history item
+      # @return [Hash] The history item data
+      def get(history_item_id)
+        endpoint = "/v1/history/#{history_item_id}"
+        @client.get(endpoint)
+      end
+
+      # DELETE /v1/history/:history_item_id
+      # Delete a history item by its ID
+      # Documentation: https://elevenlabs.io/docs/api-reference/history/delete-history-item
+      #
+      # @param history_item_id [String] ID of the history item to delete
+      # @return [Hash] Status response
+      def delete(history_item_id)
+        endpoint = "/v1/history/#{history_item_id}"
+        @client.delete(endpoint)
+      end
+
+      # GET /v1/history/:history_item_id/audio
+      # Returns the audio of a history item
+      # Documentation: https://elevenlabs.io/docs/api-reference/history/get-audio-from-history-item
+      #
+      # @param history_item_id [String] ID of the history item
+      # @return [String] The binary audio data
+      def get_audio(history_item_id)
+        endpoint = "/v1/history/#{history_item_id}/audio"
+        @client.get_binary(endpoint)
+      end
+
+      # POST /v1/history/download
+      # Download one or more history items
+      # Documentation: https://elevenlabs.io/docs/api-reference/history/download-history-items
+      #
+      # @param history_item_ids [Array<String>] List of history item IDs to download
+      # @param options [Hash] Optional parameters
+      # @option options [String] :output_format Output format ("wav" or "default")
+      # @return [String] The binary audio data (single file) or zip file (multiple files)
+      def download(history_item_ids, **options)
+        endpoint = "/v1/history/download"
+        request_body = { history_item_ids: history_item_ids }
+        
+        # Add optional parameters
+        request_body[:output_format] = options[:output_format] if options[:output_format]
+
+        @client.post_binary(endpoint, request_body)
+      end
+
+      # Alias methods for convenience
+      alias_method :get_history_item, :get
+      alias_method :get_generated_items, :list
+      alias_method :delete_history_item, :delete
+      alias_method :get_audio_from_history_item, :get_audio
+      alias_method :download_history_items, :download
+
+      private
+
+      attr_reader :client
+    end
+  end
+end

data/lib/elevenlabs_client/endpoints/admin/models.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ElevenlabsClient
+  module Admin
+    class Models
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /v1/models
+      # Gets a list of available models
+      # Documentation: https://elevenlabs.io/docs/api-reference/models/list
+      #
+      # @return [Hash] The JSON response containing an array of models
+      def list
+        endpoint = "/v1/models"
+        @client.get(endpoint)
+      end
+
+      alias_method :list_models, :list
+
+      private
+
+      attr_reader :client
+    end
+  end
+end