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

Create Video by Luma

POST
/luma/generations
Create Video by Luma

Request

Body Params application/json
user_prompt
string 
required
Prompt word
expand_prompt
boolean 
optional
Whether to enable prompt optimization
loop
boolean 
optional
Whether to loop from beginning to end
image_url
string 
optional
Reference image, supports third-party image address, Base64
image_end_url
boolean 
optional
Keyframes, support for third-party image addresses, Base64
Default:
false
aspect_ratio
string 
optional
Enumeration value :
1:1
4:3
3:4
16:9
9:16
Example
{
    "user_prompt": "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.",
    "expand_prompt": true,
    "image_url": "https://img.upanh.tv/2025/05/23/b69ee84d-849d-48c0-863a-40b646190dd6.png"
}

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 POST '/luma/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_prompt": "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.",
    "expand_prompt": true,
    "image_url": "https://img.upanh.tv/2025/05/23/b69ee84d-849d-48c0-863a-40b646190dd6.png"
}'

Responses

🟢200OK
application/json
Body
batch_id
string 
required
created_at
string 
required
estimate_wait_seconds
null 
required
id
string 
required
last_frame
null 
required
liked
null 
required
message
string 
required
prompt
string 
required
queue_state
null 
required
state
string 
required
thumbnail
null 
required
video
null 
required
video_raw
null 
required
code
integer 
required
request_id
string 
required
data
object 
required
task_id
string 
required
task_status
string 
required
created_at
integer 
required
updated_at
integer 
required
Example
{
    "batch_id": "",
    "created_at": "2025-05-23T07:05:23.342674Z",
    "estimate_wait_seconds": null,
    "id": "eec2fa50-22dd-4ce9-8f8b-f61e84567f85",
    "last_frame": null,
    "liked": null,
    "message": "YEScale - Luma Video Generation - Submit",
    "prompt": "",
    "queue_state": null,
    "state": "pending",
    "thumbnail": null,
    "video": null,
    "video_raw": null
}
Previous
Get Video by Task ID
Next
Get Video by Task ID
Built with