runapi-suno 0.3.0__tar.gz → 0.3.2__tar.gz

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/PKG-INFO

@@ -1,25 +1,25 @@
 Metadata-Version: 2.4
 Name: runapi-suno
-Version: 0.3.0
+Version: 0.3.2
 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: Documentation, https://runapi.ai/docs/resources/sdks
 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.3.0
+Project-URL: Release Notes, https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.3.2
 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.3.0
+Requires-Dist: runapi-core>=0.3.6
 Description-Content-Type: text/markdown
 
 # Suno API Python SDK for RunAPI
 
 The Suno Python 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 Python.
 
-This README is the Python 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 Python 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
 
@@ -76,8 +76,8 @@ Pass parameters as keyword arguments and catch the `runapi.suno` error classes w
 ## 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

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/README.md

@@ -2,7 +2,7 @@
 
 The Suno Python 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 Python.
 
-This README is the Python 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 Python 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
 
@@ -59,8 +59,8 @@ Pass parameters as keyword arguments and catch the `runapi.suno` error classes w
 ## 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

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/pyproject.toml

@@ -4,22 +4,22 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runapi-suno"
-version = "0.3.0"
+version = "0.3.2"
 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.3.0"]
+dependencies = ["runapi-core>=0.3.6"]
 
 [project.urls]
 Homepage = "https://runapi.ai/models/suno"
-Documentation = "https://runapi.ai/docs#sdk-suno"
+Documentation = "https://runapi.ai/docs/resources/sdks"
 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.3.0"
+"Release Notes" = "https://github.com/runapi-ai/suno-sdk/releases/tag/python%2Fv0.3.2"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/runapi"]

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/src/runapi/suno/client.py

@@ -8,6 +8,9 @@ from runapi.core import ProviderClient
 
 from .resources.add_instrumental import AddInstrumental
 from .resources.add_vocals import AddVocals
+from .resources.add_samples import AddSamples
+from .resources.remaster_audio import RemasterAudio
+from .resources.stitch_audio import StitchAudio
 from .resources.boost_style import BoostStyle
 from .resources.blend_lyrics import BlendLyrics
 from .resources.check_voice import CheckVoice
@@ -53,6 +56,9 @@ class SunoClient(ProviderClient):
         self.cover_audio = CoverAudio(http)
         self.add_instrumental = AddInstrumental(http)
         self.add_vocals = AddVocals(http)
+        self.add_samples = AddSamples(http)
+        self.remaster_audio = RemasterAudio(http)
+        self.stitch_audio = StitchAudio(http)
         self.separate_audio_stems = SeparateAudioStems(http)
         self.generate_midi = GenerateMidi(http)
         self.convert_audio = ConvertAudio(http)

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/src/runapi/suno/contract_gen.py

