runapi-suno 0.1.2__tar.gz → 0.2.0__tar.gz

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/PKG-INFO

@@ -1,18 +1,18 @@
 Metadata-Version: 2.4
 Name: runapi-suno
-Version: 0.1.2
-Summary: RunAPI Suno SDK for text-to-music, cover audio, music extension, stem separation, voice validation phrase, custom voice, and related audio workflows in JavaScript, Python, Ruby, Go, Java, and PHP
+Version: 0.2.0
+Summary: RunAPI Suno SDK for text-to-music, lyric generation and blending, cover audio, music extension, stem separation, voice validation phrase, custom voice, and related audio workflows in JavaScript, Python, Ruby, Go, Java, and PHP
 Project-URL: Homepage, https://runapi.ai/models/suno
 Project-URL: Documentation, https://runapi.ai/docs#sdk-suno
 Project-URL: Source, https://github.com/runapi-ai/suno-sdk
 Project-URL: Issues, https://github.com/runapi-ai/suno-sdk/issues
 Project-URL: Changelog, https://github.com/runapi-ai/suno-sdk/blob/main/CHANGELOG.md
-Project-URL: Release Notes, https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.1.2
+Project-URL: Release Notes, https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.2.0
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
 Keywords: api,audio-generation,golang,gradle,java,maven,music-api,music-generation,python,ruby,runapi,runapi-ai,sdk,suno,suno-ai-api,typescript
 Requires-Python: >=3.9
-Requires-Dist: runapi-core>=0.2.0
+Requires-Dist: runapi-core>=0.2.2
 Description-Content-Type: text/markdown
 
 # Suno API Python SDK for RunAPI
@@ -45,6 +45,12 @@ print(result.audios[0].audio_url)
 # Generate lyrics from a prompt.
 lyrics = client.generate_lyrics.run(prompt="a song about the ocean at night")
 print(lyrics.lyrics[0].text)
+
+blended = client.blend_lyrics.run(
+    lyrics_a="[Verse]\nCity lights fade into dawn",
+    lyrics_b="[Chorus]\nWe rise with the morning sun",
+)
+print(blended.lyrics[0].text)
 ```
 
 Use `create` to submit a task and return quickly, `get` to fetch the latest task state, and `run` when a script should create and poll until completion:
@@ -65,7 +71,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Language notes
 
-Pass parameters as keyword arguments and catch the `runapi.suno` error classes when building music jobs 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.
+Pass parameters as keyword arguments and catch the `runapi.suno` error classes when building music jobs 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
 

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/README.md

@@ -28,6 +28,12 @@ print(result.audios[0].audio_url)
 # Generate lyrics from a prompt.
 lyrics = client.generate_lyrics.run(prompt="a song about the ocean at night")
 print(lyrics.lyrics[0].text)
+
+blended = client.blend_lyrics.run(
+    lyrics_a="[Verse]\nCity lights fade into dawn",
+    lyrics_b="[Chorus]\nWe rise with the morning sun",
+)
+print(blended.lyrics[0].text)
 ```
 
 Use `create` to submit a task and return quickly, `get` to fetch the latest task state, and `run` when a script should create and poll until completion:
@@ -48,7 +54,7 @@ RunAPI-generated file URLs are temporary. Download and store generated images, v
 
 ## Language notes
 
-Pass parameters as keyword arguments and catch the `runapi.suno` error classes when building music jobs 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.
+Pass parameters as keyword arguments and catch the `runapi.suno` error classes when building music jobs 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
 

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runapi-suno"
-version = "0.1.2"
-description = "RunAPI Suno SDK for text-to-music, cover audio, music extension, stem separation, voice validation phrase, custom voice, and related audio workflows in JavaScript, Python, Ruby, Go, Java, and PHP"
+version = "0.2.0"
+description = "RunAPI Suno SDK for text-to-music, lyric generation and blending, cover audio, music extension, stem separation, voice validation phrase, custom voice, and related audio workflows in JavaScript, Python, Ruby, Go, Java, and PHP"
 readme = "README.md"
 requires-python = ">=3.9"
 license = "Apache-2.0"
 authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
 keywords = ["runapi", "runapi-ai", "suno", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "maven", "gradle", "music-generation", "audio-generation", "music-api", "suno-ai-api"]
