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 Available options: - Sora 2: sora@2:normal- Sora 2 Pro: sora@2:pro- Veo 3.1: veo@3.1:normal- Veo 3.1 Fast: veo@3.1:fast- Veo 3: veo@3:normal- Seedance 1.0 Pro: seedance@1:pro- Seedance 1.0 Pro Fast: seedance@1:pro_fast- Vidu Q2 Turbo: vidu@q2:turbo- Vidu Q2 Pro: vidu@q2:pro- 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 The model will use the image provided in this parameter as the first frame to generate the video. Image URL (ensure it’s accessible) |
| last_image_url | String | Optional | Last frame image The model will use the image provided in this parameter as the last frame to generate the video. Image URL (ensure it’s accessible) |
| ref_image_urls | Array[String] | Optional | Reference images The model will use the images provided in this parameter as reference frames to generate the video. Image URLs (ensure they’re accessible) |
| generate_audio | Bool | Optional | Whether to generate audio with the video. Default is false. Values: - false: Generate silent video - true: Generate video with dialogue and background audio |
| duration | Int | Optional | Video duration in seconds |
| seed | Int | Optional | Random seed If not provided or set to 0, a random number will be used 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
{
"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
{
"code": "200",
"message": "success",
"data": {
"taskUUID": "2317d79f-3ccb-4bec-a072-b6c1817e3f42"
}
}