使用 https://router.aionclaw.ai 作为 Base URL。所有接口都需要 Authorization: Bearer <API_KEY>,请求体使用 Content-Type: application/json。API 密钥必须具有对应模型及分组的调用权限。

选择接口

Suno 使用独立的任务协议。不要将 Suno 请求发送到聊天接口或 /v1/music_generation。Suno 的 mv 是上游模型版本;suno_music、suno_lyrics 是 AionRouter 的权限和计费模型名称。

音乐生成接口

POST /v1/music_generation 通过 model 选择模型,支持文字生成歌曲和纯音乐。当前支持 Gemini Lyria 系列,返回包含歌词和 Base64 MP3 音频的 JSON。 Suno 通过下方的异步提交和查询接口生成音乐。

调用 Gemini Lyria

支持 lyria-3.5、lyria-3-clip-preview、lyria-3-pro-preview,也支持已配置的模型别名。实际可用模型以你的账户权限和 GET /v1/models 返回为准。
Lyria 响应包含生成状态、歌词文本、Base64 MP3 和相关元数据:
示例 Base64 仅展示响应结构,实际音频数据更长。id 是厂商交互 ID,不能用于 Suno 任务查询。 读取 type=model_output 步骤中的 type=audio 内容块。最后一个音频块是最终音乐,data 是 Base64 数据,mime_type 表示音频类型。 将刚才的 response.json 解码为本地文件:
  • prompt 必填,最多 2000 字符。将歌词、语言、曲风、乐器、情绪和结构需求写入提示词。
  • is_instrumental: true 用于请求纯音乐。
  • 仅支持同步非流式生成,stream 省略或设为 false。生成可能需要较长时间,请为客户端和代理设置合适的超时。
  • Lyria 使用 Base64 MP3 输出,省略 output_format。
  • 歌词、语言、曲风和歌曲结构通过 prompt 描述。
更多提示词示例可参考 Google 音乐生成文档。

提交 Suno 音乐并查询

描述模式:
自定义歌词模式使用 prompt、title、tags:
至少提供非空的 gpt_description_prompt 或 prompt。省略 mv 时使用默认版本 chirp-v3-0;可用的新版本由服务支持情况决定,不能仅凭版本名称推断已开放。请求不需要 model。本指南覆盖新建歌曲和歌词任务。 提交成功后,data 是公开任务 ID:
使用返回的 ID 查询:
按数秒间隔轮询,直到 data.status 为 SUCCESS 或 FAILURE。其他状态包括 NOT_START、SUBMITTED、QUEUED、IN_PROGRESS 和 UNKNOWN。code: success 表示查询成功;只有任务状态为 SUCCESS 才表示生成完成。 音乐任务成功后,data.data 通常为歌曲数组。读取各项的 audio_url、title 和 metadata;任务可能返回多首歌曲,请处理整个数组。失败时读取 data.fail_reason。结果保留服务返回的结构,歌词结果可能为对象或数组。 批量查询示例:
action 可省略。返回数组仅包含当前用户的 Suno 任务,忽略不可见或不存在的 ID,不保证顺序。没有匹配项时 data 为 []。单任务查询不可见的任务返回 HTTP 400。

生成 Suno 歌词

保存公开任务 ID,使用相同查询接口等待任务完成。

计费、失败和重试

通用接口按成功生成次数计费,使用所选模型或别名的按次价格及分组倍率。音频大小和时长不作为计费乘数。 Lyria 按一次成功生成计费,采用该模型或别名配置的按次价格及分组倍率。收到已完成且包含有效 MP3 的厂商响应后结算;上游失败、结果不完整或音频无效会退回预扣额度。文件大小和时长不作为计费乘数。 Suno 按任务提交计费;返回多首歌曲不会按歌曲数量重复收费。提交失败退回预扣额度,已提交任务最终失败后按任务流程退款。任务查询不会再次生成或收费,退款到账可能晚于失败状态更新。 音乐提交不自动重试。通用音乐生成和 Suno 提交均不提供客户端幂等键。网络超时或连接中断时,生成可能已经发生;重新提交会成为新请求,可能产生新费用。已获得 Suno 任务 ID 时,只查询原任务。 先检查 HTTP 状态码。认证、权限或限流错误可能使用 error 对象或 code / message;Lyria 处理错误使用 base_resp.status_code / status_msg。Suno 任务错误使用 code / message。错误不应当作音频结果处理。 及时保存生成的音频。Suno 的媒体链接由厂商返回,有效期由厂商决定。