Vidu（Image to Video）

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	Function	Duration (s)	Resolution (p)	Style	Generation Time (s)	Price (ptc)
Vidu-1.5	Image to Video (img2video)	4	360	General	30	0.25
		4	720	General	90	0.625
		4	1080	General	320	1.25
		8	720	General	250	1.25
Vidu-1.0	Image to Video (img2video)	4	360	General	30	0.25
		8	360	General	60	0.5

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 and tasks:

For text2video, img2video, and character2video, the task option is: vidu-high-performance.

For upscale, the task option is: stable.

When the model version is set to 1.0, both vidu-high-performance and stable must be provided.
When the model version is set to 1.5, these parameters are optional.

These parameters do not affect the generation quality but must be passed 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

Whether to enable audit: default value is true

input

object

required

Task input, including 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": "img2video",
    "model_version": "1.5",
    "input": {
        "prompts": [
            {
                "type": "text",
                "content": "两个人拥抱"
            },
            {
                "type": "image",
                "content":"https://test-ss-images.s3.ap-southeast-1.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": "img2video",
    "model_version": "1.5",
    "input": {
        "prompts": [
            {
                "type": "text",
                "content": "两个人拥抱"
            },
            {
                "type": "image",
                "content":"https://test-ss-images.s3.ap-southeast-1.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-05-13 03:17:45

Vidu（Text-to-Video）

Vidu（Generate video from the first and last frames）