Create Video Generation Task

POST

/v1/videos

Create a video generation task, supporting text-to-video and image-to-video. After submission, a task ID is returned. Use the query API to poll the task status and retrieve the generated video.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Body Params application/jsonRequired

Examples

Text-to-Video ExampleImage-to-Video Example

{
    "model": "sora-2",
    "prompt": "A cute orange cat chasing butterflies in a sunny garden, photographic style, high definition",
    "seconds": "4",
    "size": "1280x720"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Text-to-Video ExampleImage-to-Video Example

curl --location 'https://api-xmodel.nexconn.ai/v1/videos' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "sora-2",
    "prompt": "A cute orange cat chasing butterflies in a sunny garden, photographic style, high definition",
    "seconds": "4",
    "size": "1280x720"
}'

Responses

🟢200Success

application/json

Video task created successfully

Bodyapplication/json

Example

{
    "id": "qvideo-user123-1766453713089395279",
    "object": "video",
    "model": "sora-2",
    "status": "queued",
    "created_at": 1766453713,
    "updated_at": 1766453713,
    "seconds": "4",
    "size": "1280x720"
}

🟠400Invalid request

🟠401Unauthorized

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

Query Video Generation Task

Query Video Generation Status