runapi-suno 0.3.2 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38f1f7c4c8dfc3ae057f27b46e3a12fb9ef1dabc21f2e7326b5bbfd264c02a5a
-  data.tar.gz: b09ce08b5734ad22f5cc68c6339e3ec68d21d7c0530228c9b25261224f9f08c8
+  metadata.gz: 630d71197a7fcf7095fcb931f3abc7f7850c6885529182f95e628ce656328547
+  data.tar.gz: 48f37a1cfcc2a1a9e84301bfb33f0456fd66b1ea05222ceb2667f5bb234cda13
 SHA512:
-  metadata.gz: 58d85f17b750573729801b93041b729d2ba27c994cbb1d67f6066eded3624527fb0bb5aa3b2106dc06a735148849de209016b4bc577859b00592451c1d4b969c
-  data.tar.gz: 135b5ab665b08462083d1dce9c6a35f65ec1ac10e011f132e347f7ca905cd66a859c99101babdb70be702fc1644316735653105b891058c7f4692afec3cd8ea7
+  metadata.gz: 2193600b0a619cd7915399d71cbc9ef709bea0ab06f5c35ebbb0d9b740c30eaf3ec45e5ec96053579ed184faa14e4f36113a66ea7cd28af8a038ae160db8c742
+  data.tar.gz: 3431976bfe70f5410c6e04b06b2ee6fcf09cae4fa45986eed5488b0155e7f14cf977431b0751b0dcdaef939edd38964410ba4156525a4f66f41929182afdfda0

data/README.md

@@ -2,7 +2,7 @@
 
 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 RunAPI errors in Ruby.
 
-This README is the Ruby package guide inside the public `suno-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/suno; for API reference, use https://runapi.ai/docs#suno; for SDK docs, use https://runapi.ai/docs#sdk-suno.
+This README is the Ruby package guide inside the public `suno-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/suno; for API reference, use https://runapi.ai/docs/api/suno/text-to-music; for SDK docs, use https://runapi.ai/docs/resources/sdks.
 
 ## Install
 
