AI 接口文档
  1. 任务查询
AI 接口文档
  • 发出请求
  • 模型接口
    • 聊天(Chat)
      • 实时语音
      • 聊天对话(OpenAI格式)
      • 聊天对话(Claude格式)
      • 识别文件
      • 识别图片
      • 联网对话
      • gpts
    • 自动补全(Completions)
      • 内容补全接口
    • 文生图片(Images)
      • Midjourney
        • 补充 - 其他参数以及回调
        • InsightFace任务提交
          • 提交swap_face任务
        • 任务提交
          • 执行动作
          • 提交Blend任务
          • 提交Describe任务
          • 提交Imagine任务
          • 提交Modal
          • 提交Shorten任务
        • 任务查询
          • 查询所有任务
          • 根据ID列表查询任务
          • 分页查询任务
          • 查询任务队列
          • 取消任务
          • 指定ID获取任务
          • 获取任务图片的seed(需设置mj或niji的私信ID)
      • DALL·E 3
      • Stable-Diffusion
      • gpt-4o-image
      • gpt-image-1
    • 向量生成(Embeddings)
      • 创建嵌入
    • 音频(Audio)
      • 创建转录
      • 创建翻译
      • TTS文本转语音
    • Suno 文生歌曲
      • 官方格式
        • 任务提交
          • 生成歌曲
          • 生成歌词
        • 任务查询
          • 查询单个任务
            GET
          • 批量获取任务
            GET
      • OpenAI 聊天格式
        POST
    • Flux 文生图
      • OpenAI 聊天格式
    • Luma 文生视频
      • OpenAI 聊天格式
  • 帮助中心
    • 常见问题及解决办法
  1. 任务查询

批量获取任务

GET
https://aigc.x-see.cn/suno/fetch

请求参数

Header 参数
Authorization
string 
必需
默认值:
API KEY 令牌
Content-Type
string 
必需
默认值:
application/json
Body 参数application/json
ids
array[string]
必需
task_id 列表
action
string 
可选
操作:MUSIC、LYRICS
示例
{
  "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 GET 'https://aigc.x-see.cn/suno/fetch' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "string"
    ],
    "action": "string"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
  "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"
        }
      ]
    }
  ]
}
上一页
查询单个任务
下一页
OpenAI 聊天格式
Built with