Vidu（Generate video from the first and last frames）

Deprecated

POST

/vidu/ent/v1/tasks

A new emerging video generation company in China has introduced its latest 1.5 model, featuring an exclusive subject generation capability
Related Link：https://www.vidu.studio/

Model Version	Feature	Duration (seconds)	Resolution	Style	Generation Time (seconds)	Unit Price (ptc)
Vidu-1.5	Head-to-tail frame video generation (headtailimg)	4	360	General	30	0.25
		4	720	General	90	0.625
		4	1080	General	320	1.25
		8	720	General	250	1.25

Price: Please calculate based on credits, 1 credit = 0.05 PTC
Official website pricing link: https://platform.vidu.cn/pricing

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params application/json

type

enum<string>

required

Allowed values:

text2videoimg2videocharacter2videoheadtailimgupscale

model

string

optional

Model types: text2video, img2video, and character2video.

Available values for tasks:

vidu-high-performance (for the above tasks)

stable (for the upscale task).

When the model version is set to 1.0, both vidu-high-performance and stable must be provided. When the version is set to 1.5, these parameters are optional. These two parameters do not affect the generation quality and only need to be transmitted as required.

model_version

enum<string>

required

Allowed values:

1.01.5

style

enum<string>

optional

Style: Required only for the text2video task.
Options: general,anime

Allowed values:

generalanime

moderation

boolean

optional

Audit toggle: Specifies whether to enable content review.
Default value: true

input

object

required

The task input includes the following fields

seed

integer

optional

Random seed, if not provided or if 0 is passed, a random number will be used instead

enhance

boolean

optional

Whether to use the prompt enhancement feature, default value is true

creation_id

string

optional

Generation ID, required only for the upscale task

prompts

array [object {2}]

optional

output_params

object

optional

sample_count

integer

required

Number of videos to generate, currently only supports 1

duration

integer

required

Video duration, supports 4 or 8

resolution

enum<string>

required

Resolution, only supported by model 1.5. Option: 512. This means the base resolution is 512x512

Allowed values:

5127201080

movement_amplitude

enum<string>

optional

Motion range, only supported by model 1.5. Options: auto, small, medium, large. If auto is selected, the model will automatically choose the most suitable motion range based on the input

Allowed values:

autosmallmediumlarge

aspect_ratio

string

required

Video aspect ratio, only supported by model 1.5. Options: default, 16:9, 9:16, 1:1

Example

{
    "type": "headtailimg2video",
    "model_version": "1.5",
    "input": {
        "prompts": [
            {
                "type": "text",
                "content": "两个人拥抱"
            },
            { // first image
                "type": "image",
                "content": "https://test-ss-images.s3.ap-southeast1.amazonaws.com/tmp/prompt-300k.jpeg"
            },
            { // last image
                "type": "image",
                "content": "https://test-ss-images.s3.ap-southeast1.amazonaws.com/tmp/prompt-300k.jpeg"
            }
        ]
    },
    "output_params": {
        "sample_count": 1,
        "resolution": "512",
        "movement_amplitude": "auto",
        "duration": 4
    },
    "moderation": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/vidu/ent/v1/tasks' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "headtailimg2video",
    "model_version": "1.5",
    "input": {
        "prompts": [
            {
                "type": "text",
                "content": "两个人拥抱"
            },
            { // first image
                "type": "image",
                "content": "https://test-ss-images.s3.ap-southeast1.amazonaws.com/tmp/prompt-300k.jpeg"
            },
            { // last image
                "type": "image",
                "content": "https://test-ss-images.s3.ap-southeast1.amazonaws.com/tmp/prompt-300k.jpeg"
            }
        ]
    },
    "output_params": {
        "sample_count": 1,
        "resolution": "512",
        "movement_amplitude": "auto",
        "duration": 4
    },
    "moderation": false
}'

Responses

🟢200Success

application/json

Body

object {0}

Example

{}

Modified at 2025-07-10 03:28:12

Vidu（Image to Video）

Vidu（Reference-based video generation）