Docs
  1. Luma Video
Docs
  • Introduction
  • Quick Start Guide
  • Make a request
  • Chat Models
    • ChatGpt
      • ChatGPT (Audio)
        • Create a voice
        • Create a transcript
        • Create translation
      • ChatGPT (Chat)
        • Chat completion object
        • Create chat completion (streaming)
        • Create chat completion (non-streaming)
        • Create chat image recognition (streaming)
        • Create chat image recognition (streaming) base64
        • Create chat image recognition (non-streaming)
        • Function calling
        • N choices
        • Create chat function call (only non-streaming)
        • Create structured output
      • ChatGPT (Completions)
        • Completion object
        • Creation completed
      • ChatGPT（Embeddings）
        • Embedded Object
        • Create embed
    • Anthropic Claude
      • Create chat completion (streaming)
      • Create chat completion (non-streaming)
      • Create chat image recognition (streaming)
      • Create chat image recognition (non-streaming)
    • Gemini
      • Gemini Image creation interface (gemini-2.0-flash-exp-image-generation)
      • Chat interface
      • Image recognition interface
  • Image Models
    • MJ
      • Submit Imagine task (mj_imagine)
      • Submit Blend task (mj_blend)
      • Submit Describe task (mj_describe)
      • Submit Change task (mj_variation, mj_upscale,mj_reroll)
      • Query task status based on task ID
    • Ideogram
      • Generate with Ideogram 3.0
      • Edit with Ideogram 3.0
      • Remix with Ideogram 3.0
    • Kling Image
      • Submit Image Generation
      • Get Image by Task ID
      • Submit Kolors Virtual Try On
      • Get Kolors Virtual Try On by Task ID
    • DALL·E 3
      POST
    • Flux (OpenAI dall-e-3 format)
      POST
  • Video Models
    • Kling Video
      • Create Video by Text
      • Get Video by Task ID(text2video)
      • Create Video by Image
      • Get Video by Task ID(image2video)
    • Runway ML Video
      • Create Video by Runway
      • Get Video by Task ID
    • Luma Video
      • Create Video by Luma
        POST
      • Get Video by Task ID
        GET
    • Pika Video
      • Create Video by Pika
      • Get Video by Task ID
  • Music Model - Suno
    • Illustrate
    • Parameter
    • Task submission
      • Generate songs (inspiration, customization, continuation)
      • Generate lyrics
    • Query interface
      • Query a single task
  • Python Samples
    • python openai official library (using AutoGPT, langchain, etc.)
    • Python uses speech to text
    • Python uses text to speech
    • Python uses Embeddings
    • python calls DALL·E
    • python simple call openai function-calling demo
    • python langchain
    • python llama_index
    • Python uses gpt-4o to identify pictures-local pictures
    • python library streaming output
    • Python uses gpt-4o to identify images
  • Plug-in/software usage tutorials
    • Setting HTTP for Make.com with Yescale
    • Sample Code for gpt-4o-audio/gpt-4o-mini-audio
  • Help Center
    • HTTP status codes
  1. Luma Video

Get Video by Task ID

GET
/luma/generations/{task_id}
Fetch Video by Task ID

Request

Path Params
task_id
string 
required

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/luma/generations/'

Responses

