curl --request POST \
  --url https://kaienapi.com/suno/submit/{action} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "写一首夏夜城市氛围的中文流行歌",
  "title": "夏夜街灯",
  "tags": "mandopop, city-pop",
  "mv": "chirp-v3-0"
}
'

{}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Suno 提交任务基础接口

Suno 任务提交入口，action 可选 MUSIC 或 LYRICS。

action 说明

MUSIC：生成完整歌曲，也可通过 make_instrumental=true 生成纯音乐。
LYRICS：只生成歌词草稿。

执行顺序

选择 action。
提交提示词、标题、风格标签和版本参数。
保存返回的任务 ID。
调用查询接口获取状态和结果。

参数重点

prompt 控制主题和歌词方向；tags 控制风格、流派、情绪和用途；mv 控制模型版本；续写任务需要传 task_id、continue_clip_id 和 continue_at。

POST

/

suno

/

submit

/

{action}

curl --request POST \
  --url https://kaienapi.com/suno/submit/{action} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "写一首夏夜城市氛围的中文流行歌",
  "title": "夏夜街灯",
  "tags": "mandopop, city-pop",
  "mv": "chirp-v3-0"
}
'

{}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

在请求头中传入：Authorization: Bearer sk-...

Path Parameters

action

enum<string>

required

Available options:

MUSIC,

LYRICS

Body

application/json

Suno 任务提交请求。音乐和歌词生成均为异步任务，提交成功后保存任务 ID 并查询状态。

prompt

string

歌曲主题、歌词要求或音乐方向。生成歌词时描述歌词内容；生成音乐时描述歌曲主题和整体氛围。

Example:

"写一首夏夜城市氛围的中文流行歌"

gpt_description_prompt

string

偏风格描述的提示词，用来收紧音乐方向、情绪、语言、声线和编曲。

Example:

"upbeat mandopop, summer night city, male vocal"

title

string

歌曲标题。

Example:

"夏夜街灯"

tags

string

风格标签。填写流派、情绪、速度、语言、声线和用途，例如 electronic, uplifting, product-launch。

Example:

"mandopop, upbeat, city-pop"

mv

string

模型版本或音乐版本参数。可选值以模型页或接口说明为准。

Example:

"chirp-v3-0"

continue_at

number

续写开始时间，单位一般为秒。

Example:

35.5

continue_clip_id

string

要续写的音频片段 ID。

task_id

string

原任务 ID。续写或基于已有任务再次生成时传入。

make_instrumental

boolean

是否生成纯音乐。true 表示不生成人声歌词。

Example:

false

Response

成功响应

The response is of type object.

获取 Midjourney 图片资源批量查询 Suno 任务