-dependencies = ["runapi-core>=0.2.0"]
+dependencies = ["runapi-core>=0.2.2"]
 
 [project.urls]
 Homepage = "https://runapi.ai/models/suno"
@@ -19,7 +19,7 @@ Documentation = "https://runapi.ai/docs#sdk-suno"
 Source = "https://github.com/runapi-ai/suno-sdk"
 Issues = "https://github.com/runapi-ai/suno-sdk/issues"
 Changelog = "https://github.com/runapi-ai/suno-sdk/blob/main/CHANGELOG.md"
-"Release Notes" = "https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.1.2"
+"Release Notes" = "https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.2.0"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/runapi"]

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/src/runapi/suno/client.py

@@ -9,6 +9,7 @@ from runapi.core import ClientOptions, HttpClient, resolve_api_key
 from .resources.add_instrumental import AddInstrumental
 from .resources.add_vocals import AddVocals
 from .resources.boost_style import BoostStyle
+from .resources.blend_lyrics import BlendLyrics
 from .resources.check_voice import CheckVoice
 from .resources.convert_audio import ConvertAudio
 from .resources.cover_audio import CoverAudio
@@ -58,6 +59,7 @@ class SunoClient:
         self.convert_audio = ConvertAudio(http)
         self.visualize_music = VisualizeMusic(http)
         self.generate_lyrics = GenerateLyrics(http)
+        self.blend_lyrics = BlendLyrics(http)
         self.get_timestamped_lyrics = GetTimestampedLyrics(http)
         self.replace_section = ReplaceSection(http)
         self.create_mashup = CreateMashup(http)

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/src/runapi/suno/contract_gen.py

@@ -70,6 +70,19 @@ CONTRACT = {
             }
         }
     },
