typecast-ruby 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 783ee042ba45a4a26659e61c50b2e28fb058f03ba0ad11e1573bf43a5abca44a
-  data.tar.gz: a15b17e6e707b5dc8bf4c524c6a3b50ceee8b0dcada0d34820359905f38042c9
+  metadata.gz: '07508aef051788fd8993b3c844fd431689193ea006541bc4f2cfc0224de8ed79'
+  data.tar.gz: 0dd2fc6ee5a0c435e5742f89dc8d14cb25feb9a3bc0dad9c6179ba0150617565
 SHA512:
-  metadata.gz: 66ace71a958a4f2f05e321d9be6ff162f66e8fbf4c327bb300ff29f716a4b4e64d426cc9034fb830452a97689a2e28ad6143135d501c1e8f024d7d3ab6926c2a
-  data.tar.gz: 1145c85137b9fb6253b3db418c8f50ecd53afe244c98a8c6df3b867ed9dc94b24f49f34ee98707fd76f6dc8cbfa1c39ae84698ec31895dff619492731e2ae5f3
+  metadata.gz: a234192530e80f46f39d8bb4943d796dfad95f4dbe8521e92a52b74ee4b8c393ccd73741dc4f802469ea57e157d096f5a49a5e5ca8f93bfbde87605768a5543c
+  data.tar.gz: ec1f70d384151b04825b6018f9c478fe9c1a301859ddb529ee973128cbf8a44e097765bd9d735612ee9ed110576e1e782f08229cdeaae5d450a8600b540f3926

data/lib/typecast/client.rb

@@ -14,8 +14,9 @@ module Typecast
     attr_reader :api_key, :base_url
 
     def initialize(api_key: ENV["TYPECAST_API_KEY"], base_url: ENV["TYPECAST_API_HOST"] || DEFAULT_BASE_URL, open_timeout: 10, read_timeout: 30)
-      @api_key = api_key.to_s
+      @api_key = api_key.to_s.strip
       @base_url = normalize_base_url(base_url)
+      validate_api_key!
       @open_timeout = open_timeout
       @read_timeout = read_timeout
     end
@@ -29,6 +30,22 @@ module Typecast
       )
     end
 
+    # Browse available API voices at https://typecast.ai/developers/api/voices.
+    def generate_to_file(path, text:, voice_id:, model: Models::TTS_MODEL_V30, language: nil, prompt: nil, output: nil, seed: nil)
+      request = Models::TTSRequest.new(
+        voice_id: voice_id,
+        text: text,
+        model: model,
+        language: language,
+        prompt: prompt,
+        output: output || inferred_output(path),
+        seed: seed
+      )
+      response = text_to_speech(request)
+      File.binwrite(path, response.audio_data)
+      response
+    end
+
     def text_to_speech_stream(request)
       response = request_json(:post, "/v1/text-to-speech/stream", request.to_h)
       return enum_for(:text_to_speech_stream, request) unless block_given?
@@ -80,12 +97,19 @@ module Typecast
 
     private
 
+    def inferred_output(path)
+      case File.extname(path.to_s).downcase
+      when ".mp3" then Models::Output.new(audio_format: Models::AUDIO_MP3)
+      when ".wav" then Models::Output.new(audio_format: Models::AUDIO_WAV)
+      end
+    end
+
     def request_json(method, path, body = nil, query = nil)
-      headers = { "X-API-KEY" => api_key, "Content-Type" => "application/json" }
+      headers = auth_headers.merge("Content-Type" => "application/json")
       request_raw(method, path, body.nil? ? nil : JSON.generate(body), headers, query)
     end
 
-    def request_raw(method, path, body = nil, headers = { "X-API-KEY" => api_key }, query = nil)
+    def request_raw(method, path, body = nil, headers = auth_headers, query = nil)
       uri = build_uri(path, query)
       request = request_for(method, uri)
       headers.each { |key, value| request[key] = value }
@@ -121,13 +145,26 @@ module Typecast
         :post,
         path,
         body,
-        {
-          "X-API-KEY" => api_key,
+        auth_headers.merge(
           "Content-Type" => "multipart/form-data; boundary=#{boundary}"
-        }
+        )
       )
     end
 
+    def auth_headers
+      api_key.empty? ? {} : { "X-API-KEY" => api_key }
+    end
+
+    def validate_api_key!
+      return unless api_key.empty? && default_base_url?
+
+      raise ArgumentError, "api_key is required for the default Typecast API host"
+    end
+
+    def default_base_url?
+      normalized_base_url(base_url).casecmp?(normalized_base_url(DEFAULT_BASE_URL))
+    end
+
     def validate_clone_inputs(audio, name)
       raise ArgumentError, "audio must be 25MB or smaller" if audio.bytesize > Models::CLONING_MAX_FILE_SIZE
       raise ArgumentError, "name must be 1-#{Models::CLONING_NAME_MAX_LENGTH} chars" if name.empty? || name.length > Models::CLONING_NAME_MAX_LENGTH
@@ -145,6 +182,10 @@ module Typecast
       raise ArgumentError, "base_url must be a valid URL"
     end
 
+    def normalized_base_url(value)
+      value.to_s.strip.sub(%r{/+\z}, "")
+    end
+
     def local_uri?(uri)
       uri.scheme == "http" && ["localhost", "127.0.0.1", "::1"].include?(uri.hostname)
     end

data/lib/typecast/models.rb

@@ -90,6 +90,7 @@ module Typecast
     class TTSRequest
       attr_reader :voice_id, :text, :model, :language, :prompt, :output, :seed
 
+      # Browse available API voices at https://typecast.ai/developers/api/voices.
       def initialize(voice_id:, text:, model:, language: nil, prompt: nil, output: nil, seed: nil)
         @voice_id = voice_id
         @text = text

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: typecast-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Neosapience
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-05 00:00:00.000000000 Z
+date: 2026-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest