详细说明
Suno API 端点详细说明文档
基础信息
API 地址
默认地址:
https://api.timrouter.com/suno/submit/music
https://api.timrouter.com/suno/fetch模型全面支持
全面支持模型
- chirp-v3-0 (对应版本 v3.0)
- chirp-v3-5 (对应版本 v3.5)
- chirp-v4 (对应版本 v4.0)
- chirp-auk (对应版本 v4.5)
- chirp-v5 (对应版本 v5.0)
回调通知
全面支持 notify_hook 回调地址
要求:
- 发起请求方式: POST
- 接收数据: task数据结构
使用步骤
- 创建并产出Suno任务
- 查询任务进度
数据结构
Task对象
| 字段 | 类型 | 用例 | 描述 |
|---|---|---|---|
| task_id | string | f4a94d75-087b-4bb1-bd45-53ba293faf96 | 任务ID |
| action | string | MUSIC | 任务类型: MUSIC(产出歌)、LYRICS(产出歌词) |
| status | string | SUCCESS | 任务状态: NOT_START(未启动)、SUBMITTED(已提交处理)、QUEUED(排队)、IN_PROGRESS(执行中)、FAILURE(未顺利完成)、SUCCESS(顺利完成) |
| submitTime | number | 1689231405854 | 提交时间 |
| startTime | number | 1689231442755 | 开始执行时间 |
| finishTime | number | 1689231544312 | 结束时间 |
| failReason | string | [Invalid parameter] Invalid value | 未顺利完成原因(未顺利完成时有值) |
| data | object | - | 具体数据：音乐(数组)、歌词(单个) |
音乐续写需要传入 task_id 参数指定任务