任务查询_单个 - API4GPT Docs

请求参数

Path 参数

task_id

string

必需

生成音乐/歌词时返回的任务ID，如：lyrics-8f21ecfd-7835-40db-ab61-a2b6eed1819b

Header 参数

Authorization

string

必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token

示例值:

Bearer Token

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例成功示例

{
    "code": "success",
    "message": "",
    "data": {
        "task_id": "616299f7-97fa-b517-79a5-124f05b684ee",
        "action": "",
        "status": "SUCCESS",
        "fail_reason": "",
        "submit_time": 1735870498,
        "start_time": 1735870498,
        "finish_time": 1735870667,
        "progress": "100%",
        "data": [
            {
                "id": "24e14224-670f-47bb-b128-052aa2c4d43a",
                "mv": "chirp-v4",
                "msg": "",
                "tags": "chill dream pop",
                "state": "succeeded",
                "title": "2025元旦快乐",
                "prompt": "[Verse]\n蛇年到来人欢笑\n烟花绽放天空耀\n红灯笼挂满小巷\n好运连连心中藏\n\n[Verse 2]\n舞龙舞狮庆祝忙\n新衣新鞋穿上场\n一家团圆煮年糕\n祝福声声响天高\n\n[Chorus]\n蛇年好运运势高\n福星高照不动摇\n行大运来财运到\n喜气洋洋心欢跳\n\n[Verse 3]\n年夜饭桌菜肴香\n亲朋好友齐来尝\n鞭炮声声驱邪恶\n新的一年更辉煌\n\n[Bridge]\n希望连连心欢畅\n梦想成真迎朝阳\n蛇年吉祥如意长\n富贵平安永流淌\n\n[Chorus]\n蛇年好运运势高\n福星高照不动摇\n行大运来财运到\n喜气洋洋心欢跳",
                "status": "complete",
                "clip_id": "24e14224-670f-47bb-b128-052aa2c4d43a",
                "history": null,
                "task_id": "616299f7-97fa-b517-79a5-124f05b684ee_1",
                "duration": 153,
                "audio_url": "https://cdn1.suno.ai/24e14224-670f-47bb-b128-052aa2c4d43a.mp3",
                "image_url": "https://cdn2.suno.ai/image_24e14224-670f-47bb-b128-052aa2c4d43a.jpeg",
                "video_url": "https://cdn1.suno.ai/24e14224-670f-47bb-b128-052aa2c4d43a.mp4",
                "continue_at": "120",
                "create_time": "1735870502",
                "update_time": "1735870627",
                "concat_history": null,
                "image_large_url": "https://cdn2.suno.ai/image_large_24e14224-670f-47bb-b128-052aa2c4d43a.jpeg",
                "continue_clip_id": null,
                "gpt_description_prompt": null
            },
            {
                "id": "96d42e40-6809-4e4d-9759-300d0f55ba2e",
                "mv": "chirp-v4",
                "msg": "",
                "tags": "chill dream pop",
                "state": "succeeded",
                "title": "2025元旦快乐",
                "prompt": "[Verse]\n蛇年到来人欢笑\n烟花绽放天空耀\n红灯笼挂满小巷\n好运连连心中藏\n\n[Verse 2]\n舞龙舞狮庆祝忙\n新衣新鞋穿上场\n一家团圆煮年糕\n祝福声声响天高\n\n[Chorus]\n蛇年好运运势高\n福星高照不动摇\n行大运来财运到\n喜气洋洋心欢跳\n\n[Verse 3]\n年夜饭桌菜肴香\n亲朋好友齐来尝\n鞭炮声声驱邪恶\n新的一年更辉煌\n\n[Bridge]\n希望连连心欢畅\n梦想成真迎朝阳\n蛇年吉祥如意长\n富贵平安永流淌\n\n[Chorus]\n蛇年好运运势高\n福星高照不动摇\n行大运来财运到\n喜气洋洋心欢跳",
                "status": "complete",
                "clip_id": "96d42e40-6809-4e4d-9759-300d0f55ba2e",
                "history": null,
                "task_id": "616299f7-97fa-b517-79a5-124f05b684ee_2",
                "duration": 182,
                "audio_url": "https://cdn1.suno.ai/96d42e40-6809-4e4d-9759-300d0f55ba2e.mp3",
                "image_url": "https://cdn2.suno.ai/image_96d42e40-6809-4e4d-9759-300d0f55ba2e.jpeg",
                "video_url": "https://cdn1.suno.ai/96d42e40-6809-4e4d-9759-300d0f55ba2e.mp4",
                "continue_at": "120",
                "create_time": "1735870502",
                "update_time": "1735870653",
                "concat_history": null,
                "image_large_url": "https://cdn2.suno.ai/image_large_96d42e40-6809-4e4d-9759-300d0f55ba2e.jpeg",
                "continue_clip_id": null,
                "gpt_description_prompt": null
            }
        ]
    }
}