# Grok创建视频

**方法**: `POST`
**路径**: `/v2/videos/generations`

此模型不直接对外开放，请联系管理员了解详情

## 请求参数

### Header 参数

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

### Body 参数 application/json

```text
prompt
string
必需
model
string
必需
grok-video-3
ratio
enum<string>
可选
枚举值:
2:3
3:2
1:1
resolution
enum<string>
可选
枚举值:
720P
1080P
duration
enum<integer>
可选
枚举值:
5
10
15
images
array
[string]
支持一张参考图
可选
示例
{
"prompt"
:
"dance"
,
"model"
:
"grok-video-3"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "dance",
    "model": "grok-video-3"
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
task_id
string
必需
```

#### 示例

```json
{
    "task_id": "grok:fa59842d-0252-455d-93ee-8f4b72bec9b1"
}
```