> ## 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.

# Create Task Interface

### Request Information

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

### Request Headers

| Field         | Value                   | Description                                     |
| ------------- | ----------------------- | ----------------------------------------------- |
| Content-Type  | application/json        | Data exchange format                            |
| Authorization | Bearer `{your api key}` | Replace `{your api key}` with your Bearer token |

### Request Body Parameters

| Parameter Name   | Type           | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------- | -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| model            | String         | Yes      | Model name<br />Available options:<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         | Optional | Task ID. If not provided, a random UUID will be generated. Example: f5739925-fa8f-41c8-8f33-88aeba1ed365                                                                                                                                                                                                                                                                                                                                                    |
| prompt           | String         | Yes      | Text prompt, maximum 2000 characters                                                                                                                                                                                                                                                                                                                                                                                                                        |
| negative\_prompt | String         | Optional | Negative text prompt, maximum 2000 characters                                                                                                                                                                                                                                                                                                                                                                                                               |
| image\_url       | String         | Optional | First frame image<br />The model will use the image provided in this parameter as the first frame to generate the video.<br />Image URL (ensure it's accessible)                                                                                                                                                                                                                                                                                            |
| last\_image\_url | String         | Optional | Last frame image<br />The model will use the image provided in this parameter as the last frame to generate the video.<br />Image URL (ensure it's accessible)                                                                                                                                                                                                                                                                                              |
| ref\_image\_urls | Array\[String] | Optional | Reference images<br />The model will use the images provided in this parameter as reference frames to generate the video.<br />Image URLs (ensure they're accessible)                                                                                                                                                                                                                                                                                       |
| generate\_audio  | Bool           | Optional | Whether to generate audio with the video. Default is false.<br />Values:<br />- false: Generate silent video<br />- true: Generate video with dialogue and background audio                                                                                                                                                                                                                                                                                 |
| duration         | Int            | Optional | Video duration in seconds                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| seed             | Int            | Optional | Random seed<br />If not provided or set to 0, a random number will be used<br />Manually set seeds will be used as-is                                                                                                                                                                                                                                                                                                                                       |
| resolution       | String         | Optional | Resolution parameter. Default value depends on the model and video duration                                                                                                                                                                                                                                                                                                                                                                                 |
| ratio            | String         | Optional | Video aspect ratio                                                                                                                                                                                                                                                                                                                                                                                                                                          |

### Request Example

```json theme={null}
{
  "model": "sora@2:normal",
  "taskUUID": "f5739925-fa8f-41c8-8f33-88aeba1ed365",
  "prompt": "A beautiful sunset over the ocean with waves crashing on the shore",
  "negative_prompt": "blurry, low quality, distorted",
  "image_url": "https://example.com/first-frame.jpg",
  "generate_audio": true,
  "duration": 10,
  "seed": 12345,
  "resolution": "720p",
  "ratio": "16:9"
}
```

### Response Body

| Field         | Type   | Description                                                             |
| ------------- | ------ | ----------------------------------------------------------------------- |
| code          | String | Status code. 200 for success. See error codes table for other values    |
| data          | Object | Response data object                                                    |
| data.taskUUID | String | Returns the provided task ID if given, otherwise generates a random one |
| message       | String | Log message                                                             |

### Response Example

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