@@ -17,7 +17,7 @@ require "runapi/suno"
 
 client = RunApi::Suno::Client.new
 task = client.text_to_music.create(
-  # Pass the Suno JSON request body from https://runapi.ai/docs#suno.
+  # Pass the Suno JSON request body from https://runapi.ai/docs/api/suno/text-to-music.
 )
 status = client.text_to_music.get(task.id)
 ```
@@ -33,8 +33,8 @@ Use Ruby keyword arguments and the `RunApi::Suno` error classes when building mu
 ## Links
 
 - Model page: https://runapi.ai/models/suno
-- SDK docs: https://runapi.ai/docs#sdk-suno
-- Product docs: https://runapi.ai/docs#suno
+- SDK docs: https://runapi.ai/docs/resources/sdks
+- Product docs: https://runapi.ai/docs/api/suno/text-to-music
 - Pricing and rate limits: https://runapi.ai/models/suno/v4
 - Provider comparison: https://runapi.ai/providers/suno
 - Full catalog: https://runapi.ai/models

data/lib/runapi/suno/client.rb

@@ -16,6 +16,7 @@ module RunApi
       attr_reader :text_to_music
       # @return [Resources::ExtendMusic] continues an existing track from a specified timestamp
       attr_reader :extend_music
+      attr_reader :stitch_audio, :remaster_audio, :add_samples
       # @return [Resources::GenerateArtwork] creates cover artwork for an existing music task
       attr_reader :generate_artwork
       # @return [Resources::CoverAudio] re-records vocals over an uploaded audio file with a new style or voice
@@ -62,6 +63,9 @@ module RunApi
 
         @text_to_music = Resources::TextToMusic.new(http)
         @extend_music = Resources::ExtendMusic.new(http)
+        @stitch_audio = Resources::StitchAudio.new(http)
+        @remaster_audio = Resources::RemasterAudio.new(http)
+        @add_samples = Resources::AddSamples.new(http)
         @generate_artwork = Resources::GenerateArtwork.new(http)
         @cover_audio = Resources::CoverAudio.new(http)
         @add_instrumental = Resources::AddInstrumental.new(http)

data/lib/runapi/suno/contract_gen.rb

@@ -68,6 +68,91 @@ module RunApi
           }
         }
       },
+      "add-samples" => {
+        "models" => ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model" => {
+          "suno-v4" => {
+            "audio_url" => {
+              "required" => true
+            },
+            "end_seconds" => {
+              "required" => true,
+              "min" => 0
+            },
+            "model" => {
+              "required" => true
+            },
+            "start_seconds" => {
+              "required" => true,
+              "min" => 0
+            }
+          },
+          "suno-v4.5" => {
+            "audio_url" => {
+              "required" => true
+            },
+            "end_seconds" => {
+              "required" => true,
+              "min" => 0
+            },
+            "model" => {
+              "required" => true
+            },
+            "start_seconds" => {
+              "required" => true,
+              "min" => 0
+            }
+          },
+          "suno-v4.5-plus" => {
+            "audio_url" => {
+              "required" => true
+            },
+            "end_seconds" => {
+              "required" => true,
+              "min" => 0
+            },
+            "model" => {
+              "required" => true
+            },
+            "start_seconds" => {
+              "required" => true,
+              "min" => 0
+            }
+          },
+          "suno-v5" => {
+            "audio_url" => {
+              "required" => true
+            },
+            "end_seconds" => {
+              "required" => true,
+              "min" => 0
+            },
+            "model" => {
+              "required" => true
+            },
+            "start_seconds" => {
+              "required" => true,
+              "min" => 0
+            }
+          },
+          "suno-v5.5" => {
+            "audio_url" => {
+              "required" => true
+            },
+            "end_seconds" => {
+              "required" => true,
+              "min" => 0
+            },
+            "model" => {
+              "required" => true
+            },
+            "start_seconds" => {
+              "required" => true,
+              "min" => 0
+            }
+          }
+        }
+      },
       "add-vocals" => {
         "models" => ["suno-v4.5-plus", "suno-v5"],
         "fields_by_model" => {
@@ -624,6 +709,66 @@ module RunApi
           }
         }
       },
+      "remaster-audio" => {
+        "models" => ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model" => {
+          "suno-v4" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v4.5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v4.5-plus" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v5.5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          }
+        }
+      },
       "replace-section" => {
         "models" => [],
         "fields_by_model" => {
@@ -677,11 +822,73 @@ module RunApi
           "required" => ["stem_name"]
         }]
       },
+      "stitch-audio" => {
+        "models" => ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model" => {
+          "suno-v4" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v4.5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v4.5-plus" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          },
+          "suno-v5.5" => {
+            "audio_id" => {
+              "required" => true
+            },
+            "model" => {
+              "required" => true
+            },
+            "source_task_id" => {
+              "required" => true
+            }
+          }
+        }
+      },
       "text-to-music" => {
         "models" => ["suno-v4", "suno-v4.5", "suno-v4.5-all", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
         "fields_by_model" => {
           "suno-v4" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -700,6 +907,8 @@ module RunApi
           },
           "suno-v4.5" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -718,6 +927,8 @@ module RunApi
           },
           "suno-v4.5-all" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -736,6 +947,8 @@ module RunApi
           },
           "suno-v4.5-plus" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -754,6 +967,8 @@ module RunApi
           },
           "suno-v5" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -772,6 +987,8 @@ module RunApi
           },
           "suno-v5.5" => {
             "duration_seconds" => {
+              "min" => 10,
+              "max" => 360,
               "type" => "integer"
             },
             "model" => {
@@ -794,7 +1011,7 @@ module RunApi
             "vocal_mode" => "auto_lyrics"
           },
           "required" => ["prompt"],
-          "forbidden" => ["lyrics", "style", "title"]
+          "forbidden" => ["lyrics", "style", "title", "negative_tags", "vocal_gender", "duration_seconds"]
         }, {
           "when" => {
             "vocal_mode" => "exact_lyrics"
@@ -806,7 +1023,32 @@ module RunApi
             "vocal_mode" => "instrumental"
           },
           "required" => ["style", "title"],
-          "forbidden" => ["prompt", "lyrics"]
+          "forbidden" => ["prompt", "lyrics", "vocal_gender"]
+        }, {
+          "when" => {
+            "model" => "suno-v4"
+          },
+          "forbidden" => ["duration_seconds"]
+        }, {
+          "when" => {
+            "model" => "suno-v4.5"
+          },
+          "forbidden" => ["duration_seconds"]
+        }, {
+          "when" => {
+            "model" => "suno-v4.5-all"
+          },
+          "forbidden" => ["duration_seconds"]
+        }, {
+          "when" => {
+            "model" => "suno-v4.5-plus"
+          },
+          "forbidden" => ["duration_seconds"]
+        }, {
+          "when" => {
+            "model" => "suno-v5"
+          },
+          "forbidden" => ["duration_seconds"]
         }]
       },
       "text-to-sound" => {

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

@@ -0,0 +1,18 @@
+module RunApi
+  module Suno
+    module Resources
+      class AddSamples < AudioAction
+        ENDPOINT = "/api/v1/suno/add_samples"
+        ACTION = "add-samples"
+
+        def create(options: nil, **params)
+          if params[:end_seconds].to_f <= params[:start_seconds].to_f
+            raise RunApi::Core::ValidationError, "end_seconds must be greater than start_seconds"
+          end
+
+          super
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Suno
+    module Resources
+      class AudioAction
+        include RunApi::Core::ResourceHelpers
+
+        def initialize(http) = @http = http
+
+        def create(options: nil, **params)
+          params = compact_params(params)
+          validate_contract!(CONTRACT.fetch(self.class::ACTION), params)
+          request(:post, self.class::ENDPOINT, body: params, options: options)
+        end
+
+        def get(id, options: nil) = request(:get, "#{self.class::ENDPOINT}/#{id}", options: options)
+
+        def run(options: nil, **params)
+          task = create(options: options, **params)
+          poll_until_complete { get(task.id, options: options) }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module RunApi
+  module Suno
+    module Resources
+      class RemasterAudio < AudioAction
+        ENDPOINT = "/api/v1/suno/remaster_audio"
+        ACTION = "remaster-audio"
+        def create(options: nil, **params) = super
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+module RunApi
+  module Suno
+    module Resources
+      class StitchAudio < AudioAction
+        ENDPOINT = "/api/v1/suno/stitch_audio"
+        ACTION = "stitch-audio"
+        def create(options: nil, **params) = super
+      end
+    end
+  end
+end

data/lib/runapi/suno.rb

@@ -6,6 +6,10 @@ require_relative "suno/contract_gen"
 require_relative "suno/validators"
 require_relative "suno/resources/text_to_music"
 require_relative "suno/resources/extend_music"
+require_relative "suno/resources/audio_action"
+require_relative "suno/resources/stitch_audio"
+require_relative "suno/resources/remaster_audio"
+require_relative "suno/resources/add_samples"
 require_relative "suno/resources/generate_artwork"
 require_relative "suno/resources/cover_audio"
 require_relative "suno/resources/add_instrumental"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-suno
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.4
 platform: ruby
 authors:
 - RunAPI
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.3.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: 0.3.3
 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
@@ -41,7 +41,9 @@ files:
 - lib/runapi/suno/client.rb
 - lib/runapi/suno/contract_gen.rb
 - lib/runapi/suno/resources/add_instrumental.rb
+- lib/runapi/suno/resources/add_samples.rb
 - lib/runapi/suno/resources/add_vocals.rb
+- lib/runapi/suno/resources/audio_action.rb
 - lib/runapi/suno/resources/blend_lyrics.rb
 - lib/runapi/suno/resources/boost_style.rb
 - lib/runapi/suno/resources/check_voice.rb
@@ -56,8 +58,10 @@ files:
 - lib/runapi/suno/resources/generate_voice.rb
 - lib/runapi/suno/resources/get_timestamped_lyrics.rb
 - lib/runapi/suno/resources/regenerate_validation_phrase.rb
+- lib/runapi/suno/resources/remaster_audio.rb
 - lib/runapi/suno/resources/replace_section.rb
 - lib/runapi/suno/resources/separate_audio_stems.rb
+- lib/runapi/suno/resources/stitch_audio.rb
 - lib/runapi/suno/resources/text_to_music.rb
 - lib/runapi/suno/resources/text_to_sound.rb
 - lib/runapi/suno/resources/visualize_music.rb