- 序言
- OpenAI接口
- Suno音乐接口
- 绘画接口
- 视频接口
- 文本生成（通用）
- 可灵AI
批量查询任务
POST
https://api.openai-hub.com/suno/fetch
任务查询
请求参数
Header 参数
Authorization
string
必需
示例
Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379
默认值:
Bearer {{YOUR_API_KEY}}
Content-Type
string
可选
默认值:
application/json
Body 参数application/json
ids
array[string]
必需
示例值:
["string"]
action
string
必需
示例值:
string
示例
{
"ids": [
"string"
],
"action": "string"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.openai-hub.com/suno/fetch' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"ids": [
"string"
],
"action": "string"
}'返回响应
🟢200成功
application/json
Body
code
string
响应代码
示例值:
success
message
string
响应消息
示例值:
data
array [object {10}]
可选
task_id
string
任务ID
示例值:
346c5d10-a4a1-4f49-a851-66a7dae6cfaf
notify_hook
string
回调地址
示例值:
action
string
操作类型
示例值:
MUSIC
status
string
任务状态
示例值:
IN_PROGRESS
fail_reason
string
失败原因
示例值:
submit_time
integer
提交时间
示例值:
1716191749
start_time
integer
开始时间
示例值:
1716191786
finish_time
integer
完成时间
示例值:
0
progress
string
任务进度
示例值:
0%
data
array [object {10}]
可选
示例
{
"code": "success",
"message": "",
"data": [
{
"task_id": "346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
"notify_hook": "",
"action": "MUSIC",
"status": "IN_PROGRESS",
"fail_reason": "",
"submit_time": 1716191749,
"start_time": 1716191786,
"finish_time": 0,
"progress": "0%",
"data": [
{
"id": "e9893d04-6a63-4007-8473-64b706eca4d1",
"title": "Electric Dance Party",
"status": "streaming",
"metadata": {
"tags": "club banger high-energy edm",
"prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
"duration": null,
"error_type": null,
"error_message": null,
"audio_prompt_id": null,
"gpt_description_prompt": "miku dance"
},
"audio_url": "https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
"image_url": "https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
"video_url": "",
"model_name": "chirp-v3",
"image_large_url": "https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png",
"major_model_version": "v3"
},
{
"id": "fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
"title": "Electric Dance Party",
"status": "streaming",
"metadata": {
"tags": "club banger high-energy edm",
"prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
"duration": null,
"error_type": null,
"error_message": null,
"audio_prompt_id": null,
"gpt_description_prompt": "miku dance"
},
"audio_url": "https://audiopipe.suno.ai/?item_id=fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
"image_url": "https://cdn1.suno.ai/image_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
"video_url": "",
"model_name": "chirp-v3",
"image_large_url": "https://cdn1.suno.ai/image_large_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
"major_model_version": "v3"
}
]
}
]
}