runapi-fish-audio 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 338a7a17f016160f10748a7c40dc93b241b466d91f0adbc0b7e4b89b3dffecc8
-  data.tar.gz: 1b0596f4c5ce10dd461aa6a66c9f3f6f2b6240cddfec759b9d023b73139c74f1
+  metadata.gz: 37ad7a253dec28b23ac6123464181e157ff34d6d6c3e4dd5f25a2c1e08bd3f9e
+  data.tar.gz: dcdffb7b22ce9dd666b2f2d9fc4610133fa52c1d1c18fa91d9b19e5197c67ad1
 SHA512:
-  metadata.gz: c98193786625a49bc77d6ae88ee539dc5400f3fa322f961d320e4b9cec122793e3e7a938f52ca3ada9afd1e13b94d54e59c1baa80196a31c6028f9c2971a4b67
-  data.tar.gz: 9f92c001d9edc71d927649ab9a7fbfd2ad5a95458f9964527aa8cb75b3e35fa65ea62a9b818f3c246eb69a92dd22e84da950d453f41269323df4f04ae1915165
+  metadata.gz: 67a1cd8094dd340085048000c998d2411a36fccd3088361320352a3155bc19d76dd2d037569c5aabfc07b3be2bb2f834e80b5e67ee13051823cfd70af357ee62
+  data.tar.gz: 71f706e16580499e6d16a0a34c05bdf0b175efc841fa10737987e82e7d221a8da4b5506c39e4e135828677dc3625083243b9dc27f032068d59e7b92f8d6205df

data/README.md

