API reference

Generate

POST

/dream-machine/v1/generations

最后修改时间：2025-02-05 11:29:37

请求参数

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

长宽比

可选

默认值:

16:9

loop

boolean

是否循环播放视频

可选

keyframes

object

关键帧

可选

frame0

object

首帧

可选

frame1

object

尾帧

可选

callback_url

string

可选

示例

{
  "prompt": "A tiger walking in snow",
  "keyframes": {
    "frame0": {
      "type": "image",
      "url": "https://storage.cdn-luma.com/dream_machine/7e4fe07f-1dfd-4921-bc97-4bcf5adea39a/video_0_thumb.jpg"
    }
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/dream-machine/v1/generations' \
--header 'Authorization: ' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
  "prompt": "A tiger walking in snow",
  "keyframes": {
    "frame0": {
      "type": "image",
      "url": "https://storage.cdn-luma.com/dream_machine/7e4fe07f-1dfd-4921-bc97-4bcf5adea39a/video_0_thumb.jpg"
    }
  }
}'

返回响应

🟢201成功

application/json

Body

string

必需

state

string

必需

failure_reason

null

必需

created_at

string

必需

assets

null

必需

version

null

必需

request

object

必需

prompt

string

必需

aspect_ratio

string

必需

loop

boolean

必需

keyframes

null

必需

callback_url

string

必需

示例

{
    "id": "7ca76429-99d1-46ab-bb2e-84baa4acdb04",
    "state": "queued",
    "failure_reason": null,
    "created_at": "2024-11-27T13:50:56.313494Z",
    "assets": null,
    "version": null,
    "request": {
        "prompt": "A serene lake surrounded by mountains at sunset",
        "aspect_ratio": "16:9",
        "loop": true,
        "keyframes": null,
        "callback_url": "xxx"
    }
}

Describe

Fetch task