批量获取任务 - 薛定猫API官方文档

请求参数

Authorization

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
    }
  }
]