AI 音乐 API

兼容 Suno 的音乐接口，用于歌曲生成、音频转换、任务轮询和基于 Webhook 的完成通知。

AI 音乐路由是兼容 Suno 的资产生成 API。它们不是聊天补全接口。多数路由会创建异步任务、返回 taskId，并通过轮询或 Webhook 回调完成。

Base URL 与鉴权

https://api.anyint.ai
Authorization: Bearer <ANYINT_API_KEY>
Content-Type: application/json

创作路由

路由	用途
`POST /suno/generate`	创建新歌曲
`POST /suno/extend`	延长已有生成歌曲
`POST /suno/generate-lyrics`	根据提示词生成歌词
`POST /suno/timestamped-lyrics`	获取已完成歌曲的逐词时间戳
`POST /suno/style-generate`	将粗略风格描述扩展为更丰富的风格文本
`POST /suno/generate-cover`	为已完成音乐任务生成封面图

转换与导出路由

路由	用途
`POST /suno/upload-cover`	上传音频并创建 AI 翻唱
`POST /suno/upload-extend`	上传音频并继续生成
`POST /suno/add-vocals`	为伴奏添加人声
`POST /suno/add-instrumental`	为人声添加伴奏
`POST /suno/generate-persona`	从已完成歌曲创建可复用声线身份
`POST /suno/vocal-removal`	分离人声与伴奏，或生成多轨分离结果
`POST /suno/split-stem`	从已有音频结果拆分 stems
`POST /suno/replace-section`	替换已有音频结果中的某个片段
`POST /suno/wav-generate`	将已完成歌曲导出为 WAV
`POST /suno/mp4-generate`	从已完成歌曲创建音乐视频

查询路由

路由	用途
`GET /suno/query/task?taskId={taskId}`	歌曲生成和封面任务
`GET /suno/query/lyrics?taskId={taskId}`	歌词任务
`GET /suno/query/vocal-removal?taskId={taskId}`	分轨或人声移除任务
`GET /suno/query/wav?taskId={taskId}`	WAV 转换任务
`GET /suno/query/mp4?taskId={taskId}`	MV 生成任务
`GET /suno/query/cover?taskId={taskId}`	封面图任务

生成歌曲

curl -X POST "https://api.anyint.ai/suno/generate" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customMode": false,
    "instrumental": false,
    "model": "V5",
    "prompt": "A bright summer pop song about travel and freedom",
    "callBackUrl": "https://your-domain.com/callback"
  }'

关键字段：

字段	类型	必填	含义	示例
`customMode`	布尔值	是	`false` 为简单提示词模式；`true` 表示你会提供自定义歌词、风格和标题。	`false`
`instrumental`	布尔值	是	`true` 生成纯音乐；`false` 生成带人声歌曲。	`false`
`model`	字符串	是	音乐模型版本。支持值可能因账号而异。	`V5`
`callBackUrl`	字符串	是	用于任务完成事件的公网 HTTPS 回调 URL。仍应保留轮询兜底。	`https://your-domain.com/callback`
`prompt`	字符串	条件必填	简单模式下是歌曲描述；自定义模式下是歌词文本。	`A bright summer pop song...`
`style`	字符串	条件必填	自定义模式必填；描述曲风、情绪、人声和配器。	`pop, upbeat, female vocal`
`title`	字符串	条件必填	自定义模式必填；歌曲标题。	`Summer Roads`
`personaId`	字符串	否	账号和模型支持时复用已保存的声线 persona。	`persona_123`

转换请求字段

路由	重要字段	含义
`POST /suno/extend`	`taskId`, `audioId`, `prompt`, `continueAt`, `callBackUrl`	继续或延长已有生成歌曲。
`POST /suno/upload-cover`	`uploadUrl` 或上传音频引用、`style`, `title`, `callBackUrl`	从上传音频创建 AI 翻唱。
`POST /suno/upload-extend`	上传音频引用、`prompt`, `continueAt`, `callBackUrl`	继续生成上传的音频片段。
`POST /suno/add-vocals`	源任务或音频引用、人声提示字段、`callBackUrl`	为纯音乐添加人声。
`POST /suno/add-instrumental`	源任务或音频引用、风格字段、`callBackUrl`	为人声添加伴奏。
`POST /suno/vocal-removal`	源任务或音频引用、`callBackUrl`	分离人声和伴奏，或生成 stems。
`POST /suno/split-stem`	源任务或音频引用、`callBackUrl`	账号支持时从已有结果中拆分 stems。
`POST /suno/replace-section`	源任务或音频引用、片段时间字段、替换提示词字段、`callBackUrl`	账号支持时替换已有音轨中的片段。
`POST /suno/wav-generate`	源任务或音频 ID、`callBackUrl`	将已完成歌曲导出为 WAV。
`POST /suno/mp4-generate`	源任务或音频 ID、`callBackUrl`	从已完成歌曲创建音乐视频。

具体转换字段会随工作流变化。请优先使用产品页面中的路由示例，并在生产前验证你的账号是否支持所选工作流。

任务状态

状态	含义
`PENDING`	排队中
`TEXT_SUCCESS`	文本或歌词阶段完成
`FIRST_SUCCESS`	第一段音频已完成
`SUCCESS`	完整任务已完成
`CREATE_TASK_FAILED`	任务创建失败
`GENERATE_AUDIO_FAILED`	音频生成失败

Webhook 回调

所有异步音乐路由都可以调用你的 callBackUrl。

`callbackType`	含义
`text`	文本或歌词阶段完成
`first`	第一段音频结果就绪
`complete`	完整工作流完成

回调处理要求

要求	指导
公网 HTTPS URL	回调 URL 必须能被 AnyInt 访问。
幂等性	保存 `taskId`，并安全忽略重复回调。
快速响应	快速返回，把重媒体处理放入队列。
轮询兜底	如果回调延迟，继续轮询查询路由。
归属校验	确认回调中的任务 ID 属于你的应用创建的任务。

错误码

Code	含义
`400`	参数无效
`401`	鉴权失败
`405`	频率限制
`413`	文本过长
`429`	配额耗尽
`430`	请求速率过高
`455`	系统维护
`500`	服务端错误