API reference

图生视频

POST

/luma/generations

最后修改时间：2025-05-19 07:15:59

keyframes参数可指定视频的首尾帧，首尾帧可使用图片、视频

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Content-Type

string

可选

示例值:

application/json; charset=utf-8

Authorization

string

可选

默认值:

Body 参数application/json

prompt

string

必需

aspect_ratio

string

必需

expand_prompt

boolean

可选

是否开启prompt 优化

loop

boolean

循环一张参考图

可选

keyframes

object

可选

关键帧，和上面的方案二选一

frame0

object

首帧

可选

frame1

object

尾帧

可选

notify_hook

string

可选

回调地址： https://xxxxxxx

task_id

string

生成音频时需要提交

必需

示例

{
    "prompt": "cat dance",
    "aspect_ratio": "16:9",
    "keyframes": {
        "frame0": {
            "type": "image",
            "url": "https://www.shutterstock.com/image-photo/beautifull-red-black-bengal-tiger-260nw-2526207017.jpg"
        }
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/luma/generations' \
--header 'Authorization: ' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "prompt": "cat dance",
    "aspect_ratio": "16:9",
    "keyframes": {
        "frame0": {
            "type": "image",
            "url": "https://www.shutterstock.com/image-photo/beautifull-red-black-bengal-tiger-260nw-2526207017.jpg"
        }
    }
}'

返回响应

🟢201成功

application/json

Body

created_at

string

必需

estimate_wait_seconds

null

必需

string

必需

last_frame

null

必需

liked

null

必需

prompt

string

必需

state

string

必需

示例值:

completedpending

thumbnail

null

必需

video

null

必需

server_id

string

可选

示例

{"created_at":"2024-07-22T12:47:28.553735Z","estimate_wait_seconds":null,"id":"fc7fb008-7a5e-40ad-a7ff-dbb63db61be8","last_frame":null,"liked":null,"prompt":"cat dance","state":"pending","thumbnail":null,"video":null}

文生视频

扩展视频