runapi-suno 0.2.8 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 124108c4cd23a7de517f3ab0f0eac3b38b898c43774965bb4819c946e8f62a28
-  data.tar.gz: 35d6431cf52fb7159d390a45adfd5899220b72862e5282e2f56053ad64870997
+  metadata.gz: e778eebc0d01b454f8a2187126173625cd0c14925a2e238eef0a1015e8ff6a0c
+  data.tar.gz: 404e68c9d3e9673d9ac80d393d6cebea8a4482e055f3b37de6f3961919712690
 SHA512:
-  metadata.gz: 93841c24e1ba681727532961006a2ea959dece477c1b7419d09acfc322893e25eab178efe282bc1c250363c7e001fcd8af337ec0ce36b7a106be459b48c498bd
-  data.tar.gz: 1aeb7d43eea7c6d2aac1e08a28ac2cc6aacc6f82c6cd57929c240a4880f3ae4fd25cd2b87eef65dc51169949858c5696926b2d71d698db44952946e141ae4ac6
+  metadata.gz: 9a7ac2a46590a7869002485d2a8fb9e27bea5866a480ae3d70fbf3cf0bc6367d13cb5801fd12a30d86feeed15fd3fb0ffc06361f2fea59f9e96cbbb6398e2356
+  data.tar.gz: 3dedafb65dada78f0c75ec572778813477fa44c24ab314de55f278c58dc0aa2fed613e26efc3834b5a273592398ec01c36eaea6bbef5a9d0eff02353d57fb097

data/lib/runapi/suno/contract_gen.rb

@@ -239,7 +239,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -257,7 +259,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -275,7 +279,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -293,7 +299,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -311,7 +319,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -329,7 +339,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -544,11 +556,23 @@ module RunApi
             "audio_id" => {
               "required" => true
             },
+            "stem_name" => {
+              "enum" => ["Lead Vocal", "Drum Kit", "Kick", "Snare", "Risers", "Bass", "Backing Vocals", "Piano", "Electric Guitar", "Percussion", "String Section", "Synth", "Acoustic Guitar", "Sound Effects", "Synth Pad", "Synth Bass", "Guitar", "Brass Section", "Organ", "Electronic Drum Kit", "Lead Electric Guitar", "Synth Keys", "Rhythm Electric Guitar", "Electric Piano", "Upright Bass", "Keyboards", "Distorted Electric Guitar", "Synth Strings", "Synth Lead", "Woodwinds", "Rhythm Acoustic Guitar", "Flute", "Harp", "Tambourine", "Trumpet", "Arpeggiator", "Accordion", "Fiddle", "Pedal Steel Guitar", "Synth Voice", "Violin", "Digital Piano", "Synth Brass", "Mandolin", "Choir", "Banjo", "Bells", "Clarinet", "Tenor Saxophone", "Trombone", "Shaker", "French Horn", "Glockenspiel", "Electric Bass", "Cello", "Timpani", "Harmonica", "Marimba", "Vibraphone", "Lap Steel Guitar", "Saxophone", "Orchestra", "Horns", "Cymbals", "Hand Clap", "Oboe", "Celesta", "Congas", "Drone", "Alto Saxophone", "Double Bass", "Ukulele", "Harpsichord", "Baritone Saxophone", "Xylophone", "Tuba", "Bass Guitar", "Whistle", "Lead Guitar", "Rhodes", "808", "Bongos", "Bassoon", "Cowbell", "Viola", "Sitar", "Steel Drums", "Piccolo", "Theremin", "Bagpipes", "Hi-Hat", "Music Box", "Melodica", "Tabla", "Koto", "Djembe", "Taiko", "Didgeridoo"]
+            },
             "task_id" => {
               "required" => true
+            },
+            "type" => {
+              "enum" => ["separate_vocal", "split_stem", "split_stem_advanced"]
             }
           }
-        }
+        },
+        "rules" => [{
+          "when" => {
+            "type" => "split_stem_advanced"
+          },
+          "required" => ["stem_name"]
+        }]
       },
       "text-to-music" => {
         "models" => ["suno-v4", "suno-v4.5", "suno-v4.5-all", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],

data/lib/runapi/suno/types.rb

@@ -21,7 +21,6 @@ module RunApi
       # auto_lyrics: generates from prompt; exact_lyrics: sings literal lyrics; instrumental: no vocals.
       VOCAL_MODES = %w[auto_lyrics exact_lyrics instrumental].freeze
       # separate_vocal: isolates vocals+instrumental; split_stem: splits into all individual instruments.
-      SEPARATE_AUDIO_STEMS_TYPES = %w[separate_vocal split_stem].freeze
       # Language for the voice-cloning validation phrase the user must read back.
       VALIDATION_PHRASE_LANGUAGES = %w[en zh es fr pt de ja ko hi ru].freeze
       # Singing ability of the voice being cloned; calibrates model expectations.
@@ -67,6 +66,20 @@ module RunApi
         required :palign, Numeric
       end
 
+      # One audio result in an advanced stem extraction pair.
+      class AdvancedStemAudio < RunApi::Core::BaseModel
+        required :id, String
+        required :duration_seconds, Numeric
+        required :audio_url, String
+      end
+
+      # Extracted target stem and the remaining audio after removing it.
+      class AdvancedStemPair < RunApi::Core::BaseModel
+        required :stem_name, String
+        required :extracted_audio, -> { AdvancedStemAudio }
+        required :remaining_audio, -> { AdvancedStemAudio }
+      end
+
       # URLs for each isolated instrument stem after separation. Only populated stems have URLs.
       class SeparatedAudio < RunApi::Core::BaseModel
         optional :vocal_url, String
@@ -83,6 +96,7 @@ module RunApi
         optional :strings_url, String
         optional :synth_url, String
         optional :woodwinds_url, String
+        optional :pairs, [-> { AdvancedStemPair }]
       end
 
       # A single MIDI note event within an instrument track.

data/lib/runapi/suno/validators.rb

@@ -49,8 +49,7 @@ module RunApi
       end
 
       def validate_separate_audio_stems!(params, resource)
-        require_all!(resource, params, :task_id, :audio_id)
-        validate_optional!(resource, params, :type, Types::SEPARATE_AUDIO_STEMS_TYPES)
+        resource.send(:validate_contract!, CONTRACT["separate-audio-stems"], params)
       end
 
       def validate_generate_midi!(params, resource)
@@ -89,10 +88,6 @@ module RunApi
       end
 
       def validate_create_mashup!(params, resource)
-        upload_url_list = param(resource, params, :upload_url_list)
-        unless upload_url_list.is_a?(Array) && upload_url_list.size == 2
-          raise Core::ValidationError, "upload_url_list must contain exactly 2 URLs"
-        end
         resource.send(:validate_contract!, CONTRACT["create-mashup"], params)
       end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-suno
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.2.10
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.10
+        version: 0.2.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.10
+        version: 0.2.14
 description: The Suno Ruby SDK is the language-specific package for Suno on RunAPI.
   Use this package for song generation, lyrics, vocals, extension, and audio transformation
   workflows when your application needs request bodies, task status lookup, and consistent