Query: Single Task

Luma video task query API for retrieving the status and generation results of a specific task.

---

Overview

• Method: GET
• Path: /luma/generations/{task_id}
• Content-Type: application/json
• Category: Video Models (Video) / Luma Video

Authentication

• Header: Authorization: Bearer <token>

---

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Task ID of the generated video

---

Request Example

curl Example

curl -X GET "https://api.gpt.ge/luma/generations/your_task_id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/luma/generations/your_task_id', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  }
})
  .then(res => res.json())
  .then(console.log)

Python Example (requests)

import requests

resp = requests.get(
    'https://api.gpt.ge/luma/generations/your_task_id',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)
print(resp.json())

---

Response Fields

Field	Type	Description
id	string	Task ID
state	string	Task status
video	object	Generated video information
video.url	string	Video URL
video.width	integer	Video width
video.height	integer	Video height
video.download_url	string	Video download URL
request	object	Original request information
request.prompt	string	Prompt text
request.aspect_ratio	string	Aspect ratio
artifact	object	Generated artifacts collection
artifact.video	object	Artifact video information
artifact.thumbnail	object	Generated thumbnail information
artifact.video_raw	object	Raw video information
artifact.created_at	string	Artifact creation time
artifact.last_frame	object	Last frame information
thumbnail	object	Thumbnail information
video_raw	object	Raw video information (duplicate field)
created_at	string	Task creation time
last_frame	object	Last frame information
failure_reason	string/null	Failure reason, null if successful

---

Response Example (200)

{
  "id": "e70fdf3c-ce95-4dd1-a967-220ce957aff5",
  "state": "completed",
  "video": {
    "url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.mp4",
    "width": 1360,
    "height": 752,
    "download_url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.mp4"
  },
  "request": {
    "prompt": "mermaid",
    "aspect_ratio": "16:9"
  },
  "artifact": {
    "video": {
      "url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.mp4",
      "width": 1360,
      "height": 752,
      "download_url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.mp4"
    },
    "thumbnail": {
      "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/3d9fbfa9-6146-4eb9-3798-ac923a2a0e00/public",
      "width": 1360,
      "height": 752,
      "palette": {
        "grid": "CpCVPb67UdHMHbW0F42QHWBmX2FcJLSxAKipHH6DTFVTcU9GWpqdHJykU2lyel9MWEU/UF9vRH+aSFlrcVVOcVVISVFFSG97S1dp"
      },
      "media_type": "image"
    },
    "video_raw": {
      "url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.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/907ef9be-7057-45de-9867-099d6aba37b7/543b6898-5179-4477-bc9f-f6507c7cde97/video_0_last_frame.jpg",
      "width": 1360,
      "height": 752,
      "palette": null,
      "media_type": "image"
    }
  },
  "thumbnail": {
    "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/3d9fbfa9-6146-4eb9-3798-ac923a2a0e00/public",
    "width": 1360,
    "height": 752,
    "palette": {
      "grid": "CpCVPb67UdHMHbW0F42QHWBmX2FcJLSxAKipHH6DTFVTcU9GWpqdHJykU2lyel9MWEU/UF9vRH+aSFlrcVVOcVVISVFFSG97S1dp"
    },
    "media_type": "image"
  },
  "video_raw": {
    "url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/6ece4f7a-f60a-442c-9ad2-84132a528741/video0bb8885f3511c4b7bad55c117405a2875.mp4",
    "width": 1360,
    "height": 752,
    "duration": 5.041667,
    "media_type": "video"
  },
  "created_at": "2024-12-24T18:01:25.319Z",
  "last_frame": {
    "url": "https://storage.cdn-luma.com/dream-machine/907ef9be-7057-45de-9867-099d6aba37b7/543b6898-5179-4477-bc9f-f6507c7cde97/video_0_last_frame.jpg",
    "width": 1360,
    "height": 752,
    "palette": null,
    "media_type": "image"
  },
  "failure_reason": null
}