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/api/suno/text-to-music; for SDK docs, use https://runapi.ai/docs/resources/sdks.
Install
pip install runapi-suno
Quick start
from runapi.suno import SunoClient
client = SunoClient() # reads RUNAPI_API_KEY, or pass api_key="sk-..."
# Generate music and poll until completion.
result = client.text_to_music.run(
model="suno-v4.5-plus",
vocal_mode="auto_lyrics",
prompt="A chill lo-fi beat with soft vocals",
)
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:
task = client.text_to_music.create(
model="suno-v4.5-plus",
vocal_mode="instrumental",
style="ambient piano",
title="Quiet Morning",
)
status = client.text_to_music.get(task.id)
In web request handlers, prefer create plus webhook or later get polling so a worker is not held open.
RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
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, 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
- Model page: https://runapi.ai/models/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
- Repository: https://github.com/runapi-ai/suno-sdk
License
Licensed under the Apache License, Version 2.0.
Metadata
Release files for runapi-suno 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| runapi_suno-0.7.0.tar.gz | 15.2 kB | Without provenance | Details for runapi_suno-0.7.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| runapi_suno-0.7.0-py3-none-any.whl | Python 3 | none | any | Details for runapi_suno-0.7.0-py3-none-any.whl |
Total release size: 47.8 kB
Release files / runapi_suno-0.7.0.tar.gz
| Download URL | runapi_suno-0.7.0.tar.gz |
|---|---|
| Size | 15.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
db449688e0d426521ab05fe83ba1a1404ee8661ef9c6f63bc1ef14729ee1352a
|
|
BLAKE2b-256 checksum How to use checksums |
54cbf9ad417102eea555b62e52ac505e91932a5c203aa03e5b494d4bd6ff870d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / runapi_suno-0.7.0-py3-none-any.whl
| Download URL | runapi_suno-0.7.0-py3-none-any.whl |
|---|---|
| Size | 32.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0a045d35267fc5dcb49db38c4344dd42d00671576afe3efa6b65f42afe60ca6a
|
|
BLAKE2b-256 checksum How to use checksums |
caa07c9f693148a5dfa7c3435458ee5461db87e6a96738bbf61566c487f2264c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for runapi-suno 0.7.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.