主题
批量获取任务
POST
https://az.gptplus5.com/luma/tasks
"state": "completed" 枚举值: "pending", "processing", "completed", "failed"
请求参数
Authorization
在 Header 添加参数Authorization,其值为在 Bearer 之后拼接 Token
示例:Authorization: Bearer ********************
Header 参数
| 参数名 | 类型 | 必需 | 说明 | 示例 |
|---|---|---|---|---|
Content-Type | string | 必需 | application/json | |
Accept | 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,值越大,生成的图像越接近参考图片 |
n | integer | 必需 | 生成图片的数量,可选,取值范围:1-9 |
aspect_ratio | string | 必需 | 生成图片的纵横比,可选,可选值:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 |
callback_url | string | 必需 | 回调通知地址,可选,当任务状态发生变化时,系统会向这个地址发送通知 |
请求示例
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
}
}
]