Create Video Generation Task

POST

/v3/contents/generations/tasks

Item	Description
Name	Create video generation task
Description	Asynchronously create task; returns task `id` upon success, requires polling with 'Query video generation task' interface or waiting for callback to get results.
Task type	Text-to-video; Image-to-video first frame; Image-to-video first and last frame; Multimodal reference to video

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Text-to-VideoImage-to-video - First frameImage-to-video - First and last frameMultimodal reference to video

{
    "model": "bytedance/doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "City street at sunset, cinematic shot slowly pushing forward"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Text-to-VideoImage-to-video - First frameImage-to-video - First and last frameMultimodal reference to video

curl --location 'https://api-xmodel.nexconn.ai/v3/contents/generations/tasks' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "bytedance/doubao-seedance-2-0-260128",
    "content": [
        {
            "type": "text",
            "text": "City street at sunset, cinematic shot slowly pushing forward"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
}'

Responses

🟢200

application/json

Created successfully, task ID returned.

Bodyapplication/json

Example

{
    "id": "qvideo-xxxxxxxxxxxxxxxx"
}

🟠400

🟠401

🟠429

Modified at 2026-04-24 10:39:56

Query Video Generation Status

Query Video Generation Task