🟢200Ok
application/json
Body
artifact
object 
required
created_at
string 
required
last_frame
object 
required
thumbnail
object 
required
video_raw
object 
required
assets
object 
required
video
string 
required
created_at
string 
required
id
string 
required
last_frame
object 
required
height
integer 
required
media_type
string 
required
palette
null 
required
url
string 
required
width
integer 
required
media_request
object 
required
end
null 
required
loop
boolean 
required
prompt_type
string 
required
rich_text
null 
required
start
object 
required
text
string 
required
message
string 
required
state
string 
required
thumbnail
object 
required
height
integer 
required
media_type
string 
required
palette
object 
required
url
string 
required
width
integer 
required
video
object 
required
download_url
string 
required
url
string 
required
video_raw
object 
required
duration
number 
required
height
integer 
required
media_type
string 
required
url
string 
required
width
integer 
required
createdAt
string 
required
output
array[string]
required
status
string 
required
code
integer 
required
data
object 
required
task_id
string 
required
created_at
integer 
required
updated_at
integer 
required
task_result
object 
required
task_status
string 
required
task_status_msg
string 
required
request_id
string 
required
Example
{
    "artifact": {
        "created_at": "0001-01-01T00:00:00Z",
        "last_frame": {
            "height": 1024,
            "media_type": "image",
            "palette": null,
            "url": "https://storage.cdn-luma.com/dream-machine/e0884dcb-2d22-4db4-96f1-4257116fafba/33eff86e-9816-4bba-b2d8-554742a1f1eb/2025-05-23T07-05-23_cinematic_shot_of_a_last_frame.jpg",
            "width": 1024
        },
        "thumbnail": {
            "height": 1024,
            "media_type": "image",
            "palette": {
                "grid": "UUsrbVYyb1QuqIJTtYpWMzUZVksokm8+s4lVb1kuV0UfZU0jiGAyvI1bX0Qfo3tPlmtAhWg6gHBCeV4zPlIzJUsuN29OVZBonJVn"
            },
            "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/7abab0ae-accd-4df9-2303-1f1e300c2500/public",
            "width": 1024
        },
        "video_raw": {
            "duration": 5.208333,
            "height": 1080,
            "media_type": "video",
            "url": "https://storage.cdn-luma.com/dream-machine/971e7a04-6b13-4895-b575-bfd2fb1ee4e6/e5caf17f-8242-493e-833c-784d94cc04c2/2025-05-23T07-05-23_cinematic_shot_of_a.mp4",
            "width": 1080
        }
    },
    "assets": {
        "video": "https://storage.cdn-luma.com/dream-machine/971e7a04-6b13-4895-b575-bfd2fb1ee4e6/e5caf17f-8242-493e-833c-784d94cc04c2/2025-05-23T07-05-23_cinematic_shot_of_a.mp4"
    },
    "created_at": "2025-05-23T07:05:23.342Z",
    "id": "eec2fa50-22dd-4ce9-8f8b-f61e84567f85",
    "last_frame": {
        "height": 1024,
        "media_type": "image",
        "palette": null,
        "url": "https://storage.cdn-luma.com/dream-machine/e0884dcb-2d22-4db4-96f1-4257116fafba/33eff86e-9816-4bba-b2d8-554742a1f1eb/2025-05-23T07-05-23_cinematic_shot_of_a_last_frame.jpg",
        "width": 1024
    },
    "media_request": {
        "end": null,
        "loop": false,
        "prompt_type": "keyframe",
        "rich_text": null,
        "start": {
            "edit_version_id": null,
            "id": "a67ab26f-bb95-4c69-baca-f7d0d81b4da7",
            "media": {
                "height": 1024,
                "media_type": "image",
                "palette": null,
                "url": "https://storage.cdn-luma.com/photon/v2/uploads/bbecd329-5b62-4723-9e4c-658f041e97e7/a67ab26f-bb95-4c69-baca-f7d0d81b4da7.png",
                "width": 1024
            },
            "media_type": "image",
            "thumbnail": {
                "height": 1024,
                "media_type": "image",
                "palette": null,
                "url": "https://storage.cdn-luma.com/photon/v2/uploads/bbecd329-5b62-4723-9e4c-658f041e97e7/a67ab26f-bb95-4c69-baca-f7d0d81b4da7.png",
                "width": 1024
            },
            "transform": null,
            "type": "upload"
        },
        "text": "Cinematic shot of a tranquil indoor pool room. A graceful pink flamingo stands in clear turquoise water, creating subtle ripples. Golden hour light casts dramatic geometric shadows through expansive windows and a glass roof onto minimalist beige walls. Rattan furniture with cream cushions. Lush tropical plants. Serene, high-end resort aesthetic. The flamingo subtly preens."
    },
    "message": "YEScale - Luma Video Generation - Fetch",
    "state": "completed",
    "thumbnail": {
        "height": 1024,
        "media_type": "image",
        "palette": {
            "grid": "UUsrbVYyb1QuqIJTtYpWMzUZVksokm8+s4lVb1kuV0UfZU0jiGAyvI1bX0Qfo3tPlmtAhWg6gHBCeV4zPlIzJUsuN29OVZBonJVn"
        },
        "url": "https://imagedelivery.net/1KomXrSWiTojGGip43n0SQ/7abab0ae-accd-4df9-2303-1f1e300c2500/public",
        "width": 1024
    },
    "video": {
        "download_url": "https://storage.cdn-luma.com/dream-machine/971e7a04-6b13-4895-b575-bfd2fb1ee4e6/e5caf17f-8242-493e-833c-784d94cc04c2/2025-05-23T07-05-23_cinematic_shot_of_a.mp4",
        "url": "https://storage.cdn-luma.com/dream-machine/971e7a04-6b13-4895-b575-bfd2fb1ee4e6/e5caf17f-8242-493e-833c-784d94cc04c2/2025-05-23T07-05-23_cinematic_shot_of_a.mp4"
    },
    "video_raw": {
        "duration": 5.208333,
        "height": 1080,
        "media_type": "video",
        "url": "https://storage.cdn-luma.com/dream-machine/971e7a04-6b13-4895-b575-bfd2fb1ee4e6/e5caf17f-8242-493e-833c-784d94cc04c2/2025-05-23T07-05-23_cinematic_shot_of_a.mp4",
        "width": 1080
    }
}
Previous
Create Video by Luma
Next
Create Video by Pika
Built with