查询单个任务
GET /luma/generations/{task_id}
说明
"state": "completed" 枚举值： "pending", "processing", "completed", "failed"
概览
| Method | GET |
|---|---|
| Path | /luma/generations/{task_id} |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 47679483 |
参数
{ "query": [], "path": [ { "id": "task_id#0", "name": "task_id", "required": true, "description": "任务id", "type": "string", "enable": true, "sampleValue": "4665a07c-7641-4809-a133-10786201bb56" } ], "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": "none", "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": "", "mediaType": "none", "description": "" } ], "oasExtensions": "" }
响应
[ { "id": 589857254, "name": "成功", "code": 200, "contentType": "json", "jsonSchema": { "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "video": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "download_url": { "type": "string" } }, "required": [ "url", "width", "height", "download_url" ] }, "request": { "type": "object", "properties": { "prompt": { "type": "string" }, "aspect_ratio": { "type": "string" } }, "required": [ "prompt", "aspect_ratio" ] }, "artifact": { "type": "object", "properties": { "video": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "download_url": { "type": "string" } }, "required": [ "url", "width", "height", "download_url" ] }, "thumbnail": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "palette": { "type": "object", "properties": { "grid": { "type": "string" } }, "required": [ "grid" ] }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "palette", "media_type" ] }, "video_raw": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "duration": { "type": "number" }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "duration", "media_type" ] }, "created_at": { "type": "string" }, "last_frame": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "palette": { "type": "null" }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "palette", "media_type" ] } }, "required": [ "video", "thumbnail", "video_raw", "created_at", "last_frame" ] }, "thumbnail": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "palette": { "type": "object", "properties": { "grid": { "type": "string" } }, "required": [ "grid" ] }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "palette", "media_type" ] }, "video_raw": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "duration": { "type": "number" }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "duration", "media_type" ] }, "created_at": { "type": "string" }, "last_frame": { "type": "object", "properties": { "url": { "type": "string" }, "width": { "type": "integer" }, "height": { "type": "integer" }, "palette": { "type": "null" }, "media_type": { "type": "string" } }, "required": [ "url", "width", "height", "palette", "media_type" ] } }, "required": [ "id", "state", "video", "request", "artifact", "thumbnail", "video_raw", "created_at", "last_frame" ] }, "itemSchema": {}, "description": "", "mediaType": "", "headers": [], "oasExtensions": "" } ]
响应示例
[ { "name": "成功示例", "responseId": 589857254, "data": "{\"id\": \"4665a07c-7641-4809-a133-10786201bb56\", \"state\": \"completed\", \"video\": {\"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\", \"width\": 1360, \"height\": 752, \"download_url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\"}, \"request\": {\"prompt\": \"cat dance\", \"aspect_ratio\": \"16:9\"}, \"artifact\": {\"video\": {\"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\", \"width\": 1360, \"height\": 752, \"download_url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\"}, \"thumbnail\": {\"url\": \"https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public\", \"width\": 1360, \"height\": 752, \"palette\": {\"grid\": \"em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP\"}, \"media_type\": \"image\"}, \"video_raw\": {\"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\", \"width\": 1360, \"height\": 752, \"duration\": 5.041667, \"media_type\": \"video\"}, \"created_at\": \"0001-01-01T00:00:00Z\", \"last_frame\": {\"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, \"height\": 752, \"palette\": null, \"media_type\": \"image\"}}, \"thumbnail\": {\"url\": \"https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public\", \"width\": 1360, \"height\": 752, \"palette\": {\"grid\": \"em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP\"}, \"media_type\": \"image\"}, \"video_raw\": {\"url\": \"https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4\", \"width\": 1360, \"height\": 752, \"duration\": 5.041667, \"media_type\": \"video\"}, \"created_at\": \"2024-12-22T13:38:40.139Z\", \"last_frame\": {\"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, \"height\": 752, \"palette\": null, \"media_type\": \"image\"}}", "description": "", "oasKey": "", "oasExtensions": "", "id": 463791382 } ]