runapi-suno 0.2.8 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 124108c4cd23a7de517f3ab0f0eac3b38b898c43774965bb4819c946e8f62a28
-  data.tar.gz: 35d6431cf52fb7159d390a45adfd5899220b72862e5282e2f56053ad64870997
+  metadata.gz: f259ccc84f8f3054aa71d41ea715115b7609e1c1409160caa09e67e25a39636d
+  data.tar.gz: 5957bae80c3e6f7199af8cbe46aae633cf3844b4b85c6e931f0bf16cd7cfc685
 SHA512:
-  metadata.gz: 93841c24e1ba681727532961006a2ea959dece477c1b7419d09acfc322893e25eab178efe282bc1c250363c7e001fcd8af337ec0ce36b7a106be459b48c498bd
-  data.tar.gz: 1aeb7d43eea7c6d2aac1e08a28ac2cc6aacc6f82c6cd57929c240a4880f3ae4fd25cd2b87eef65dc51169949858c5696926b2d71d698db44952946e141ae4ac6
+  metadata.gz: 855144d9889261c9ac7a4fe39063f743e1750e4fef940ce4c3369f919b322fa6f706e35fa4b19cd8797dff45df6c50008cc6d75601f3404619acced5ac8abd95
+  data.tar.gz: 9ea8a4f84ffc277e4cd94b6a5ee20f5bafdbf39b6562869f70f13c88ea63d44d6917789122273af17b9394ff58118d930875a6ce00207be2fc8fbb7f97285ab8

data/lib/runapi/suno/contract_gen.rb

@@ -544,11 +544,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)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-suno
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.2.9
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.10
+        version: 0.2.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.10
+        version: 0.2.13
 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