elevenlabs 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2daafae7b6dbf3724b93ce2022b2fe6ac3703bfbcac12326b75e1a37cd188a39
-  data.tar.gz: ba2227a765efc7538e4aadbe0fcb0917a55c1ba70540a2660b4c75b2545f85da
+  metadata.gz: ea563591f2116a24c1911bd964ed30bfee9dd468e9890db98a7f38ad84138bd4
+  data.tar.gz: e1c155f3dc9f5daaff7ceb283ccd7493335f639a1beb66df93adaf14ac8fac96
 SHA512:
-  metadata.gz: 07d40969dd5fdf8926c2f09c21359df4b5060b1f212797de03ef16c4fcf0dc2b6495c476a9a0741247dccf95dd30fde8d6da7404370b6acc4b61a0ea0ce8f7cd
-  data.tar.gz: 927e01fdc01e4f985466b62e2725f676117f757d3f809d8b4da7ea420e54c0e0a57ab2279cf031dd466451ce8c7a96dd76219da4a7e3d02ada842682a20246f8
+  metadata.gz: 8559ecdf9dc45be3f7018afb389cb784603ba6c255db024f7276df60490504da366f462cbf2fb3886eeaf39f305ff530ef5ee4f9dcee577df883e62e48684af7
+  data.tar.gz: 62c761c794c8641940d5b297a0252b37dc9f41e2afcaaad777701acf7c94ee8ec3089f76559eaffd26bdf4292930cf2a9f5827f5d7ed5c523445356fa3e085b4

data/README.md

@@ -15,6 +15,7 @@ This gem provides an easy-to-use interface for:
 - **Designing a voice** based on a text description
 - **Streaming text-to-speech audio**
 - **Music Generation**
+- **Sound Effect Generation**
 
 All requests are handled via [Faraday](https://github.com/lostisland/faraday).
 
@@ -340,6 +341,51 @@ plan = client.create_music_plan(prompt: "Upbeat pop song with verse and chorus",
 puts plan[:sections]
 ```
 
+15. **Create sound effects from a prompt**
+
+Basic Usage: Simple Prompt
+  Generate a sound effect with only a text prompt, using default settings (output_format: "mp3_44100_128", duration_seconds: nil (auto-detected), prompt_influence: 0.3).
+
+```ruby
+audio_data = client.sound_generation("Futuristic laser blast in a space battle")
+
+# Save the audio to a file
+File.open("laser_blast.mp3", "wb") { |f| f.write(audio_data) }
+```
+
+Advanced Usage: Custom Duration, Influence, and Format
+Specify duration_seconds, prompt_influence, and output_format for precise control over the sound effect.
+# Generate a roaring dragon sound with specific settings
+```ruby
+audio_data = client.sound_generation(
+  "Roaring dragon in a fantasy cave",
+  duration_seconds: 3.0,
+  prompt_influence: 0.7, # Higher influence for closer adherence to the prompt
+  output_format: "mp3_22050_32"
+)
+
+# Save the audio to a file
+File.open("dragon_roar.mp3", "wb") { |f| f.write(audio_data) }
+```
+
+
+Looping Sound Effect
+Create a looping sound effect for continuous playback, such as background ambiance in a video game.
+# Generate a looping ambient sound for a haunted forest
+```ruby
+audio_data = client.sound_generation(
+  "Eerie wind and distant owl hoots in a haunted forest",
+  loop: true,
+  duration_seconds: 10.0,
+  prompt_influence: 0.5,
+  output_format: "mp3_22050_32"
+)
+# Save the audio to a file
+File.open("haunted_forest_loop.mp3", "wb") { |f| f.write(audio_data) }
+```
+
+For more details, see the ElevenLabs Sound Generation API documentation.
+
 ---
 
 ## Error Handling
@@ -396,7 +442,7 @@ gem build elevenlabs.gemspec
 Install the gem locally:
 
 ```bash
-gem install ./elevenlabs-0.0.7.gem
+gem install ./elevenlabs-0.0.8.gem
 ```
 
 ---

data/lib/elevenlabs/client.rb

@@ -9,13 +9,15 @@ module Elevenlabs
     BASE_URL = "https://api.elevenlabs.io"
 
     # Note the default param: `api_key: nil`
-    def initialize(api_key: nil)
+    def initialize(api_key: nil, open_timeout: 5, read_timeout: 120)
       # If the caller doesn’t provide an api_key, use the gem-wide config
       @api_key = api_key || Elevenlabs.configuration&.api_key
 
       @connection = Faraday.new(url: BASE_URL) do |conn|
         conn.request :url_encoded
         conn.response :raise_error
+        conn.options.open_timeout = open_timeout   # time to open connection
+        conn.options.timeout      = read_timeout   # time to wait for response
         conn.adapter Faraday.default_adapter
       end
     end
@@ -129,6 +131,48 @@ module Elevenlabs
       handle_error(e)
     end
 
+    #####################################################
+    #                 Sound Generation                  #
+    #      (POST /v1/sound-generation)                  #
+    #####################################################
+
+    # Convert text to sound effects and retrieve audio (binary data)
+    # Documentation: https://elevenlabs.io/docs/api-reference/sound-generation
+    #
+    # @param [String] text - text prompt describing the sound effect
+    # @param [Hash] options - optional parameters
+    #   :loop              => Boolean  (whether to create a looping sound effect, default: false)
+    #   :duration_seconds  => Float    (0.5 to 30 seconds, default: nil for auto-detection)
+    #   :prompt_influence  => Float    (0.0 to 1.0, default: 0.3)
+    #   :output_format     => String   (e.g., "mp3_22050_32", default: "mp3_44100_128")
+    #
+    # @return [String] The binary audio data (usually an MP3).
+    def sound_generation(text, options = {})
+      endpoint = "/v1/sound-generation"
+      request_body = { text: text }
+
+      # Add optional parameters if provided
+      request_body[:loop] = options[:loop] unless options[:loop].nil?
+      request_body[:duration_seconds] = options[:duration_seconds] if options[:duration_seconds]
+      request_body[:prompt_influence] = options[:prompt_influence] if options[:prompt_influence]
+
+      headers = default_headers
+      headers["Accept"] = "audio/mpeg"
+
+      query = {}
+      query[:output_format] = options[:output_format] if options[:output_format]
+
+      response = @connection.post("#{endpoint}?#{URI.encode_www_form(query)}") do |req|
+        req.headers = headers
+        req.body = request_body.to_json
+      end
+
+      # Returns raw binary data (often MP3)
+      response.body
+    rescue Faraday::ClientError => e
+      handle_error(e)
+    end
+
     #####################################################
     #                  Design a Voice                   #
     #      (POST /v1/text-to-voice/design)              #

data/lib/elevenlabs.rb

@@ -5,7 +5,7 @@ require_relative "elevenlabs/client"
 require_relative "elevenlabs/errors"
 
 module Elevenlabs
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 
   # Optional global configuration
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elevenlabs
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - hackliteracy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-25 00:00:00.000000000 Z
+date: 2025-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday