Suno · 音频与音乐

Hermes Agent x Suno

Suno 是一款 AI 音乐生成平台，从文字描述创作包含人声、乐器和歌词的原创歌曲。通过 RunAPI，所有 Suno 版本共用同一个 API Key，按次计费。

9 variants 起价 $0.01 / 次调用 可商用
获取 API Key 查看 Hermes Agent 文档

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任务匹配时使用 suno-v4：改进频率范围和连贯性，4 分钟上限。

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: 改进频率范围和连贯性，4 分钟上限
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: 首次生成 8 分钟，流派错误减少 25%，人声自然度提升 40%
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: 解锁全部 v4.5 风格和模式，无订阅限制
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: v4.5 架构内的增强质量档位
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: CD 级音质，单次生成最长 8 分钟
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: 单次生成最长 8 分钟，支持声音克隆和风格训练
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: 创作一首 2 分钟的 lo-fi 放松音乐，带有柔和钢琴、黑胶唱片质感和轻柔低音。
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/stitch_audio，并保存返回的 Task ID。
GET /api/v1/suno/stitch_audio/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/extend_music，并保存返回的 Task ID。
GET /api/v1/suno/extend_music/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/create_mashup，并保存返回的 Task ID。
GET /api/v1/suno/create_mashup/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_samples，并保存返回的 Task ID。
GET /api/v1/suno/add_samples/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/cover_audio，并保存返回的 Task ID。
GET /api/v1/suno/cover_audio/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/inspire_music，并保存返回的 Task ID。
GET /api/v1/suno/inspire_music/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_music，并保存返回的 Task ID。
GET /api/v1/suno/text_to_music/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/remaster_audio，并保存返回的 Task ID。
GET /api/v1/suno/remaster_audio/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_instrumental，并保存返回的 Task ID。
GET /api/v1/suno/add_instrumental/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_vocals，并保存返回的 Task ID。
GET /api/v1/suno/add_vocals/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_sound，并保存返回的 Task ID。
GET /api/v1/suno/text_to_sound/<task-id>，直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。

公开版本与端点

Suno V6 现已上线。使用旧版模型 ID（v3.5–v5.5）的请求将自动路由至 V6 或 V6 Mini，价格保持不变。
模型 ID 端点 起步价格 模型目录
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / 次调用 模型详情
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / 次调用 模型详情
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / 次调用 模型详情
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / 次调用 模型详情
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / 次调用 模型详情
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / 次调用 模型详情
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / 次调用 模型详情
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 次调用 模型详情
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 次调用 模型详情

验证

轮询，直到 Task 进入终态

选择 <model-id> 后生成验证命令。

配置

指南端点: <endpoint>

选择 <model-id> 后，按端点的公开输入契约生成请求。

其他操作

这些操作不使用模型 ID。

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
使用流程

三步开始使用

  1. 选择模型 ID

    选择公开模型 ID，并查看其端点与当前起步价格。

  2. 配置 RunAPI

    调用端点前设置 RUNAPI_API_KEY。

  3. 验证结果

    对于异步端点，轮询同一端点，直到 Task 进入终态。

使用 Hermes Agent + Suno 可以构建什么

  • 歌曲创作草稿本

    描述歌曲的曲风、情绪、节奏和主题，得到一段小样，在正式录制前继续打磨。

  • 新风格翻唱

    改变现有歌曲的曲风、配器或情绪，同时保留核心旋律和结构。

  • 完整的音视频流水线

    在 Hermes Agent 工作流中把 Suno 与视频模型串联，生成画面和与之匹配的原创配乐。

为什么通过 RunAPI + Hermes Agent 使用 Suno

  • 9 个变体，一个 API 密钥

    通过一个 RunAPI 连接选择可用的模型变体，无需更改现有集成。

  • 清晰的用量价格

    发送请求前查看目录中的当前价格，无需订阅或最低消费。

  • 自动化任务流程

    通过一致的任务流程提交任务、查询状态并收集异步结果，无需编写手动轮询代码。

Hermes Agent + Suno 常见问题

如何在 Hermes Agent 中配置 Suno？

使用你为聊天配置的同一个 RunAPI 提供方即可。它同时支持聊天、图片、视频和音乐端点，Suno 无需单独配置。

可以生成不带人声的纯音乐吗？

可以。Suno 支持纯音乐生成。本页的请求参数说明了纯音乐模式下哪些字段生效；如果发送了相互冲突的字段，API 会返回校验错误。

Hermes Agent 能把 Suno 与视频模型串联吗？

可以。Hermes Agent 可以先用视频模型生成视频，再在同一工作流中用 Suno 生成匹配的配乐。

应该使用哪个模型 ID？

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

本指南会配置聊天模型吗？

不会。该 Model Line 使用页面所示的端点流程，不会被描述为 Agent 聊天模型。

开始在 Hermes Agent 中使用 Suno

获取 API Key 阅读快速开始

需要团队接入支持？

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们