Create Video Generation Task

POST

/302/v2/video/create

Model list and model-supported feature documentation:
https://kdocs.cn/l/csVggsGSdgkp

Model names are compatible with both hyphens and underscores, and are case-insensitive. The old model naming style is also supported. By adding -t2v, -i2v, -v2v to the model name, using previous model names will still not cause errors. The interface will determine whether to generate video from images based on the presence of image/end_image fields in the parameters, and from videos based on the presence of the video field.

Webhook is supported, and results will be sent when video generation succeeds or fails.

If an error occurs due to Apikey unavailability during automatic polling of tasks in the backend, the webhook will send a failed status result. However, after restoring Apikey availability, you can manually call the task query interface to continue retrieving results.

Request Content-Type supports both JSON and multipart/form-data.

Images support base64 images, publicly accessible image URLs, and file stream images.

Due to parameter size limitations, videos are only supported as URL parameters.

Request

Query Params

Header Params

Body Params application/json

Example

{
    "model": "string",
    "prompt": "string",
    "image": "string",
    "end_image": "string",
    "video": "string",
    "negative_prompt": "string",
    "duration": 0,
    "resolution": "string",
    "aspect_ratio": "string",
    "fps": "string",
    "其他模型额外支持的字段具体见文档说明 ": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/302/v2/video/create?webhook' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "prompt": "string",
    "image": "string",
    "end_image": "string",
    "video": "string",
    "negative_prompt": "string",
    "duration": 0,
    "resolution": "string",
    "aspect_ratio": "string",
    "fps": "string",
    "其他模型额外支持的字段具体见文档说明 ": "string"
}'

Responses

🟢200成功

application/json

Body

Example

{
    "task_id": "301504317665393",
    "status": "pending",
    "created_at": "2025-08-14T09:34:45.529818Z"
}

Modified at 2025-09-01 07:00:21

Get Video Task Info