@@ -9,7 +9,7 @@ raise "Voice is #{voice.voice.state}" unless voice.voice.state == "trained"
 result = client.text_to_speech.run(model: "s2.1-pro", text: "Hello [excited]", voice_id: created.voice.voice_id, output_format: "wav", sample_rate_hz: 44_100)
 ```
 
-Pass optional `references` entries with base64-encoded raw audio bytes and exact transcripts for request-scoped voice matching.
+Pass optional `references` entries with a publicly accessible HTTPS audio URL and exact transcripts for request-scoped voice matching.
 
 Use `list_voices` and `get_voice` to inspect account-owned voice resources. Only `trained` voices can be submitted for speech generation; a returned `voice_id` is a best-effort reference and may stop working later. Update, delete, revoke, or voice-library management methods are not provided; voice retention is not promised.
 
@@ -18,3 +18,9 @@ The output defaults to MP3. Select WAV with `output_format`; `bitrate_kbps` appl
 Model details and pricing: https://runapi.ai/models/fish-audio/s2.1-pro
 
 Licensed under the Apache License, Version 2.0.
+
+## Temporary voice matching
+
+For `s1`, `s2-pro`, and `s2.1-pro`, supply at most one `references` item containing a publicly accessible HTTPS audio URL in `audio` and a nonempty, verbatim transcript in `text`. Do not send `voice_id` with a reference. Omit `references` when selecting an existing voice. The transcript is forwarded unchanged; callers must ensure it matches the audio.
+
+For local audio or Base64, first upload through `POST /api/v1/files`, then use the returned `url` as `references[0].audio`. Keep only one sample and remove `voice_id`. The URL must remain valid while the request waits and the audio is fetched. Files URLs expire by default after one hour; storing a reference does not extend that lifetime. For longer waits, use an external HTTPS URL with enough validity. If a URL expires, upload again and submit a new request.

data/lib/runapi/fish_audio/resources/create_voice.rb

@@ -16,13 +16,11 @@ module RunApi
 
         def run(options: nil, **params)
           params = compact_params(params)
-          validate_contract!(CONTRACT["create-voice"], params)
           run_hybrid(ENDPOINT, body: params, options: options, response_class: RESPONSE_CLASS)
         end
 
         def subscribe(options: nil, **params)
           params = compact_params(params)
-          validate_contract!(CONTRACT["create-voice"], params)
           subscribe_hybrid(ENDPOINT, body: params, options: options, response_class: RESPONSE_CLASS)
         end
       end

data/lib/runapi/fish_audio/resources/get_voice.rb

@@ -15,8 +15,6 @@ module RunApi
         end
 
         def run(voice_id:, options: nil)
-          params = compact_params(voice_id: voice_id)
-          validate_contract!(CONTRACT["get-voice"], params)
           path = "#{ENDPOINT}/#{URI.encode_uri_component(voice_id)}"
           request(:get, path, options: options)
         end

data/lib/runapi/fish_audio/resources/list_voices.rb

@@ -16,7 +16,6 @@ module RunApi
 
         def run(options: nil, **params)
           params = compact_params(params)
-          validate_contract!(CONTRACT["list-voices"], params)
           query = URI.encode_www_form(params)
           path = query.empty? ? ENDPOINT : "#{ENDPOINT}?#{query}"
           request(:get, path, options: options)

data/lib/runapi/fish_audio/resources/text_to_speech.rb

@@ -16,36 +16,13 @@ module RunApi
 
         def run(options: nil, **params)
           params = compact_params(params)
-          validate_contract!(CONTRACT["text-to-speech"], params)
-          validate_references!(params[:references])
           run_hybrid(ENDPOINT, body: params, options: options, response_class: RESPONSE_CLASS)
         end
 
         def subscribe(options: nil, **params)
           params = compact_params(params)
-          validate_contract!(CONTRACT["text-to-speech"], params)
-          validate_references!(params[:references])
           subscribe_hybrid(ENDPOINT, body: params, options: options, response_class: RESPONSE_CLASS)
         end
-
-        private
-
-        def validate_references!(references)
-          return if references.nil?
-          raise Core::ValidationError, "references must be an array" unless references.is_a?(Array)
-
-          references.each_with_index do |reference, index|
-            raise Core::ValidationError, "references[#{index}] must be an object" unless reference.respond_to?(:key?)
-
-            %i[audio text].each do |field|
-              value = reference[field] || reference[field.to_s]
-              if value.nil? || (value.is_a?(String) && value.strip.empty?)
-                raise Core::ValidationError, "references[#{index}].#{field} is required"
-              end
-              raise Core::ValidationError, "references[#{index}].#{field} must be a string" unless value.is_a?(String)
-            end
-          end
-        end
       end
     end
   end

data/lib/runapi/fish_audio/types.rb

@@ -13,7 +13,6 @@ module RunApi
       # Response containing one reusable voice.
       class VoiceResponse < RunApi::Core::BaseModel
         required :voice, -> { Voice }
-        required :billing, RunApi::Core::TaskBillingFacts
       end
 
       # Paginated response containing account-owned reusable voices.
@@ -22,7 +21,6 @@ module RunApi
         required :total, Integer
         required :page_number, Integer
         required :page_size, Integer
-        required :billing, RunApi::Core::TaskBillingFacts
       end
 
       # A RunAPI-managed audio result.

data/lib/runapi/fish_audio.rb

@@ -2,7 +2,6 @@
 
 require "runapi/core"
 require_relative "fish_audio/types"
-require_relative "fish_audio/contract_gen"
 require_relative "fish_audio/resources/create_voice"
 require_relative "fish_audio/resources/list_voices"
 require_relative "fish_audio/resources/get_voice"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-fish-audio
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.6.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 0.6.1
 description: Install `runapi-fish-audio` and create a `RunApi::FishAudio::Client`.
 email:
 - contact@runapi.ai
@@ -36,7 +36,6 @@ files:
 - lib/runapi-fish_audio.rb
 - lib/runapi/fish_audio.rb
 - lib/runapi/fish_audio/client.rb
-- lib/runapi/fish_audio/contract_gen.rb
 - lib/runapi/fish_audio/resources/create_voice.rb
 - lib/runapi/fish_audio/resources/get_voice.rb
 - lib/runapi/fish_audio/resources/list_voices.rb
@@ -66,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.17
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Fish Audio Ruby SDK for RunAPI
 test_files: []

data/lib/runapi/fish_audio/contract_gen.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-module RunApi
-  module FishAudio
-    CONTRACT = {
-      "create-voice" => {
-        "models" => [],
-        "fields_by_model" => {
-          "_" => {
-            "name" => {
-              "required" => true
-            },
-            "source_audio_url" => {
-              "required" => true
-            }
-          }
-        }
-      },
-      "get-voice" => {
-        "models" => [],
-        "fields_by_model" => {
-          "_" => {
-            "voice_id" => {
-              "required" => true
-            }
-          }
-        }
-      },
-      "list-voices" => {
-        "models" => [],
-        "fields_by_model" => {
-          "_" => {
-            "page_number" => {
-              "min" => 1,
-              "type" => "integer"
-            },
-            "page_size" => {
-              "min" => 1,
-              "max" => 100,
-              "type" => "integer"
-            }
-          }
-        }
-      },
-      "text-to-speech" => {
-        "models" => ["s1", "s2-pro", "s2.1-pro"],
-        "fields_by_model" => {
-          "s1" => {
-            "bitrate_kbps" => {
-              "enum" => [64, 128, 192],
-              "type" => "integer"
-            },
-            "model" => {
-              "required" => true
-            },
-            "output_format" => {
-              "enum" => ["mp3", "wav"]
-            },
-            "sample_rate_hz" => {
-              "enum" => [8000, 16000, 24000, 32000, 44100],
-              "type" => "integer"
-            },
-            "text" => {
-              "required" => true
-            }
-          },
-          "s2-pro" => {
-            "bitrate_kbps" => {
-              "enum" => [64, 128, 192],
-              "type" => "integer"
-            },
-            "model" => {
-              "required" => true
-            },
-            "output_format" => {
-              "enum" => ["mp3", "wav"]
-            },
-            "sample_rate_hz" => {
-              "enum" => [8000, 16000, 24000, 32000, 44100],
-              "type" => "integer"
-            },
-            "text" => {
-              "required" => true
-            }
-          },
-          "s2.1-pro" => {
-            "bitrate_kbps" => {
-              "enum" => [64, 128, 192],
-              "type" => "integer"
-            },
-            "model" => {
-              "required" => true
-            },
-            "output_format" => {
-              "enum" => ["mp3", "wav"]
-            },
-            "sample_rate_hz" => {
-              "enum" => [8000, 16000, 24000, 32000, 44100],
-              "type" => "integer"
-            },
-            "text" => {
-              "required" => true
-            }
-          }
-        },
-        "rules" => [{
-          "when" => {
-            "output_format" => "wav"
-          },
-          "forbidden" => ["bitrate_kbps"]
-        }, {
-          "enum" => {
-            "sample_rate_hz" => [32000, 44100]
-          },
-          "when" => {
-            "output_format" => "mp3"
-          }
-        }, {
-          "enum" => {
-            "sample_rate_hz" => [32000, 44100]
-          },
-          "when" => {
-            "output_format" => {
-              "present" => false
-            }
-          }
-        }]
-      }
-    }.freeze
-  end
-end