runapi-suno 0.2.10 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e778eebc0d01b454f8a2187126173625cd0c14925a2e238eef0a1015e8ff6a0c
-  data.tar.gz: 404e68c9d3e9673d9ac80d393d6cebea8a4482e055f3b37de6f3961919712690
+  metadata.gz: a4e3a244b100dfe8f71e8ea593668fe9e777e12f95185c9c8a41867242d0f05c
+  data.tar.gz: 2c6b07235af6757253bff62842f07b62caa11692db5831d3be68360d2d8e888d
 SHA512:
-  metadata.gz: 9a7ac2a46590a7869002485d2a8fb9e27bea5866a480ae3d70fbf3cf0bc6367d13cb5801fd12a30d86feeed15fd3fb0ffc06361f2fea59f9e96cbbb6398e2356
-  data.tar.gz: 3dedafb65dada78f0c75ec572778813477fa44c24ab314de55f278c58dc0aa2fed613e26efc3834b5a273592398ec01c36eaea6bbef5a9d0eff02353d57fb097
+  metadata.gz: 9b0cf789e74b7fde42b3e6e83c672d0e3aea9c3f540e318c179e3ea86d0d90df4fd7fa6b834b4b95061cb7dad1b0708ad17f4fc7ae6ab833b3f5f91ac18ddb22
+  data.tar.gz: d11014c15425b11b120a0c4634e5deae5e5ac85abf8e217ed527f02f23a2d176ceb7a39d11d99ad004da0d2a129118ba6b877d3ec446faa6e50ac9773e700411

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,12 +193,18 @@ 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 }]
         optional :waveform_data, [Numeric]
         optional :hoot_cer, Numeric
         optional :is_streamed
+        optional :billing, RunApi::Core::TaskBillingFacts
       end
 
       # Result of a section replacement task.
@@ -211,12 +217,14 @@ module RunApi
       class GeneratePersonaResponse < RunApi::Core::BaseModel
         required :persona, -> { Persona }
         optional :error, String
+        optional :billing, RunApi::Core::TaskBillingFacts
       end
 
       # Synchronous result of style tag generation. +style+ contains the generated tags string.
       class BoostStyleResponse < RunApi::Core::BaseModel
         optional :style, String
         optional :error, String
+        optional :billing, RunApi::Core::TaskBillingFacts
       end
 
       # Result of a mashup task.
@@ -241,6 +249,7 @@ module RunApi
       class CheckVoiceResponse < RunApi::Core::BaseModel
         optional :is_available
         optional :error, String
+        optional :billing, RunApi::Core::TaskBillingFacts
       end
 
       class CompletedTextToMusicResponse < TextToMusicResponse
@@ -287,6 +296,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.1
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.14
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.14
+        version: 0.3.0
 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
@@ -87,7 +88,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
 summary: Suno API Ruby SDK for RunAPI
 test_files: []