# 提交生成视频任务

**方法**: `POST`
**路径**: `/luma/generations`

是否开启prompt 优化

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
user_prompt
string
提示词
必需
expand_prompt
boolean
可选
是否开启prompt 优化
loop
boolean
是否循环 首尾呼应
可选
image_url
string
可选
参考图，支持第三方图片地址、Base64
image_end_url
string
可选
关键帧，支持第三方图片地址、Base64
notify_hook
string
可选
回调地址：
https://xxxxxxx
resolution
string
可选
720p或者1080p默认720p
duration
string
可选
时长 5s 或者 10s
model_name
enum<string>
可选
枚举值:
ray-v1
官方的 ray1.6
ray-v2
官方的 ray2
ray-v3
官方的 ray3
示例
{
"user_prompt"
:
"string"
,
"expand_prompt"
:
true
,
"loop"
:
true
,
"image_url"
:
"string"
,
"image_end_url"
:
"string"
,
"notify_hook"
:
"string"
,
"resolution"
:
"string"
,
"duration"
:
"string"
,
"model_name"
:
"ray-v1"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/luma/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user_prompt": "string",
    "expand_prompt": true,
    "loop": true,
    "image_url": "string",
    "image_end_url": "string",
    "notify_hook": "string",
    "resolution": "string",
    "duration": "string",
    "model_name": "ray-v1"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

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