批量获取任务

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

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Content-Type

string

必需

示例值:

application/json

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

model

string

必需

使用的模型，可选，默认为 kling-image

prompt

string

必需

正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符

negative_prompt

string

必需

负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符

image

string

必需

参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB

image_fidelity

number

必需

参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片

integer

必需

生成图片的数量，可选，取值范围：1-9

aspect_ratio

string

必需

生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3

callback_url

string

必需

回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

array of:

artifact

object

可选

created_at

string

必需

last_frame

object

必需

thumbnail

object

必需

video

object

必需

video_raw

object

必需

created_at

string

可选

string

可选

last_frame

object

可选

height

integer

必需

media_type

string

必需

palette

null

必需

url

string

必需

width

integer

必需

request

object

可选

aspect_ratio

string

必需

prompt

string

必需

state

string

可选

thumbnail

object

可选

height

integer

必需

media_type

string

必需

palette

object

必需

url

string

必需

width

integer

必需

video

object

可选

download_url

string

必需

height

integer

必需

url

string

必需

width

integer

必需

video_raw

object

可选

duration

number

必需

height

integer

必需

media_type

string

必需

url

string

必需

width

integer

必需

示例

[
    {
        "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
        }
    }
]