elevenlabs_client 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6c150778cecf2c843fc1b5492d1cfbaed14306f010b240557945c631b083fa1
-  data.tar.gz: 62ba8f400b1be939bfc5839b47a5e636a5e888d812b8eabc04c1ca26196c9c63
+  metadata.gz: 2b65be08b17b9ae232158f2c004511a7840688e76853c014f9be37984a9639d1
+  data.tar.gz: 2de88d74e59af044cfe943e32f0d2f2d8b45f71200469a69b3f95fc7605436d2
 SHA512:
-  metadata.gz: 9df813daf9c443428e92cd323b94f05fa0791ab046b34f5c0ddd12bc19654235888c98bc47299355e2b9c6bf5d5a417d0b639f59b6d0af16b86f5e3f700202ad
-  data.tar.gz: 50b4a3229dbd3f2e25c5614d5178d4b688c812d9a01181748879a8490a66df457e4fb24b3b6110d0e72e1def3e877072045e84fecb18b175128b1b18fb96e2ad
+  metadata.gz: f919ebdf7090d2f4cdd812589eccd1425e8be5e86615c04f3bf2882c7e8e8e07058db4f37cdf420e6b1948c668c3acbb177fe796b48c7f23563fa41a7204f4ce
+  data.tar.gz: 23b7dc77bb3ca90e2019d4098887b8555d103d66c1fdf259f883f7952b4c26f57671f9bd2e250e27491acc42c2518e85b37bcb48cdb678fd163f9b3be9b1d7e4

data/CHANGELOG.md

@@ -5,6 +5,25 @@ 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).
 
+## [0.4.0] - 2025-09-12
+
+### Added
+
+- **🎵 Dubbing Generation API** 
+  - `delete(dubbing_id)` - Delete dubbing projects
+  - `get_resource(dubbing_id)` - Get detailed resource information
+  - `create_segment(options)` - Create new segments
+  - `delete_segment(options)` - Delete segments
+  - `update_segment(options)` - Update segment text/timing
+  - `transcribe_segment(options)` - Regenerate transcriptions
+  - `translate_segment(options)` - Regenerate translations
+  - `dub_segment(options)` - Regenerate dubs
+  - `render_project(options)` - Render output media
+  - `update_speaker(options)` - Update speaker voices
+  - `get_similar_voices(options)` - Get voice recommendations
+- **🔧 HTTP Client Improvements** - Added HTTP method
+  - Added `patch` method for PATCH requests
+
 ## [0.3.0] - 2025-09-12
 
 ### Added
