New API秒接Suno AI音乐生成AI音乐接口完整对接指南【免费下载链接】new-api基于One API的二次开发版本仅供个人管理渠道使用请勿用于商业API分发项目地址: https://gitcode.com/gh_mirrors/newa/new-apiNew API 是基于 One API 二次开发的多模型网关用于个人统一管理各类 AI 渠道。本文是一份完整的 Suno AI 音乐生成接口对接指南只需 4 步即可在 New API 中接入 Suno 渠道让 AI 音乐生成作曲、续写、歌词生成与聊天、绘图一样通过统一的 API Key 和接口调用轻松接入你的应用。为什么用 New API 对接 Suno 音乐生成Suno 是目前最流行的 AI 音乐创作工具之一但直接使用其接口需要自己部署代理服务、维护账号与密钥。New API 将其封装为标准的任务型渠道带来几个核心好处统一入口音乐生成与聊天、绘图模型共用一套 Token 鉴权和计费体系一个 Key 管理所有 AI 能力异步任务托管提交生成任务后New API 后台每 15 秒自动轮询任务进度由 controller/task.go 中的任务轮询逻辑实现无需自己写轮询代码多渠道路由可同时配置多个 Suno 渠道由 middleware/distributor.go 自动分发请求日志与计费每次生成自动记录消耗方便在后台查看成本和调用历史相关能力在 README 中也有说明README.md。对接前准备2 项基础配置开始之前请确认以下两点部署 Suno API 代理服务需要一个已部署并配置好 Suno 账号的 Suno-API 代理服务强烈建议为其设置密钥。官方对接文档见 Suno.md启动 New API确保 New API 服务正常运行并且环境变量UPDATE_TASK保持默认值true关闭后 Suno 等异步任务将不会自动更新进度四步完成 Suno 渠道配置第 1 步添加渠道进入后台「渠道管理」点击新增渠道渠道类型选择Suno API渠道类型号 36定义见 common/constants.go模型填写模型名能力suno_music生成音乐自定义模式、灵感模式、续写suno_lyrics生成歌词第 2 步填写代理地址「代理」栏填写你的 Suno API 部署地址例如http://localhost:8080。第 3 步填写密钥「密钥」栏填写 Suno API 设置的密钥若未设置密钥可随意填写。第 4 步测试并启用渠道创建后点击「测试」验证连通性成功后启用渠道即可开始调用。 进阶玩法如果你要对接的是另一台上游 New API同样选择 Suno API 类型或任意模型包含上述模型名的类型代理填写上游 New API 地址、密钥填写上游 New API 的密钥即可详见 Suno.md。模型价格设置为 AI 音乐接口定价为了正确计费需要为 Suno 模型设置固定价格。进入设置 → 运营设置 → 模型固定价格设置填入如下示例配置{ suno_music: 0.3, suno_lyrics: 0.01 }价格可按你的 Suno 实际成本调整设置后每次生成任务的消耗都会自动计入用户额度。接口调用一览提交与查询音乐任务Suno 相关路由统一注册在/suno分组下见 router/relay-router.go全部使用Bearer 你的NewAPI-令牌鉴权方法接口说明POST/suno/submit/music提交音乐生成任务POST/suno/submit/lyrics提交歌词生成任务POST/suno/fetch批量查询任务状态GET/suno/fetch/:id按 ID 查询单个任务提交音乐生成的常用参数完整结构见 dto/suno.goprompt歌曲描述必填歌词生成时同样必填mv模型版本不填默认使用chirp-v3-0自动补全逻辑在 relay/channel/task/suno/adaptor.go 中title/tags歌曲标题与风格标签make_instrumental是否生成纯音乐task_idcontinue_clip_idcontinue_at组合使用可实现歌曲续写任务状态流转submitted已提交→queueing排队中→processing生成中→success成功/failed失败。生成成功后可拿到audio_url音频、video_url、image_url封面等字段。模型与动作的映射关系定义在 constant/task.go支持的任务动作包括MUSIC与LYRICS。查看任务进度与结果后台查看在「任务日志」页面前端实现见 web/src/pages/Task/index.js 与 web/src/components/TaskLogsTable.js可直接查看每次音乐生成任务的状态、耗时和失败原因接口查看调用/suno/fetch传入ids数组批量查询返回结果中status为success时data字段即为歌曲信息New API 会在后台持续同步任务状态Suno.md 提到该能力依赖UPDATE_TASK开关因此即使提交后长时间未查询任务完成状态也会自动更新入库。常见问题速查Q1提交任务成功但一直不更新进度检查UPDATE_TASK环境变量是否为true同时确认 Suno API 上游服务在线。Q2歌词生成报prompt_empty歌词任务必须提供prompt参数这是服务端强校验见 relay/channel/task/suno/adaptor.go 的actionValidate函数。Q3续写任务报task id is empty使用continue_clip_id续写时必须同时携带原任务的task_id。Q4渠道类型有哪些可选对接 Suno-API 代理服务选择Suno API类型对接上游 New API 则任意类型均可只要模型列表包含suno_music/suno_lyrics。小结通过本文的四步法你可以在 New API 中快速接入 Suno AI 音乐生成能力统一 Token 鉴权、自动任务轮询、开箱即用的日志计费让 AI 音乐接口像调用大模型对话一样简单。更多接口细节可参考 Suno.md 对接文档与 Suno 适配器源码 relay/channel/task/suno/models.go。【免费下载链接】new-api基于One API的二次开发版本仅供个人管理渠道使用请勿用于商业API分发项目地址: https://gitcode.com/gh_mirrors/newa/new-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 New API秒接Suno AI音乐生成：AI音乐接口完整对接指南
New API秒接Suno AI音乐生成AI音乐接口完整对接指南【免费下载链接】new-api基于One API的二次开发版本仅供个人管理渠道使用请勿用于商业API分发项目地址: https://gitcode.com/gh_mirrors/newa/new-apiNew API 是基于 One API 二次开发的多模型网关用于个人统一管理各类 AI 渠道。本文是一份完整的 Suno AI 音乐生成接口对接指南只需 4 步即可在 New API 中接入 Suno 渠道让 AI 音乐生成作曲、续写、歌词生成与聊天、绘图一样通过统一的 API Key 和接口调用轻松接入你的应用。为什么用 New API 对接 Suno 音乐生成Suno 是目前最流行的 AI 音乐创作工具之一但直接使用其接口需要自己部署代理服务、维护账号与密钥。New API 将其封装为标准的任务型渠道带来几个核心好处统一入口音乐生成与聊天、绘图模型共用一套 Token 鉴权和计费体系一个 Key 管理所有 AI 能力异步任务托管提交生成任务后New API 后台每 15 秒自动轮询任务进度由 controller/task.go 中的任务轮询逻辑实现无需自己写轮询代码多渠道路由可同时配置多个 Suno 渠道由 middleware/distributor.go 自动分发请求日志与计费每次生成自动记录消耗方便在后台查看成本和调用历史相关能力在 README 中也有说明README.md。对接前准备2 项基础配置开始之前请确认以下两点部署 Suno API 代理服务需要一个已部署并配置好 Suno 账号的 Suno-API 代理服务强烈建议为其设置密钥。官方对接文档见 Suno.md启动 New API确保 New API 服务正常运行并且环境变量UPDATE_TASK保持默认值true关闭后 Suno 等异步任务将不会自动更新进度四步完成 Suno 渠道配置第 1 步添加渠道进入后台「渠道管理」点击新增渠道渠道类型选择Suno API渠道类型号 36定义见 common/constants.go模型填写模型名能力suno_music生成音乐自定义模式、灵感模式、续写suno_lyrics生成歌词第 2 步填写代理地址「代理」栏填写你的 Suno API 部署地址例如http://localhost:8080。第 3 步填写密钥「密钥」栏填写 Suno API 设置的密钥若未设置密钥可随意填写。第 4 步测试并启用渠道创建后点击「测试」验证连通性成功后启用渠道即可开始调用。 进阶玩法如果你要对接的是另一台上游 New API同样选择 Suno API 类型或任意模型包含上述模型名的类型代理填写上游 New API 地址、密钥填写上游 New API 的密钥即可详见 Suno.md。模型价格设置为 AI 音乐接口定价为了正确计费需要为 Suno 模型设置固定价格。进入设置 → 运营设置 → 模型固定价格设置填入如下示例配置{ suno_music: 0.3, suno_lyrics: 0.01 }价格可按你的 Suno 实际成本调整设置后每次生成任务的消耗都会自动计入用户额度。接口调用一览提交与查询音乐任务Suno 相关路由统一注册在/suno分组下见 router/relay-router.go全部使用Bearer 你的NewAPI-令牌鉴权方法接口说明POST/suno/submit/music提交音乐生成任务POST/suno/submit/lyrics提交歌词生成任务POST/suno/fetch批量查询任务状态GET/suno/fetch/:id按 ID 查询单个任务提交音乐生成的常用参数完整结构见 dto/suno.goprompt歌曲描述必填歌词生成时同样必填mv模型版本不填默认使用chirp-v3-0自动补全逻辑在 relay/channel/task/suno/adaptor.go 中title/tags歌曲标题与风格标签make_instrumental是否生成纯音乐task_idcontinue_clip_idcontinue_at组合使用可实现歌曲续写任务状态流转submitted已提交→queueing排队中→processing生成中→success成功/failed失败。生成成功后可拿到audio_url音频、video_url、image_url封面等字段。模型与动作的映射关系定义在 constant/task.go支持的任务动作包括MUSIC与LYRICS。查看任务进度与结果后台查看在「任务日志」页面前端实现见 web/src/pages/Task/index.js 与 web/src/components/TaskLogsTable.js可直接查看每次音乐生成任务的状态、耗时和失败原因接口查看调用/suno/fetch传入ids数组批量查询返回结果中status为success时data字段即为歌曲信息New API 会在后台持续同步任务状态Suno.md 提到该能力依赖UPDATE_TASK开关因此即使提交后长时间未查询任务完成状态也会自动更新入库。常见问题速查Q1提交任务成功但一直不更新进度检查UPDATE_TASK环境变量是否为true同时确认 Suno API 上游服务在线。Q2歌词生成报prompt_empty歌词任务必须提供prompt参数这是服务端强校验见 relay/channel/task/suno/adaptor.go 的actionValidate函数。Q3续写任务报task id is empty使用continue_clip_id续写时必须同时携带原任务的task_id。Q4渠道类型有哪些可选对接 Suno-API 代理服务选择Suno API类型对接上游 New API 则任意类型均可只要模型列表包含suno_music/suno_lyrics。小结通过本文的四步法你可以在 New API 中快速接入 Suno AI 音乐生成能力统一 Token 鉴权、自动任务轮询、开箱即用的日志计费让 AI 音乐接口像调用大模型对话一样简单。更多接口细节可参考 Suno.md 对接文档与 Suno 适配器源码 relay/channel/task/suno/models.go。【免费下载链接】new-api基于One API的二次开发版本仅供个人管理渠道使用请勿用于商业API分发项目地址: https://gitcode.com/gh_mirrors/newa/new-api创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考