Skip to main content
POST
/
open
/
tasks
Submit Generation Task
curl --request POST \
  --url https://api.example.com/open/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "modelId": 4,
  "taskName": "Video Retry Test",
  "genMethod": "img_txt",
  "prompt": "a cute orange cat sitting on a windowsill, warm sunlight",
  "refImageUrls": [
    "https://picsum.photos/1024/576"
  ],
  "resolution": "720p",
  "durationSeconds": 5
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "taskId": 123,
    "taskNo": "<string>",
    "estimatedCredits": 123
  }
}

Headers

​
X-Idempotency-Key
string

Idempotency Key

​
Authorization
string

Authentication Token

Body

application/json
​
modelId
integer<int64>
required

Model ID

​
taskName
string
required

Task Name

​
genMethod
string
required

Generation Method (e.g. img_txt, txt)

​
prompt
string
required

Positive Prompt

​
negativePrompt
string

Negative Prompt (optional)

​
resolution
string

Resolution (for video tasks, e.g. 720p)

​
durationSeconds
integer

Video Duration (seconds, valid for video tasks)

​
aspectRatio
string

Aspect Ratio (optional, e.g. 16:9)

​
imageCount
integer

Number of Images to Generate (valid for image tasks)

​
size
string

Image Size (for image tasks, optional, e.g. 1024x1024)

​
quality
integer

Generation Quality (50~100, optional)

​
seed
integer<int64>

Random Seed (-1 = not specified)

​
refImageUrls
string[]

Reference Image URL List (string array, required when generation method includes img)

​
refVideoUrls
string[]

Reference Video URL List (string array, optional)

​
refAudioUrls
string[]

Reference Audio URL List (optional, for video tasks)

​
generateAudio
boolean

Whether to Auto-generate Audio (default true if null, valid for video tasks)

Response

200 - application/json

OK

​
code
integer

Response Code: 0 = Success, non-zero = Failure

​
msg
string

Response Message

​
data
object

Response Data