+    "blend-lyrics": {
+        "models": [],
+        "fields_by_model": {
+            "_": {
+                "lyrics_a": {
+                    "required": True
+                },
+                "lyrics_b": {
+                    "required": True
+                }
+            }
+        }
+    },
     "boost-style": {
         "models": [],
         "fields_by_model": {
@@ -235,7 +248,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -253,7 +268,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -271,7 +288,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -289,7 +308,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -307,7 +328,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -325,7 +348,9 @@ CONTRACT = {
                     "enum": ["style", "voice"]
                 },
                 "upload_url_list": {
-                    "required": True
+                    "required": True,
+                    "min_items": 2,
+                    "max_items": 2
                 },
                 "vocal_gender": {
                     "enum": ["male", "female"]
@@ -458,7 +483,11 @@ CONTRACT = {
     "generate-lyrics": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "prompt": {
+                    "required": True
+                }
+            }
         }
     },
     "generate-midi": {

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/src/runapi/suno/resources/__init__.py

@@ -1,6 +1,7 @@
 from .add_instrumental import AddInstrumental
 from .add_vocals import AddVocals
 from .boost_style import BoostStyle
+from .blend_lyrics import BlendLyrics
 from .check_voice import CheckVoice
 from .convert_audio import ConvertAudio
 from .cover_audio import CoverAudio
@@ -32,6 +33,7 @@ __all__ = [
     "ConvertAudio",
     "VisualizeMusic",
     "GenerateLyrics",
+    "BlendLyrics",
     "GetTimestampedLyrics",
     "ReplaceSection",
     "CreateMashup",

runapi_suno-0.2.0/src/runapi/suno/resources/blend_lyrics.py

@@ -0,0 +1,30 @@
+"""Suno blend_lyrics resource."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from runapi.core import RequestOptions, Resource
+
+from ..contract_gen import CONTRACT
+from ..types import BlendLyricsResponse, CompletedBlendLyricsResponse
+
+
+class BlendLyrics(Resource):
+    """Blend two caller-authored lyrics texts."""
+
+    ENDPOINT = "/api/v1/suno/blend_lyrics"
+    RESPONSE_CLASS = BlendLyricsResponse
+    COMPLETED_RESPONSE_CLASS = CompletedBlendLyricsResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        task = self.create(options=options, **params)
+        return self._poll_until_complete(lambda: self.get(task.id, options=options))
+
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["blend-lyrics"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted, options=options)
+
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/src/runapi/suno/resources/create_mashup.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from typing import Any, Dict, Optional
 
-from runapi.core import Resource, ValidationError, RequestOptions
+from runapi.core import Resource, RequestOptions
 
 from ..contract_gen import CONTRACT
 from ..types import CompletedCreateMashupResponse, CreateMashupResponse
@@ -55,7 +55,4 @@ class CreateMashup(Resource):
         return self._request("get", f"{self.ENDPOINT}/{id}", options=options)
 
     def _validate_params(self, params: Dict[str, Any]) -> None:
-        upload_url_list = params.get("upload_url_list")
-        if not (isinstance(upload_url_list, list) and len(upload_url_list) == 2):
-            raise ValidationError("upload_url_list must contain exactly 2 URLs")
         self._validate_contract(CONTRACT["create-mashup"], params)

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/src/runapi/suno/types.py

@@ -228,6 +228,12 @@ class GenerateLyricsResponse(AsyncTaskResponse):
     lyrics = optional([lambda: Lyric])
 
 
+class BlendLyricsResponse(AsyncTaskResponse):
+    """Suno lyrics blending task status response."""
+
+    lyrics = optional([lambda: Lyric])
+
+
 class GetTimestampedLyricsResponse(BaseModel):
     """Suno timestamped-lyrics result."""
 
@@ -352,6 +358,12 @@ class CompletedGenerateLyricsResponse(GenerateLyricsResponse):
     lyrics = required([lambda: Lyric])
 
 
+class CompletedBlendLyricsResponse(BlendLyricsResponse):
+    """Narrowed lyrics blending response once polling observes completion."""
+
+    lyrics = required([lambda: Lyric])
+
+
 class CompletedReplaceSectionResponse(ReplaceSectionResponse):
     """Narrowed replace-section response once polling observes completion."""
 

{runapi_suno-0.1.2 → runapi_suno-0.2.0}/tests/test_client.py

@@ -80,6 +80,7 @@ def test_exposes_all_resource_accessors():
         "convert_audio": R.ConvertAudio,
         "visualize_music": R.VisualizeMusic,
         "generate_lyrics": R.GenerateLyrics,
+        "blend_lyrics": R.BlendLyrics,
         "get_timestamped_lyrics": R.GetTimestampedLyrics,
         "replace_section": R.ReplaceSection,
         "create_mashup": R.CreateMashup,
@@ -91,7 +92,7 @@ def test_exposes_all_resource_accessors():
         "generate_persona": R.GeneratePersona,
         "boost_style": R.BoostStyle,
     }
-    assert len(expected) == 21
+    assert len(expected) == 22
     for name, cls in expected.items():
         assert isinstance(getattr(client, name), cls), name
 
@@ -122,6 +123,24 @@ def test_get_fetches_by_id():
     assert fake.calls == [("get", "/api/v1/suno/text_to_music/t1", None)]
 
 
+def test_blend_lyrics_posts_flat_lyrics_pair():
+    fake = FakeHttp({"id": "blend_1", "status": "processing"})
+    client = SunoClient(api_key="k", http_client=fake)
+
+    client.blend_lyrics.create(lyrics_a="First verse", lyrics_b="Second verse")
+
+    assert fake.calls == [
+        ("post", "/api/v1/suno/blend_lyrics", {"lyrics_a": "First verse", "lyrics_b": "Second verse"}),
+    ]
+
+
+def test_blend_lyrics_requires_both_lyrics_texts():
+    client = SunoClient(api_key="k", http_client=FakeHttp())
+
+    with pytest.raises(ValidationError, match="lyrics_b"):
+        client.blend_lyrics.create(lyrics_a="First verse")
+
+
 def test_run_narrows_completed_type():
     fake = FakeHttp(
         {"id": "t1", "status": "pending"},
@@ -326,7 +345,7 @@ def test_replace_section_rejects_mixed_sources():
 
 def test_create_mashup_requires_two_urls():
     client = SunoClient(api_key="k", http_client=FakeHttp())
-    with pytest.raises(ValidationError, match="upload_url_list must contain exactly 2 URLs"):
+    with pytest.raises(ValidationError, match="upload_url_list must contain between 2 and 2 items"):
         client.create_mashup.create(upload_url_list=["only-one"], model="suno-v5")