提交生成视频任务

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

or

Body 参数application/json

user_prompt

string

必需

核心的提示词，描述您想要生成的视频内容。

expand_prompt

boolean

可选

是否开启 Luma 的 prompt 自动优化和扩展功能。

默认值:

true

loop

boolean

可选

是否生成一个循环视频，使得视频首尾可以无缝衔接。

默认值:

false

image_url

string <uri>

可选

作为参考的初始图像。支持公网可访问的图片 URL 或 Base64 编码的图片数据。

image_end_url

string <uri>

可选

作为参考的关键结束帧图像。支持公网可访问的图片 URL 或 Base64 编码的图片数据。

notify_hook

string <uri>

可选

任务完成或失败时的回调地址。系统会向此 URL 发送 POST 请求通知结果。例如：https://your-service.com/webhook

resolution

enum<string>

可选

视频分辨率，默认为 720p。

枚举值:

720p1080p

默认值:

720p

duration

enum<string>

可选

视频时长，默认为 5s。

枚举值:

5s10s

默认值:

5s

model_name

string

可选

指定使用的模型版本。例如 ray-v1, ray-v2 等。

示例

{
    "user_prompt": "string",
    "expand_prompt": true,
    "loop": false,
    "image_url": "http://example.com",
    "image_end_url": "http://example.com",
    "notify_hook": "http://example.com",
    "resolution": "720p",
    "duration": "5s",
    "model_name": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://draw.openai-next.com/luma/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_prompt": "string",
    "expand_prompt": true,
    "loop": false,
    "image_url": "http://example.com",
    "image_end_url": "http://example.com",
    "notify_hook": "http://example.com",
    "resolution": "720p",
    "duration": "5s",
    "model_name": "string"
}'

返回响应

🟢200成功

application/json

任务提交成功，返回任务的初始状态信息。

Body

id

string

可选

任务的唯一标识符 (Task ID)。

prompt

string

可选

最终用于生成的提示词。

state

string

可选

任务的初始状态，通常为 "pending"。

created_at

string <date-time>

任务创建时间。

可选

video

object | null

可选

视频对象，在任务初始阶段为空。

liked

boolean | null

可选

是否已点赞，初始为 null。

estimate_wait_seconds

number | null

可选

预估的等待时间（秒），可能为空。

示例

{
    "id": "9d4b7516-77e5-481a-b015-48313946f33b",
    "prompt": "cat dance",
    "state": "pending",
    "created_at": "2024-07-01T07:35:13.498660Z",
    "video": null,
    "liked": null,
    "estimate_wait_seconds": null
}