Agent-ready 音乐 API 已发布

让音乐想象，
通过 API
变为现实

通过 /v1/suno/generate/prompt，把一句灵感提示词转化为完整歌曲。谱乐 AI 为应用、工作流和 AI Agent 提供稳定、可编排、开发者友好的音乐生成能力。

API Playground

POST灵感提示词生成

/v1/suno/generate/prompt

提示词一首阳光积极的中文流行歌，像清晨推开窗迎接新的一天

模型chirp-v5.5

{

"prompt": "一首阳光积极的中文流行歌，像清晨推开窗迎接新的一天",

"model": "chirp-v5.5"

}

Ready742ms

晴朗正在发生.mp3中文流行 · 阳光 · 积极0:00 / 0:00

99.95%服务可用性近 30 天

< 800ms平均响应延迟近 30 天

全球节点低延迟覆盖全球部署

安全合规企业级安全数据加密

面向 Agent 的音乐能力层

让 Agent 直接创作、处理和交付音乐

把生成、查询、分轨、MIDI 转换和风格分析封装成可被 Agent 调用的工具。适配 MCP、OpenClaw、WorkBuddy、Hermes 长期记忆型 Agent 与企业自动化工作流。

查看 Agent 接入方式

短视频配乐 Agent

读取视频 brief，生成多版 BGM，按情绪、节奏和时长返回候选音频。

游戏素材工作流

按关卡、场景和循环要求批量生成音乐素材，并保留任务与用量记录。

品牌 Jingle 助手

根据品牌调性生成多版旋律短句，方便广告、播客和活动快速试音。

Hermes 长期记忆

沉淀项目偏好、品牌音色和历史版本，让 Agent 在多轮创作中复用上下文。

示例：用灵感提示词生成歌曲

主路径对齐真实 API：POST /v1/suno/generate/prompt。传入自然语言 prompt 和模型版本，服务会创建异步生成任务，并返回可用于查询结果的歌曲 ID。

查看文档

01输入 prompt描述风格、场景、情绪或主题。

02创建任务接口返回 task_id 和 songs[].id，适合异步接入。

03获取歌曲使用 songs[].id 查询结果接口，拿到音频与元数据。

最小调用示例

curl -X POST https://api.yourmusic.fun/v1/suno/generate/prompt \
  -H "Authorization: Bearer sk-live-..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一首阳光积极的中文流行歌，像清晨推开窗迎接新的一天",
    "model": "chirp-v5.5"
  }'

API 端点

完整文档

POST/v1/suno/generate/prompt通过提示词生成

POST/v1/suno/generate/custom歌词与风格生成

POST/v1/mureka/generate/promptMureka 提示词生成

POST/v1/minimax/generate/customMiniMax 音乐生成

POST/v1/ace-step/generate/promptACE Step 提示词生成

GET/v1/music/generations/query?songid=...查询生成结果

还有更多接口，查看完整 API 文档

Agent Tools

把 HTTP API 翻译成 Agent 更容易规划的动作。

generate_song_from_prompt根据自然语言 brief 创建歌曲生成任务。

query_generation_result查询异步任务并返回音频链接与元数据。

split_audio_stems把音频拆分为人声、鼓、贝斯和伴奏等分轨。

convert_audio_to_midi把音频转成 MIDI，进入编曲或乐谱工作流。

查看 MCP 与 Skill 配置

快速开始

只需四步，调用 API 生成你的第一段音乐。

注册账户

获取你的 API Key

写下灵感

描述歌曲氛围与主题

发送请求

调用 prompt 生成接口

获取结果

用歌曲 ID 查询状态并下载音频

系统状态

全部系统运行正常

最近更新：2 分钟前

你的 API Key

•••••••••••••••• a1b2

管理密钥

让音乐想象，通过 API变为现实