typecast-ruby 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5de7b5e77a18c1e4e6834db6fedd467b922eb4a6124b01ad67b3521a7b5cebf7
-  data.tar.gz: 95ddc9f242aebcb75372c93bcebde790e36aa4a84a096c981b5a039055dfcd2b
+  metadata.gz: f65c6725ca10d449b9ba688231a8ad96a7042197efe9fdba188b84a55fa1d232
+  data.tar.gz: 9995e18d6b6364c9e9906216d643759ab0570b0867228cb49951a0e7259ccb2e
 SHA512:
-  metadata.gz: 6ade9e4df77283c37b69efc1fc8d417233d31b63b7f256c4badeccdd106f524014f01c526f199b3e187ceb6b8338cd2b0068814a67618930d8ebf37d4ce4ce6e
-  data.tar.gz: f8f83592269f2d30ee810e257a8713dd34ffadc034933b51b089aa9bc0b1fbff7de9a8b0b9fda8947f914570e76b3f2948eaca65d38d53f49a1db8877ec7aa65
+  metadata.gz: e724bac05758d13d390cb1865eb522c57b55cdd6ae976d778d28643b06db35f390e3151040a4f611138977a13d6f07448ec35f39cb86f13ce7376915b2820c50
+  data.tar.gz: 75001ca132eed41352314a431fc34d184f5d3f8c931f3cbce6b5809ca9f90214da108c6f97c7bf48d048744a325ee15783c2bc9d75faef053a74c3fcf93c0dc2

data/lib/typecast/client.rb

@@ -91,6 +91,18 @@ module Typecast
       voices.first
     end
 
+    # Recommends voices from a text description.
+    #
+    # Results only include voice_id, voice_name, and score. Use get_voice_v2 or
+    # get_voices_v2 to fetch detailed voice metadata for returned voice IDs.
+    def recommend_voices(query, count: 5)
+      raise ArgumentError, "count must be between 1 and 10" unless (1..10).cover?(count)
+
+      JSON.parse(request_json(:get, "/v1/voices/recommendations", nil, { query: query, count: count }).body).map do |item|
+        Models::RecommendedVoice.from_h(item)
+      end
+    end
+
     def clone_voice(audio:, filename:, name:, model:)
       validate_clone_inputs(audio, name)
       response = request_multipart("/v1/voices/clone", audio: audio, filename: filename, fields: { name: name, model: model })

data/lib/typecast/models.rb

@@ -179,6 +179,27 @@ module Typecast
       end
     end
 
+    class RecommendedVoice
+      attr_reader :voice_id, :voice_name, :score
+
+      # Recommendation results only include the matched voice ID, voice name,
+      # and similarity score. Use get_voice_v2 or get_voices_v2 to fetch
+      # detailed voice metadata for a returned voice_id.
+      def self.from_h(hash)
+        new(
+          voice_id: hash.fetch("voice_id", ""),
+          voice_name: hash.fetch("voice_name", ""),
+          score: hash.fetch("score", 0).to_f
+        )
+      end
+
+      def initialize(voice_id:, voice_name:, score:)
+        @voice_id = voice_id
+        @voice_name = voice_name
+        @score = score
+      end
+    end
+
     class VoicesV2Filter
       attr_reader :model, :gender, :age, :use_cases
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: typecast-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Neosapience
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-23 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest