Skip to main content

​
Request Information

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

​
Request Headers

FieldValueDescription
Content-Typeapplication/jsonData exchange format
AuthorizationBearer {your api key}Replace {your api key} with your Bearer token

​
Request Body Parameters

Parameter NameTypeRequiredDescription
modelStringYesModel name
Available options:
- Sora 2: sora@2:normal
- Sora 2 Pro: sora@2:pro
- Veo 3.1: [email protected]:normal
- Veo 3.1 Fast: [email protected]: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: [email protected]:preview
taskUUIDStringOptionalTask ID. If not provided, a random UUID will be generated. Example: f5739925-fa8f-41c8-8f33-88aeba1ed365
promptStringYesText prompt, maximum 2000 characters
negative_promptStringOptionalNegative text prompt, maximum 2000 characters
image_urlStringOptionalFirst 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_urlStringOptionalLast 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_urlsArray[String]OptionalReference 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_audioBoolOptionalWhether to generate audio with the video. Default is false.
Values:
- false: Generate silent video
- true: Generate video with dialogue and background audio
durationIntOptionalVideo duration in seconds
seedIntOptionalRandom seed
If not provided or set to 0, a random number will be used
Manually set seeds will be used as-is
resolutionStringOptionalResolution parameter. Default value depends on the model and video duration
ratioStringOptionalVideo 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

FieldTypeDescription
codeStringStatus code. 200 for success. See error codes table for other values
dataObjectResponse data object
data.taskUUIDStringReturns the provided task ID if given, otherwise generates a random one
messageStringLog message

​
Response Example

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