查询单个任务

GEThttps://www.aipro2.com/luma/generations/{task_id}

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

Path 参数

• id*string
  创建任务时返回的 id

  示例a1b2c3d4-e5f6-7890-abcd-ef1234567890

请求体参数

none

• aspect_ratio*string
  生成图片的纵横比，可选，可选值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
• callback_url*string
  回调通知地址，可选，当任务状态发生变化时，系统会向这个地址发送通知
• image*string
  参考图片，可选，支持 Base64 编码或图片 URL，支持 .jpg/.jpeg/.png 格式，大小不能超过 10MB
• image_fidelity*number
  参考图片的影响强度，可选，取值范围：0-1，值越大，生成的图像越接近参考图片
• model*string
  使用的模型，可选，默认为 kling-image
• n*integer
  生成图片的数量，可选，取值范围：1-9
• negative_prompt*string
  负向提示词，可选，描述你不想在图像中出现的元素，不能超过200个字符
• prompt*string
  正向提示词，必需，描述你想要生成的图像内容，不能超过500个字符

响应

成功

application/jsonLumaGenerationResponse

• batch_idstring
  批次 ID
• created_atstring
  创建时间
• estimate_wait_secondsinteger
  预估等待时间（秒） 预估等待时间（秒）
• idstring
  任务 ID 任务 ID
• last_frameobject
  末帧图片 URL
• promptstring
  使用的提示词 使用的提示词
• queue_statestring
  排队状态
• statestring
  任务状态 任务状态

  可选值queuedpendingprocessingcompletedfailed
• thumbnailobject
  缩略图 URL
• videoobject
  视频 URL 或标识

代码示例cURLPythonJavaScriptGoPHP

1curl -X GET "https://www.aipro2.com/luma/generations/{task_id}" \2  -H "Authorization: Bearer <API Key>"

响应示例 · 200成功示例

1{2  "artifact": {3    "created_at": "0001-01-01T00:00:00Z",4    "last_frame": {5      "height": 752,6      "media_type": "image",7      "palette": null,8      "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",9      "width": 136010    },11    "thumbnail": {12      "height": 752,13      "media_type": "image",14      "palette": {15        "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"16      },17      "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",18      "width": 136019    },20    "video": {21      "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",22      "height": 752,23      "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",24      "width": 136025    },26    "video_raw": {27      "duration": 5.041667,28      "height": 752,29      "media_type": "video",30      "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",31      "width": 136032    }33  },34  "created_at": "2024-12-22T13:38:40.139Z",35  "id": "4665a07c-7641-4809-a133-10786201bb56",36  "last_frame": {37    "height": 752,38    "media_type": "image",39    "palette": null,40    "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/606108d9-9daf-4265-84fb-595f18240ac5/video_0_last_frame.jpg",41    "width": 136042  },43  "request": {44    "aspect_ratio": "16:9",45    "prompt": "cat dance"46  },47  "state": "completed",48  "thumbnail": {49    "height": 752,50    "media_type": "image",51    "palette": {52      "grid": "em9csKqXYUgqdHVmmqeZLB8YaFpLjVw2bmFTTElBHhMNTzgodD8eVzUeTDorRSkYYEQymV80e1M0ck0ugWVRwKCApWk0hF1BgmVP"53    },54    "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/e4268de5-4a74-45ff-67b8-dc46df12de00/public",55    "width": 136056  },57  "video": {58    "download_url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",59    "height": 752,60    "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",61    "width": 136062  },63  "video_raw": {64    "duration": 5.041667,65    "height": 752,66    "media_type": "video",67    "url": "https://storage.cdn-luma.com/dream-machine/b0d67582-c6f0-4973-a89c-3fea9d46d5e9/35049450-c008-4607-b1d0-0b025599f15d/video0b6619468da8e409da860706bbf26bbad.mp4",68    "width": 136069  }70}