生成音乐

主站接口①

https://api2.aigcbest.top

POST

/incho/submit/music

请求参数说明

参数	必填	说明
model	是	模型版本，当前支持 `v3.5`、`v4.0`
task_type	是	固定为 `normal`（提示词模式）
prompt	是	提示词 prompt：用来描述歌曲的风格、情绪、主题等，不可为空，v3.5 最多 1000 个字符，v4.0 最多 3000 个字符
lyric	否	自定义歌词，不传则由模型根据提示词 prompt 生成，v3.5 最多 3000 个字符，v4.0 最多 5000 个字符
n	否	生成歌曲数量，默认 2，最大 2

1. 提交生歌任务

2. 轮询任务状态

歌曲生成通常需要数十秒。建议每隔 2~5 秒调用一次 query 接口，直到 choices 中歌曲的 status 为 done 或 fail。

status	含义
pending	排队中
running	生成中
stream	可流式播放（`pipe_url` 可用）
done	生成完成（`audio_url` 可用）
fail	生成失败，查看 `error` 字段

请求参数

Header 参数

Body 参数application/json

示例

{
  "model": "v4.0",
  "task_type": "normal",
  "prompt": "一首轻快的流行歌曲，主题是夏日海边的回忆",
  "n": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api2.aigcbest.top/incho/submit/music' \
--header 'Authorization: Bearer ' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "model": "v4.0",
  "task_type": "normal",
  "prompt": "一首轻快的流行歌曲，主题是夏日海边的回忆",
  "n": 2
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": "success",
    "data": "task_5HplCAI6Fr1ykNBcWJaAB0PpbGJq1nHp",
    "message": ""
}

修改于 2026-09-15 17:21:40

批量查询任务

单个查询任务