文生视频 - API reference

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

string

optional

Header Params

Content-Type

string

optional

Example:

application/json; charset=utf-8

string

optional

Authorization

string

optional

Default:

Body Params application/json

user_prompt

string

deprecated

prompt

string

required

aspect_ratio

string

required

expand_prompt

boolean

optional

是否开启prompt 优化

loop

boolean

required

循环一张参考图

image_url

string

deprecated

关键首帧，参考图，支持第三方图片地址、Base64

image_end_url

string

deprecated

关键尾帧，参考图，支持第三方图片地址、Base64

keyframes

object

optional

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

frame0

object

首帧

optional

frame1

object

尾帧

optional

notify_hook

string

optional

回调地址： https://xxxxxxx

task_id

string

required

生成音频的

Example

{
  "prompt": "cat dance",
  "aspect_ratio": "16:9"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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"
}'

Responses

🟢201成功

application/json

Body

created_at

string

required

estimate_wait_seconds

null

required

id

string

required

last_frame

null

required

liked

null

required

prompt

string

required

state

string

required

Examples:

completedpending

thumbnail

null

required

video

null

required

server_id

string

optional

Example

{
  "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
}