runapi-suno 0.2.9 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f259ccc84f8f3054aa71d41ea715115b7609e1c1409160caa09e67e25a39636d
-  data.tar.gz: 5957bae80c3e6f7199af8cbe46aae633cf3844b4b85c6e931f0bf16cd7cfc685
+  metadata.gz: 255e9261a9f3bd30fd2a10f7ead347008a2933aac0593150828551b624e0841c
+  data.tar.gz: 514d9027b71e6b4b4db6993de72c1031801a3aa640ef93272f82cfc35d8cbfe6
 SHA512:
-  metadata.gz: 855144d9889261c9ac7a4fe39063f743e1750e4fef940ce4c3369f919b322fa6f706e35fa4b19cd8797dff45df6c50008cc6d75601f3404619acced5ac8abd95
-  data.tar.gz: 9ea8a4f84ffc277e4cd94b6a5ee20f5bafdbf39b6562869f70f13c88ea63d44d6917789122273af17b9394ff58118d930875a6ce00207be2fc8fbb7f97285ab8
+  metadata.gz: e3643f48ee51d9566c3e9217e075796140944ec5f16e56f4bddd2778d50bd017e892355d6c01287f6d6829477e56a9cfafba402b37a56e48f1da542ed1ff8da5
+  data.tar.gz: 8bdb7ebaf3f9664e165ca5ab8134cf95c726dcd9b57738e041ad33c51be79cc600eb70748b0fc35ced7dad393dd9f7f0b0c24f8b38b868c0b6ee939f3349045f

data/README.md

@@ -28,7 +28,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Language notes
 
-Use Ruby keyword arguments and the `RunApi::Suno` error classes when building music jobs, Rails workers, or scripts. The available resources are `text_to_music`, `extend_music`, `generate_artwork`, `cover_audio`, `add_instrumental`, `add_vocals`, `separate_audio_stems`, `generate_midi`, `convert_audio`, `visualize_music`, `generate_lyrics`, `get_timestamped_lyrics`, `replace_section`, `create_mashup`, `text_to_sound`, `voice_to_validation_phrase`, `regenerate_validation_phrase`, `generate_voice`, `check_voice`, `generate_persona`, and `boost_style`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
+Use Ruby keyword arguments and the `RunApi::Suno` error classes when building music jobs, Rails workers, or scripts. The available resources are `text_to_music`, `extend_music`, `generate_artwork`, `cover_audio`, `add_instrumental`, `add_vocals`, `separate_audio_stems`, `generate_midi`, `convert_audio`, `visualize_music`, `generate_lyrics`, `blend_lyrics`, `get_timestamped_lyrics`, `replace_section`, `create_mashup`, `text_to_sound`, `voice_to_validation_phrase`, `regenerate_validation_phrase`, `generate_voice`, `check_voice`, `generate_persona`, and `boost_style`. Keep `RUNAPI_API_KEY` in the environment or your secret manager; never commit API keys or callback secrets.
 
 ## Links
 

data/lib/runapi/suno/client.rb

@@ -34,6 +34,8 @@ module RunApi
       attr_reader :visualize_music
       # @return [Resources::GenerateLyrics] produces AI-generated lyrics from a text prompt
       attr_reader :generate_lyrics
+      # @return [Resources::BlendLyrics] blends two caller-authored lyrics texts
+      attr_reader :blend_lyrics
       # @return [Resources::GetTimestampedLyrics] retrieves word-level timing alignment for a track (synchronous)
       attr_reader :get_timestamped_lyrics
       # @return [Resources::ReplaceSection] re-generates a time range within an existing track
@@ -69,6 +71,7 @@ module RunApi
         @convert_audio = Resources::ConvertAudio.new(http)
         @visualize_music = Resources::VisualizeMusic.new(http)
         @generate_lyrics = Resources::GenerateLyrics.new(http)
+        @blend_lyrics = Resources::BlendLyrics.new(http)
         @get_timestamped_lyrics = Resources::GetTimestampedLyrics.new(http)
         @replace_section = Resources::ReplaceSection.new(http)
         @create_mashup = Resources::CreateMashup.new(http)

