Skip to content

批量获取任务

POST https://az.gptplus5.com/luma/tasks

"state": "completed" 枚举值: "pending", "processing", "completed", "failed"

请求参数

Authorization

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

示例:Authorization: Bearer ********************

Header 参数

参数名类型必需说明示例
Content-Typestring必需application/json
Acceptstring必需application/json
Authorizationstring必需Bearer {{YOUR_API_KEY}}

Body 参数 (application/json)

参数名类型必需说明
modelstring必需使用的模型,可选,默认为 kling-image
promptstring必需正向提示词,必需,描述你想要生成的图像内容,不能超过500个字符
negative_promptstring必需负向提示词,可选,描述你不想在图像中出现的元素,不能超过200个字符
imagestring必需参考图片,可选,支持 Base64 编码或图片 URL,支持 .jpg/.jpeg/.png 格式,大小不能超过 10MB
image_fidelitynumber必需参考图片的影响强度,可选,取值范围:0-1,值越大,生成的图像越接近参考图片
ninteger必需生成图片的数量,可选,取值范围:1-9
aspect_ratiostring必需生成图片的纵横比,可选,可选值:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
callback_urlstring必需回调通知地址,可选,当任务状态发生变化时,系统会向这个地址发送通知

请求示例

json
{
    "ids": [
        "4665a07c-7641-4809-a133-10786201bb56"
    ]
}

cURL 示例

bash
curl --location --request POST 'https://az.gptplus5.com/luma/tasks' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "4665a07c-7641-4809-a133-10786201bb56"
    ]
}'

返回响应

🟢200成功

响应示例

json
[
    {
        "artifact": {
            "created_at": "0001-01-01T00:00:00Z",
            "last_frame": {
                "height": 752,
                "media_type": "image",
                "palette": null,
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",
                "width": 1360
            },
            "thumbnail": {
                "height": 752,
                "media_type": "image",
                "palette": {
                    "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"
                },
                "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",
                "width": 1360
            },
            "video": {
                "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "height": 752,
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "width": 1360
            },
            "video_raw": {
                "duration": 5.041667,
                "height": 752,
                "media_type": "video",
                "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
                "width": 1360
            }
        },
        "created_at": "2024-12-22T13:38:40.139Z",
        "id": "4665a07c-7641-4809-a133-10786201bb56",
        "last_frame": {
            "height": 752,
            "media_type": "image",
            "palette": null,
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",
            "width": 1360
        },
        "request": {
            "aspect_ratio": "16:9",
            "prompt": "cat dance"
        },
        "state": "completed",
        "thumbnail": {
            "height": 752,
            "media_type": "image",
            "palette": {
                "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"
            },
            "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",
            "width": 1360
        },
        "video": {
            "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "height": 752,
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "width": 1360
        },
        "video_raw": {
            "duration": 5.041667,
            "height": 752,
            "media_type": "video",
            "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",
            "width": 1360
        }
    }
]