> ## Documentation Index
> Fetch the complete documentation index at: https://doc.superaiglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建任务接口

### 请求信息

* **方法**: POST
* **URL**: `https://api.superaiglobal.com/v1/video/createTask`

### 请求头

| 字段            | 值                  | 描述                            |
| ------------- | ------------------ | ----------------------------- |
| Content-Type  | application/json   | 数据交换格式                        |
| Authorization | Bearer `{您的api密钥}` | 将 `{您的api密钥}` 替换为您的 Bearer 令牌 |

### 请求体参数

| 参数名称             | 类型             | 必填 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------- | -------------- | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| model            | String         | 是  | 模型名称<br />可用选项：<br />- **Sora 2**: `sora@2:normal`<br />- **Sora 2 Pro**: `sora@2:pro`<br />- **Veo 3.1**: `veo@3.1:normal`<br />- **Veo 3.1 Fast**: `veo@3.1:fast`<br />- **Veo 3**: `veo@3:normal`<br />- **Seedance 1.0 Pro**: `seedance@1:pro`<br />- **Seedance 1.0 Pro Fast**: `seedance@1:pro_fast`<br />- **Vidu Q2 Turbo**: `vidu@q2:turbo`<br />- **Vidu Q2 Pro**: `vidu@q2:pro`<br />- **Wan 2.5 Preview**: `wan@2.5:preview` |
| taskUUID         | String         | 可选 | 任务ID。如果未提供，将生成随机UUID。示例：f5739925-fa8f-41c8-8f33-88aeba1ed365                                                                                                                                                                                                                                                                                                                                                                             |
| prompt           | String         | 是  | 文本提示词，最多2000个字符                                                                                                                                                                                                                                                                                                                                                                                                                          |
| negative\_prompt | String         | 可选 | 负面文本提示词，最多2000个字符                                                                                                                                                                                                                                                                                                                                                                                                                        |
| image\_url       | String         | 可选 | 首帧图像<br />模型将使用此参数中提供的图像作为首帧来生成视频。<br />图像URL（确保可访问）                                                                                                                                                                                                                                                                                                                                                                                     |
| last\_image\_url | String         | 可选 | 尾帧图像<br />模型将使用此参数中提供的图像作为尾帧来生成视频。<br />图像URL（确保可访问）                                                                                                                                                                                                                                                                                                                                                                                     |
| ref\_image\_urls | Array\[String] | 可选 | 参考图像<br />模型将使用此参数中提供的图像作为参考帧来生成视频。<br />图像URL（确保可访问）                                                                                                                                                                                                                                                                                                                                                                                    |
| generate\_audio  | Bool           | 可选 | 是否生成带音频的视频。默认为false。<br />值：<br />- false: 生成静音视频<br />- true: 生成带对话和背景音频的视频                                                                                                                                                                                                                                                                                                                                                             |
| duration         | Int            | 可选 | 视频时长（秒）                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| seed             | Int            | 可选 | 随机种子<br />如果未提供或设置为0，将使用随机数<br />手动设置的种子将按原样使用                                                                                                                                                                                                                                                                                                                                                                                           |
| resolution       | String         | 可选 | 分辨率参数。默认值取决于模型和视频时长                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ratio            | String         | 可选 | 视频宽高比                                                                                                                                                                                                                                                                                                                                                                                                                                    |

### 请求示例

```json theme={null}
{
  "model": "sora@2:normal",
  "taskUUID": "f5739925-fa8f-41c8-8f33-88aeba1ed365",
  "prompt": "美丽的海上日落，海浪拍打着海岸",
  "negative_prompt": "模糊，低质量，扭曲",
  "image_url": "https://example.com/first-frame.jpg",
  "generate_audio": true,
  "duration": 10,
  "seed": 12345,
  "resolution": "720p",
  "ratio": "16:9"
}
```

### 响应体

| 字段            | 类型     | 描述                      |
| ------------- | ------ | ----------------------- |
| code          | String | 状态码。200表示成功。其他值请参见错误代码表 |
| data          | Object | 响应数据对象                  |
| data.taskUUID | String | 如果提供了任务ID则返回，否则生成随机ID   |
| message       | String | 日志消息                    |

### 响应示例

```json theme={null}
{
    "code": "200",
    "message": "success",
    "data": {
        "taskUUID": "2317d79f-3ccb-4bec-a072-b6c1817e3f42"
    }
}
```