- (必读)网站使用教程
- (必读)前言
- 批量请求示例
- 常见问题及解决办法
- 聊天模型
- 音乐生成
- Suno
- 接口介绍
- 场景一：续写音乐并获取完整音乐
- 场景二：Cover 音乐:音乐翻版\修改风格
- 场景三：Replace Section:替换片段
- 场景四：Persona:歌手风格
- 场景五：stems:声曲分离(仅限chirp_auk)
- 场景六：Timing:歌词、音频时间线(仅限chirp_auk)
- 场景七：wav:获取 wav 格式文件
- 场景八：mp4:生成 mp4 mv 视频(仅限chirp_auk)
- 聊天方式：生成歌曲POST
- 任务：生成歌曲POST
- 任务：生成歌词POST
- 上传音乐POST
- 歌曲拼接POST
- 查询：批量查询任务POST
- 获取 wav 格式文件GET
- 生成 mp4 mv 视频GET
- 声曲分离GET
- 查询：单个任务GET
- Timing:歌词、音频时间线GET
- Udio
- 绘画模型
- 音频模型
- 视频生成
- 查询令牌用量GET
- 查询令牌限额GET
查询：单个任务
GET
https://api.apicore.ai/suno/fetch/{task_id}
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Path 参数
task_id
string
必需
示例值:
2a145658-3342-4228-b779-b8323a2b77df
Header 参数
Content-Type
string
可选
示例值:
application/json
Authorization
string
可选
示例值:
Bearer sk-xxxx
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.apicore.ai/suno/fetch/' \
--header 'Authorization: Bearer sk-xxxx' \
--header 'Content-Type: application/json'返回响应
🟢200成功
application/json
Body
code
string
必需
message
string
必需
data
array [object {9}]
必需
task_id
string
可选
action
string
可选
status
string
可选
fail_reason
string
可选
submit_time
integer
可选
start_time
integer
可选
finish_time
integer
可选
progress
string
可选
data
array [object {22}]
可选
示例
{
"code": "success",
"message": "",
"data": {
"task_id": "2a145658-3342-4228-b779-b8323a2b77df",
"action": "MUSIC",
"status": "SUCCESS",
"fail_reason": "",
"submit_time": 1726911801,
"start_time": 1726911812,
"finish_time": 1726911897,
"progress": "100%",
"data": [
{
"id": "3435e194-50e7-4edc-9442-bffe072fccfc",
"title": "快乐周末",
"handle": "yellowrobots6855",
"status": "complete",
"user_id": "ee5e241a-ead6-435d-bea8-526c77c04c72",
"is_liked": false,
"metadata": {
"tags": "heartfelt salsa",
"type": "gen",
"prompt": "",
"stream": true,
"history": null,
"duration": 128.92,
"error_type": null,
"error_message": null,
"concat_history": null,
"refund_credits": false,
"audio_prompt_id": null,
"gpt_description_prompt": null
},
"reaction": null,
"audio_url": "https://cdn1.suno.ai/3435e194-50e7-4edc-9442-bffe072fccfc.mp3",
"image_url": "https://cdn2.suno.ai/image_3435e194-50e7-4edc-9442-bffe072fccfc.jpeg",
"is_public": false,
"video_url": "https://cdn1.suno.ai/3435e194-50e7-4edc-9442-bffe072fccfc.mp4",
"created_at": "2024-09-21T09:43:21.637Z",
"is_trashed": false,
"model_name": "chirp-v3",
"play_count": 0,
"display_name": "YellowRobots6855",
"upvote_count": 0,
"image_large_url": "https://cdn2.suno.ai/image_large_3435e194-50e7-4edc-9442-bffe072fccfc.jpeg",
"is_video_pending": false,
"is_handle_updated": false,
"major_model_version": "v3.5"
},
{
"id": "1d01fcc8-71bf-4e0f-ab0a-880a0580e6fe",
"title": "快乐周末",
"handle": "yellowrobots6855",
"status": "complete",
"user_id": "ee5e241a-ead6-435d-bea8-526c77c04c72",
"is_liked": false,
"metadata": {
"tags": "heartfelt salsa",
"type": "gen",
"prompt": "",
"stream": true,
"history": null,
"duration": 148.28,
"error_type": null,
"error_message": null,
"concat_history": null,
"refund_credits": false,
"audio_prompt_id": null,
"gpt_description_prompt": null
},
"reaction": null,
"audio_url": "https://cdn1.suno.ai/1d01fcc8-71bf-4e0f-ab0a-880a0580e6fe.mp3",
"image_url": "https://cdn2.suno.ai/image_1d01fcc8-71bf-4e0f-ab0a-880a0580e6fe.jpeg",
"is_public": false,
"video_url": "https://cdn1.suno.ai/1d01fcc8-71bf-4e0f-ab0a-880a0580e6fe.mp4",
"created_at": "2024-09-21T09:43:21.637Z",
"is_trashed": false,
"model_name": "chirp-v3",
"play_count": 0,
"display_name": "YellowRobots6855",
"upvote_count": 0,
"image_large_url": "https://cdn2.suno.ai/image_large_1d01fcc8-71bf-4e0f-ab0a-880a0580e6fe.jpeg",
"is_video_pending": true,
"is_handle_updated": false,
"major_model_version": "v3.5"
}
]
}
}