Suno 在 RunAPI 上的应用

通过 RunAPI 使用 Suno 生成与转换音乐，或创作歌词，支持歌词融合（lyric blending）、语音验证短语（voice validation phrase）及自定义语音工作流（custom voice workflows）。一次性代理任务（one-off agent tasks）的默认路径是 runapi CLI；SDK 则用于应用程序集成。

重要提示：集成运行时（Integration Runtime）

• 集成类工作（如应用、后端、Worker、库、Rails 服务、Node 服务、Go 服务、Webhook 流水线或生产代码库）应使用目标语言对应的 SDK 集成路径。
• 一次性生成、编辑、转换、手动冒烟测试、调试，或用户主动发起的 CLI 运行，应使用 CLI 路径 并调用 runapi 二进制程序。有关 CLI 特定代理的完整指南，请参阅 https://github.com/runapi-ai/cli-skill。
• 切勿在生产环境的集成层中通过 shell 调用 runapi CLI。

SDK 集成路径

当将 Suno 集成至应用、后端、Worker、库、Rails 服务、Node 服务、Go 服务、Webhook 流水线或生产工作流时，请首先查阅当前 SDK 包及其官方使用说明。在参考 CLI 帮助或原始 HTTP 示例前，请务必确认安装命令、客户端方法（create、get、run）、请求字段、响应结构及错误类。请使用 RunAPI 提供的 SDK 包：

• JavaScript / TypeScript：@runapi.ai/suno
• PHP：runapi-ai/suno
• Ruby：runapi-suno
• Go：github.com/runapi-ai/suno-sdk/go

CLI 路径

runapi 二进制程序是一次性任务和手动测试的运行时依赖。有关 CLI 特定代理的完整指南，请参阅 https://github.com/runapi-ai/cli-skill。首次运行前请执行 runapi auth status。对于代理任务及无头运行（headless runs），推荐使用环境变量 RUNAPI_API_KEY，或通过以下命令将其导入已保存的配置中：printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -。仅当用户明确要求交互式浏览器认证时，才使用 runapi login。

可通过 CLI 帮助查看可用命令及请求字段：

runapi suno --help
runapi suno text-to-music --help
runapi suno blend-lyrics --help
runapi suno separate-audio-stems --help
runapi suno voice-to-validation-phrase --help
runapi suno regenerate-validation-phrase --help
runapi suno generate-voice --help
runapi suno check-voice --help

执行一次性任务（同步模式 —— 持续轮询直至任务完成）：

runapi suno text-to-music --input-file request.json
runapi suno blend-lyrics --input-file lyrics.json
runapi suno voice-to-validation-phrase --input-file voice-phrase.json
runapi suno generate-voice --input-file generate-voice.json
runapi suno check-voice --input-file check-voice.json

对于高级音源分离（advanced stem separation），请将 type 设为 split_stem_advanced，并指定目标 stem_name。结果中将包含提取出的音源（stem）以及剩余音频，后者位于 separated_audios.pairs 下。

异步提交任务并单独轮询：

runapi suno text-to-music --async --input-file request.json
runapi wait  --service suno --action text-to-music

支持的命令列表：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、boost-style。

针对自定义语音工作流：先生成或重新生成验证短语，再通过 generate-voice 创建自定义语音；随后可在支持 Suno v5 音乐生成的端点上，将生成完成的 voice_id 作为 persona_id 使用，并设置 persona_type: "voice"。在生成请求中依赖该语音前，请务必先调用 check-voice 确认其可用性。

生成文件的存储

RunAPI 生成的文件 URL 为临时链接。请在 7 天内将生成的图像、视频、音频或其他文件下载并存储至您自己的持久化存储中；请勿将返回的 URL 视为长期资产。

参考资料

• 模型概览、定价与速率限制：https://runapi.ai/models/suno.md
• 供应商对比：https://runapi.ai/providers/suno.md
• 完整模型目录：https://runapi.ai/models.md

版本变体（Variants）

• v4
• v4.5
• v4.5 all
• v4.5 plus
• v5
• v5.5