批量获取任务
POST /luma/tasks
说明
"state": "completed" 枚举值： "pending", "processing", "completed", "failed"
概览
| Method | POST |
|---|---|
| Path | /luma/tasks |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 47679483 |
参数
{ "query": [], "path": [], "cookie": [], "header": [ { "id": "NQs7bxnpZf", "name": "Content-Type", "required": true, "description": "", "type": "string", "enable": true, "sampleValue": "application/json" }, { "id": "qb8tEQbCty", "name": "Accept", "required": true, "description": "", "type": "string", "enable": true, "sampleValue": "application/json" }, { "required": true, "description": "", "type": "string", "id": "gBxcCbXhsa", "enable": true, "name": "Authorization", "sampleValue": "Bearer {{YOUR_API_KEY}}" } ] }
请求体
{ "type": "application/json", "parameters": [], "jsonSchema": { "type": "object", "properties": { "model": { "description": "使用的模型，可选，默认为 kling-image", "type": "string" }, "prompt": { "description": "正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符", "type": "string" }, "negative_prompt": { "description": "负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符", "type": "string" }, "image": { "description": "参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB", "type": "string" }, "image_fidelity": { "description": "参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片", "type": "number" }, "n": { "description": "生成图片的数量，可选，取值范围：1-9", "type": "integer" }, "aspect_ratio": { "description": "生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3", "type": "string" }, "callback_url": { "description": "回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知", "type": "string" } }, "required": [ "model", "prompt", "negative_prompt", "image", "image_fidelity", "n", "aspect_ratio", "callback_url" ], "x-apifox-orders": [ "model", "prompt", "negative_prompt", "image", "image_fidelity", "n", "aspect_ratio", "callback_url" ] }, "mediaType": "", "examples": [ { "value": "{\n \"ids\": [\n \"4665a07c-7641-4809-a133-10786201bb56\"\n ]\n}", "mediaType": "application/json", "description": "" } ], "oasExtensions": "" }
响应
[ { "id": 589857255, "name": "成功", "code": 200, "contentType": "json", "jsonSchema": { "type": "array", "items": { "type": "object", "properties": { "artifact": { "type": "object", "properties": { "created_at": { "type": "string" }, "last_frame": { "type": "object", "properties": { "height": { "type": "integer" }, "media_type": { "type": "string" }, "palette": { "type": "null" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "height", "media_type", "palette", "url", "width" ] }, "thumbnail": { "type": "object", "properties": { "height": { "type": "integer" }, "media_type": { "type": "string" }, "palette": { "type": "object", "properties": { "grid": { "type": "string" } }, "required": [ "grid" ] }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "height", "media_type", "palette", "url", "width" ] }, "video": { "type": "object", "properties": { "download_url": { "type": "string" }, "height": { "type": "integer" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "download_url", "height", "url", "width" ] }, "video_raw": { "type": "object", "properties": { "duration": { "type": "number" }, "height": { "type": "integer" }, "media_type": { "type": "string" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "duration", "height", "media_type", "url", "width" ] } }, "required": [ "created_at", "last_frame", "thumbnail", "video", "video_raw" ] }, "created_at": { "type": "string" }, "id": { "type": "string" }, "last_frame": { "type": "object", "properties": { "height": { "type": "integer" }, "media_type": { "type": "string" }, "palette": { "type": "null" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "height", "media_type", "palette", "url", "width" ] }, "request": { "type": "object", "properties": { "aspect_ratio": { "type": "string" }, "prompt": { "type": "string" } }, "required": [ "aspect_ratio", "prompt" ] }, "state": { "type": "string" }, "thumbnail": { "type": "object", "properties": { "height": { "type": "integer" }, "media_type": { "type": "string" }, "palette": { "type": "object", "properties": { "grid": { "type": "string" } }, "required": [ "grid" ] }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "height", "media_type", "palette", "url", "width" ] }, "video": { "type": "object", "properties": { "download_url": { "type": "string" }, "height": { "type": "integer" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "download_url", "height", "url", "width" ] }, "video_raw": { "type": "object", "properties": { "duration": { "type": "number" }, "height": { "type": "integer" }, "media_type": { "type": "string" }, "url": { "type": "string" }, "width": { "type": "integer" } }, "required": [ "duration", "height", "media_type", "url", "width" ] } } } }, "itemSchema": {}, "description": "", "mediaType": "", "headers": [], "oasExtensions": "" } ]
响应示例
[ { "name": "成功示例", "responseId": 589857255, "data": "[\r\n {\r\n \"artifact\": {\r\n \"created_at\": \"0001-01-01T00:00:00Z\",\r\n \"last_frame\": {\r\n \"height\": 752,\r\n \"media_type\": \"image\",\r\n \"palette\": null,\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg\",\r\n \"width\": 1360\r\n },\r\n \"thumbnail\": {\r\n \"height\": 752,\r\n \"media_type\": \"image\",\r\n \"palette\": {\r\n \"grid\": \"em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP\"\r\n },\r\n \"url\": \"https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public\",\r\n \"width\": 1360\r\n },\r\n \"video\": {\r\n \"download_url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"height\": 752,\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"width\": 1360\r\n },\r\n \"video_raw\": {\r\n \"duration\": 5.041667,\r\n \"height\": 752,\r\n \"media_type\": \"video\",\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"width\": 1360\r\n }\r\n },\r\n \"created_at\": \"2024-12-22T13:38:40.139Z\",\r\n \"id\": \"4665a07c-7641-4809-a133-10786201bb56\",\r\n \"last_frame\": {\r\n \"height\": 752,\r\n \"media_type\": \"image\",\r\n \"palette\": null,\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg\",\r\n \"width\": 1360\r\n },\r\n \"request\": {\r\n \"aspect_ratio\": \"16:9\",\r\n \"prompt\": \"cat dance\"\r\n },\r\n \"state\": \"completed\",\r\n \"thumbnail\": {\r\n \"height\": 752,\r\n \"media_type\": \"image\",\r\n \"palette\": {\r\n \"grid\": \"em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP\"\r\n },\r\n \"url\": \"https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public\",\r\n \"width\": 1360\r\n },\r\n \"video\": {\r\n \"download_url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"height\": 752,\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"width\": 1360\r\n },\r\n \"video_raw\": {\r\n \"duration\": 5.041667,\r\n \"height\": 752,\r\n \"media_type\": \"video\",\r\n \"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\",\r\n \"width\": 1360\r\n }\r\n }\r\n]", "description": "", "oasKey": "", "oasExtensions": "", "id": 463791383 } ]