@@ -252,4 +271,4 @@ client.dubs.create(file_io: file, filename: "video.mp4", target_languages: ["es"
 - **File Support**: Multiple video and audio formats (MP4, MOV, MP3, WAV, etc.)
 - **Language Support**: Multiple target languages for dubbing
 - **Configuration**: Flexible API key and endpoint configuration
-- **Testing**: Comprehensive test suite with integration tests
+- **Testing**: Comprehensive test suite with integration tests

data/lib/elevenlabs_client/client.rb

@@ -61,6 +61,20 @@ module ElevenlabsClient
       handle_response(response)
     end
 
+    # Makes an authenticated PATCH request
+    # @param path [String] API endpoint path
+    # @param body [Hash, nil] Request body
+    # @return [Hash] Response body
+    def patch(path, body = nil)
+      response = @conn.patch(path) do |req|
+        req.headers["xi-api-key"] = api_key
+        req.headers["Content-Type"] = "application/json"
+        req.body = body.to_json if body
+      end
+
+      handle_response(response)
+    end
+
     # Makes an authenticated multipart POST request
     # @param path [String] API endpoint path
     # @param payload [Hash] Multipart payload

data/lib/elevenlabs_client/endpoints/dubs.rb

@@ -53,6 +53,162 @@ module ElevenlabsClient
       @client.get("/v1/dubbing/#{dubbing_id}/resources")
     end
 
+    # DELETE /v1/dubbing/{id}
+    # Deletes a dubbing project
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @return [Hash] Response with status
+    def delete(dubbing_id)
+      @client.delete("/v1/dubbing/#{dubbing_id}")
+    end
+
+    # GET /v1/dubbing/resource/{dubbing_id}
+    # Gets dubbing resource with detailed information including segments, speakers, etc.
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @return [Hash] Detailed dubbing resource information
+    def get_resource(dubbing_id)
+      @client.get("/v1/dubbing/resource/#{dubbing_id}")
+    end
+
+    # POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment
+    # Creates a new segment in dubbing resource
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param speaker_id [String] The speaker ID
+    # @param start_time [Float] Start time of the segment
+    # @param end_time [Float] End time of the segment
+    # @param text [String, nil] Optional text for the segment
+    # @param translations [Hash, nil] Optional translations map
+    # @return [Hash] Response with version and new segment ID
+    def create_segment(dubbing_id:, speaker_id:, start_time:, end_time:, text: nil, translations: nil)
+      payload = {
+        start_time: start_time,
+        end_time: end_time,
+        text: text,
+        translations: translations
+      }.compact
+
+      @client.post("/v1/dubbing/resource/#{dubbing_id}/speaker/#{speaker_id}/segment", payload)
+    end
+
+    # DELETE /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}
+    # Deletes a single segment from the dubbing
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param segment_id [String] The segment ID
+    # @return [Hash] Response with version
+    def delete_segment(dubbing_id, segment_id)
+      @client.delete("/v1/dubbing/resource/#{dubbing_id}/segment/#{segment_id}")
+    end
+
+    # PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}
+    # Updates a single segment with new text and/or start/end times
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param segment_id [String] The segment ID
+    # @param language [String] The language ID
+    # @param start_time [Float, nil] Optional new start time
+    # @param end_time [Float, nil] Optional new end time
+    # @param text [String, nil] Optional new text
+    # @return [Hash] Response with version
+    def update_segment(dubbing_id:, segment_id:, language:, start_time: nil, end_time: nil, text: nil)
+      payload = {
+        start_time: start_time,
+        end_time: end_time,
+        text: text
+      }.compact
+
+      @client.patch("/v1/dubbing/resource/#{dubbing_id}/segment/#{segment_id}/#{language}", payload)
+    end
+
+    # POST /v1/dubbing/resource/{dubbing_id}/transcribe
+    # Regenerates transcriptions for specified segments
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param segments [Array<String>] List of segment IDs to transcribe
+    # @return [Hash] Response with version
+    def transcribe_segment(dubbing_id, segments)
+      payload = { segments: segments }
+      @client.post("/v1/dubbing/resource/#{dubbing_id}/transcribe", payload)
+    end
+
+    # POST /v1/dubbing/resource/{dubbing_id}/translate
+    # Regenerates translations for specified segments/languages
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param segments [Array<String>] List of segment IDs to translate
+    # @param languages [Array<String>, nil] Optional list of languages to translate
+    # @return [Hash] Response with version
+    def translate_segment(dubbing_id, segments, languages = nil)
+      payload = {
+        segments: segments,
+        languages: languages
+      }.compact
+
+      @client.post("/v1/dubbing/resource/#{dubbing_id}/translate", payload)
+    end
+
+    # POST /v1/dubbing/resource/{dubbing_id}/dub
+    # Regenerates dubs for specified segments/languages
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param segments [Array<String>] List of segment IDs to dub
+    # @param languages [Array<String>, nil] Optional list of languages to dub
+    # @return [Hash] Response with version
+    def dub_segment(dubbing_id, segments, languages = nil)
+      payload = {
+        segments: segments,
+        languages: languages
+      }.compact
+
+      @client.post("/v1/dubbing/resource/#{dubbing_id}/dub", payload)
+    end
+
+    # POST /v1/dubbing/resource/{dubbing_id}/render/{language}
+    # Renders the output media for a language
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param language [String] The language to render
+    # @param render_type [String] The type of render (mp4, aac, mp3, wav, aaf, tracks_zip, clips_zip)
+    # @param normalize_volume [Boolean, nil] Whether to normalize volume (defaults to false)
+    # @return [Hash] Response with version and render_id
+    def render_project(dubbing_id:, language:, render_type:, normalize_volume: nil)
+      payload = {
+        render_type: render_type,
+        normalize_volume: normalize_volume
+      }.compact
+
+      @client.post("/v1/dubbing/resource/#{dubbing_id}/render/#{language}", payload)
+    end
+
+    # PATCH /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}
+    # Updates speaker metadata such as voice
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param speaker_id [String] The speaker ID
+    # @param voice_id [String, nil] Voice ID from library or 'track-clone'/'clip-clone'
+    # @param languages [Array<String>, nil] Languages to apply changes to
+    # @return [Hash] Response with version
+    def update_speaker(dubbing_id:, speaker_id:, voice_id: nil, languages: nil)
+      payload = {
+        voice_id: voice_id,
+        languages: languages
+      }.compact
+
+      @client.patch("/v1/dubbing/resource/#{dubbing_id}/speaker/#{speaker_id}", payload)
+    end
+
+    # GET /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/similar-voices
+    # Gets similar voices for a speaker
+    #
+    # @param dubbing_id [String] The dubbing job ID
+    # @param speaker_id [String] The speaker ID
+    # @return [Hash] Response with list of similar voices
+    def get_similar_voices(dubbing_id, speaker_id)
+      @client.get("/v1/dubbing/resource/#{dubbing_id}/speaker/#{speaker_id}/similar-voices")
+    end
+
     private
 
     attr_reader :client

data/lib/elevenlabs_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ElevenlabsClient
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elevenlabs_client
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Vitor Oliveira