@@ -6,6 +6,15 @@ CONTRACT = {
                 "model": {
                     "required": True
                 },
+                "negative_tags": {
+                    "required": True
+                },
+                "tags": {
+                    "required": True
+                },
+                "title": {
+                    "required": True
+                },
                 "upload_url": {
                     "required": True
                 },
@@ -17,6 +26,15 @@ CONTRACT = {
                 "model": {
                     "required": True
                 },
+                "negative_tags": {
+                    "required": True
+                },
+                "tags": {
+                    "required": True
+                },
+                "title": {
+                    "required": True
+                },
                 "upload_url": {
                     "required": True
                 },
@@ -28,6 +46,15 @@ CONTRACT = {
                 "model": {
                     "required": True
                 },
+                "negative_tags": {
+                    "required": True
+                },
+                "tags": {
+                    "required": True
+                },
+                "title": {
+                    "required": True
+                },
                 "upload_url": {
                     "required": True
                 },
@@ -37,6 +64,91 @@ CONTRACT = {
             }
         }
     },
+    "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": {
@@ -47,6 +159,15 @@ CONTRACT = {
                 "model": {
                     "required": True
                 },
+                "negative_tags": {
+                    "required": True
+                },
+                "style": {
+                    "required": True
+                },
+                "title": {
+                    "required": True
+                },
                 "upload_url": {
                     "required": True
                 },
@@ -61,6 +182,15 @@ CONTRACT = {
                 "model": {
                     "required": True
                 },
+                "negative_tags": {
+                    "required": True
+                },
+                "style": {
+                    "required": True
+                },
+                "title": {
+                    "required": True
+                },
                 "upload_url": {
                     "required": True
                 },
@@ -86,7 +216,11 @@ CONTRACT = {
     "boost-style": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "description": {
+                    "required": True
+                }
+            }
         }
     },
     "check-voice": {
@@ -102,7 +236,14 @@ CONTRACT = {
     "convert-audio": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "audio_id": {
+                    "required": True
+                },
+                "task_id": {
+                    "required": True
+                }
+            }
         }
     },
     "cover-audio": {
@@ -389,7 +530,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -403,7 +545,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -417,7 +560,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -431,7 +575,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -445,7 +590,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -459,7 +605,8 @@ CONTRACT = {
                     "required": True
                 },
                 "parameter_mode": {
-                    "enum": ["source", "custom"]
+                    "enum": ["source", "custom"],
+                    "required": True
                 },
                 "persona_type": {
                     "enum": ["style", "voice"]
@@ -493,13 +640,30 @@ CONTRACT = {
     "generate-midi": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "task_id": {
+                    "required": True
+                }
+            }
         }
     },
     "generate-persona": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "audio_id": {
+                    "required": True
+                },
+                "description": {
+                    "required": True
+                },
+                "name": {
+                    "required": True
+                },
+                "task_id": {
+                    "required": True
+                }
+            }
         }
     },
     "generate-voice": {
@@ -521,7 +685,14 @@ CONTRACT = {
     "get-timestamped-lyrics": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "audio_id": {
+                    "required": True
+                },
+                "task_id": {
+                    "required": True
+                }
+            }
         }
     },
     "regenerate-validation-phrase": {
@@ -534,6 +705,66 @@ CONTRACT = {
             }
         }
     },
+    "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": {
@@ -587,6 +818,66 @@ CONTRACT = {
             "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": {
@@ -755,7 +1046,14 @@ CONTRACT = {
     "visualize-music": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "audio_id": {
+                    "required": True
+                },
+                "task_id": {
+                    "required": True
+                }
+            }
         }
     },
     "voice-to-validation-phrase": {
@@ -772,6 +1070,9 @@ CONTRACT = {
                 "vocal_start_seconds": {
                     "required": True,
                     "type": "integer"
+                },
+                "voice_url": {
+                    "required": True
                 }
             }
         }

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/src/runapi/suno/resources/__init__.py

@@ -1,5 +1,8 @@
 from .add_instrumental import AddInstrumental
 from .add_vocals import AddVocals
+from .add_samples import AddSamples
+from .remaster_audio import RemasterAudio
+from .stitch_audio import StitchAudio
 from .boost_style import BoostStyle
 from .blend_lyrics import BlendLyrics
 from .check_voice import CheckVoice
@@ -28,6 +31,9 @@ __all__ = [
     "CoverAudio",
     "AddInstrumental",
     "AddVocals",
+    "AddSamples",
+    "RemasterAudio",
+    "StitchAudio",
     "SeparateAudioStems",
     "GenerateMidi",
     "ConvertAudio",

runapi_suno-0.3.2/src/runapi/suno/resources/add_samples.py

@@ -0,0 +1,11 @@
+from .audio_actions import AudioAction
+from runapi.core.errors import ValidationError
+
+class AddSamples(AudioAction):
+    ENDPOINT = "/api/v1/suno/add_samples"
+    ACTION = "add-samples"
+
+    def create(self, options=None, **params):
+        if params.get("end_seconds", 0) <= params.get("start_seconds", 0):
+            raise ValidationError("end_seconds must be greater than start_seconds")
+        return super().create(options=options, **params)

runapi_suno-0.3.2/src/runapi/suno/resources/audio_actions.py

@@ -0,0 +1,14 @@
+from typing import Any, Dict, Optional
+from runapi.core import Resource, RequestOptions
+from ..contract_gen import CONTRACT
+
+class AudioAction(Resource):
+    ENDPOINT = ""
+    ACTION = ""
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        body = self._compact_params(params); self._validate_contract(CONTRACT[self.ACTION], body)
+        return self._request("post", self.ENDPOINT, body=body, options=options)
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)
+    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))

