runapi-suno 0.2.10 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e778eebc0d01b454f8a2187126173625cd0c14925a2e238eef0a1015e8ff6a0c
-  data.tar.gz: 404e68c9d3e9673d9ac80d393d6cebea8a4482e055f3b37de6f3961919712690
+  metadata.gz: 255e9261a9f3bd30fd2a10f7ead347008a2933aac0593150828551b624e0841c
+  data.tar.gz: 514d9027b71e6b4b4db6993de72c1031801a3aa640ef93272f82cfc35d8cbfe6
 SHA512:
-  metadata.gz: 9a7ac2a46590a7869002485d2a8fb9e27bea5866a480ae3d70fbf3cf0bc6367d13cb5801fd12a30d86feeed15fd3fb0ffc06361f2fea59f9e96cbbb6398e2356
-  data.tar.gz: 3dedafb65dada78f0c75ec572778813477fa44c24ab314de55f278c58dc0aa2fed613e26efc3834b5a273592398ec01c36eaea6bbef5a9d0eff02353d57fb097
+  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" => {
@@ -474,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.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.10
+  version: 0.3.0
 platform: ruby
 authors:
 - RunAPI
@@ -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