data/lib/runapi/suno/contract_gen.rb

@@ -74,6 +74,19 @@ module RunApi
           }
         }
       },
+      "blend-lyrics" => {
+        "models" => [],
+        "fields_by_model" => {
+          "_" => {
+            "lyrics_a" => {
+              "required" => true
+            },
+            "lyrics_b" => {
+              "required" => true
+            }
+          }
+        }
+      },
       "boost-style" => {
         "models" => [],
         "fields_by_model" => {
@@ -239,7 +252,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 +272,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 +292,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 +312,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 +332,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 +352,9 @@ module RunApi
               "enum" => ["style", "voice"]
             },
             "upload_url_list" => {
-              "required" => true
+              "required" => true,
+              "min_items" => 2,
+              "max_items" => 2
             },
             "vocal_gender" => {
               "enum" => ["male", "female"]
@@ -462,7 +487,11 @@ module RunApi
       "generate-lyrics" => {
         "models" => [],
         "fields_by_model" => {
-          "_" => {}
+          "_" => {
+            "prompt" => {
+              "required" => true
+            }
+          }
         }
       },
       "generate-midi" => {

data/lib/runapi/suno/resources/blend_lyrics.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Suno
+    module Resources
+      # Blends two caller-authored lyrics texts into a new lyrics result.
+      class BlendLyrics
+        include RunApi::Core::ResourceHelpers
+
+        ENDPOINT = "/api/v1/suno/blend_lyrics"
+        RESPONSE_CLASS = Types::BlendLyricsResponse
+        COMPLETED_RESPONSE_CLASS = Types::CompletedBlendLyricsResponse
+
+        def initialize(http)
+          @http = http
+        end
+
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
+        end
+
+        def create(options: nil, **params)
+          params = compact_params(params)
+          validate_contract!(CONTRACT["blend-lyrics"], params)
+          request(:post, ENDPOINT, body: params, options: options)
+        end
+
+        def get(id, options: nil)
+          request(:get, "#{ENDPOINT}/#{id}", options: options)
+        end
+      end
+    end
+  end
+end

data/lib/runapi/suno/types.rb

@@ -193,6 +193,11 @@ module RunApi
         optional :lyrics, [-> { Lyric }]
       end
 
+      # Result of a lyrics blending task.
+      class BlendLyricsResponse < AsyncTaskResponse
+        optional :lyrics, [-> { Lyric }]
+      end
+
       # Synchronous response containing word-level timing data and waveform for a track.
       class GetTimestampedLyricsResponse < RunApi::Core::BaseModel
         optional :aligned_words, [-> { AlignedWord }]
@@ -287,6 +292,10 @@ module RunApi
         required :lyrics, [-> { Lyric }]
       end
 
+      class CompletedBlendLyricsResponse < BlendLyricsResponse
+        required :lyrics, [-> { Lyric }]
+      end
+
       class CompletedReplaceSectionResponse < ReplaceSectionResponse
         required :track, -> { Audio }
       end

data/lib/runapi/suno/validators.rb

@@ -88,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
 

data/lib/runapi/suno.rb

@@ -15,6 +15,7 @@ require_relative "suno/resources/generate_midi"
 require_relative "suno/resources/convert_audio"
 require_relative "suno/resources/visualize_music"
 require_relative "suno/resources/generate_lyrics"
+require_relative "suno/resources/blend_lyrics"
 require_relative "suno/resources/get_timestamped_lyrics"
 require_relative "suno/resources/replace_section"
 require_relative "suno/resources/create_mashup"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-suno
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.0
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.13
+        version: 0.2.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.13
+        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
@@ -42,6 +42,7 @@ files:
 - lib/runapi/suno/contract_gen.rb
 - lib/runapi/suno/resources/add_instrumental.rb
 - lib/runapi/suno/resources/add_vocals.rb
+- lib/runapi/suno/resources/blend_lyrics.rb
 - lib/runapi/suno/resources/boost_style.rb
 - lib/runapi/suno/resources/check_voice.rb
 - lib/runapi/suno/resources/convert_audio.rb