生成与创作

本页介绍的是用于创建新的音乐资产，而不是转换上传音频的路由。

核心创建路由

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

`/suno/generate`

使用 /suno/generate 既适用于单行歌曲创作，也适用于完全可控的基于歌词的创作。

关键输入字段

字段	必填	说明
`customMode`	是	`false` 用于简单模式， `true` 用于自定义模式
`instrumental`	是	`true` 用于纯音乐， `false` 用于人声
`model`	是	以下之一 `V4`, `V4_5`, `V4_5PLUS`, `V4_5ALL`, `V5`
`callBackUrl`	是	任务完成时的 webhook 端点
`prompt`	条件必填	简单模式下为描述，自定义模式下为歌词文本
`style`	条件必填	自定义模式必填
`title`	条件必填	自定义模式必填
`personaId`	否	复用已保存的声音身份

简单模式示例

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": "一首明亮的夏日流行歌曲，关于旅行和自由",
    "callBackUrl": "https://your-domain.com/callback"
  }'

自定义模式示例

curl -X POST "https://api.anyint.ai/suno/generate" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customMode": true,
    "instrumental": false,
    "model": "V5",
    "title": "夏日微风",
    "style": "流行、原声、温暖人声",
    "prompt": "[Verse]\n城市被我们抛在身后\n\n[Chorus]\n我们继续朝着光亮前行",
    "personaId": "your-persona-id",
    "callBackUrl": "https://your-domain.com/callback"
  }'

`/suno/extend`

使用 /suno/extend 用于继续之前生成的曲目。

关键输入字段

字段	必填	说明
`audioId`	是	用于继续的源音频
`model`	是	目标模型版本
`callBackUrl`	是	异步回调目标
`defaultParamFlag`	是	`false` 用于复用原始歌曲设置， `true` 用于覆盖

curl -X POST "https://api.anyint.ai/suno/extend" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audioId": "your-audio-id",
    "model": "V4_5",
    "defaultParamFlag": false,
    "callBackUrl": "https://your-domain.com/callback"
  }'

`/suno/generate-lyrics`

当你希望在开始生成歌曲之前先由 AI 编写歌词时，请使用此路由。

curl -X POST "https://api.anyint.ai/suno/generate-lyrics" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一首关于都市生活的深夜 R&B 歌曲",
    "callBackUrl": "https://your-domain.com/callback"
  }'

回调会返回多个歌词变体，每个都带有 title 和 文本.

`/suno/timestamped-lyrics`

当歌曲完成后，如果你需要卡拉 OK、字幕或歌词同步输出，请使用此路由。

curl -X POST "https://api.anyint.ai/suno/timestamped-lyrics" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "your-task-id",
    "audioId": "your-audio-id"
  }'

响应包括 data.alignedWords，其中每个单词都包含 startS 和 endS.

`/suno/style-generate`

这是一个同步辅助路由，用于在提交完整生成请求之前改进粗略的风格标签。

curl -X POST "https://api.anyint.ai/suno/style-generate" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": "流行、神秘、电子" }'

`/suno/generate-cover`

当音乐任务完成后，请使用此路由创建封面图选项。

curl -X POST "https://api.anyint.ai/suno/generate-cover" \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "your-task-id",
    "callBackUrl": "https://your-domain.com/callback"
  }'

回调会返回 data.images，这是一个生成的封面 URL 数组。

On this page