runapi_suno-0.3.2/src/runapi/suno/resources/remaster_audio.py

@@ -0,0 +1,5 @@
+from .audio_actions import AudioAction
+class RemasterAudio(AudioAction):
+    ENDPOINT = "/api/v1/suno/remaster_audio"
+    ACTION = "remaster-audio"
+    def create(self, options=None, **params): return super().create(options=options, **params)

runapi_suno-0.3.2/src/runapi/suno/resources/stitch_audio.py

@@ -0,0 +1,5 @@
+from .audio_actions import AudioAction
+class StitchAudio(AudioAction):
+    ENDPOINT = "/api/v1/suno/stitch_audio"
+    ACTION = "stitch-audio"
+    def create(self, options=None, **params): return super().create(options=options, **params)

{runapi_suno-0.3.0 → runapi_suno-0.3.2}/tests/test_client.py

@@ -75,6 +75,9 @@ def test_exposes_all_resource_accessors():
         "cover_audio": R.CoverAudio,
         "add_instrumental": R.AddInstrumental,
         "add_vocals": R.AddVocals,
+        "stitch_audio": R.StitchAudio,
+        "remaster_audio": R.RemasterAudio,
+        "add_samples": R.AddSamples,
         "separate_audio_stems": R.SeparateAudioStems,
         "generate_midi": R.GenerateMidi,
         "convert_audio": R.ConvertAudio,
@@ -92,7 +95,7 @@ def test_exposes_all_resource_accessors():
         "generate_persona": R.GeneratePersona,
         "boost_style": R.BoostStyle,
     }
-    assert len(expected) == 22
+    assert len(expected) == 25
     for name, cls in expected.items():
         assert isinstance(getattr(client, name), cls), name
 
@@ -134,6 +137,33 @@ def test_blend_lyrics_posts_flat_lyrics_pair():
     ]
 
 
+def test_audio_actions_post_public_request_shapes():
+    fake = FakeHttp()
+    client = SunoClient(api_key="k", http_client=fake)
+
+    client.stitch_audio.create(model="suno-v5", source_task_id="source", audio_id="audio")
+    client.remaster_audio.create(model="suno-v5", source_task_id="source", audio_id="audio")
+    client.add_samples.create(
+        model="suno-v5", audio_url="https://file.runapi.ai/source.mp3", start_seconds=5, end_seconds=20
+    )
+
+    assert fake.calls == [
+        ("post", "/api/v1/suno/stitch_audio", {"model": "suno-v5", "source_task_id": "source", "audio_id": "audio"}),
+        ("post", "/api/v1/suno/remaster_audio", {"model": "suno-v5", "source_task_id": "source", "audio_id": "audio"}),
+        ("post", "/api/v1/suno/add_samples", {
+            "model": "suno-v5", "audio_url": "https://file.runapi.ai/source.mp3", "start_seconds": 5, "end_seconds": 20,
+        }),
+    ]
+
+
+def test_add_samples_rejects_invalid_window():
+    client = SunoClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="end_seconds must be greater than start_seconds"):
+        client.add_samples.create(
+            model="suno-v5", audio_url="https://file.runapi.ai/source.mp3", start_seconds=20, end_seconds=20
+        )
+
+
 def test_blend_lyrics_requires_both_lyrics_texts():
     client = SunoClient(api_key="k", http_client=FakeHttp())