Vidu（Text-to-Video） - 302.AI API Document

A rising video generation company from China, whose latest 1.5 model features an exclusive subject generation capability.
Relevant link：https://www.vidu.studio/

Model Version	Function	Duration (seconds)	Resolution	Style	Generation Time (seconds)	Unit Price (ptc)
Vidu-1.5	Text-to-Video (text2video)	4	360p	General	30	0.25
		4	360p	Anime	30	0.25
		4	720p	General	90	0.625
		4	720p	Anime	90	0.625
		4	1080p	General	320	1.25
		4	1080p	Anime	320	1.25
		8	720p	General	250	1.25
		8	720p	Anime	250	1.25
Vidu-1.0	Text-to-Video (text2video)	4	360p	General	30	0.25
		4	360p	Anime	30	0.5
		8	360p	General	60	0.5
		8	360p	Anime	60	1.0

For specific video templates, please visit the Vidu website:https://platform.vidu.com/templates

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": "text2video",
    "style": "general",
    "model_version": "1.5",
    "input": {
        "seed": 123,
        "enhance": true,
        "prompts": [
            {
                "type": "text",
                "content": "猪在飞"
            }
        ]
    },
    "output_params": {
        "sample_count": 1,
        "resolution": "512",
        "aspect_ratio": "16:9",
        "movement_amplitude": "auto",
        "duration": 4
    },
    "moderation": false
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

string

required

type

string

required

state

string

required

model

string

required

style

string

required

moderation

boolean

required

input

object

required

creation_id

string

required

prompts

array [object {3}]

required

seed

integer

required

enhance

boolean

required

multi_image_boost

boolean

required

output_params

object

required

sample_count

integer

required

duration

integer

required

aspect_ratio

string

required

resolution

string

required

movement_amplitude

string

required

err_code

string

required

creations_count

integer

required

model_version

string

required

created_at

string

required

Example

{
    "id": "string",
    "type": "string",
    "state": "string",
    "model": "string",
    "style": "string",
    "moderation": true,
    "input": {
        "creation_id": "string",
        "prompts": [
            {
                "type": "string",
                "content": "string",
                "negative": true
            }
        ],
        "seed": 0,
        "enhance": true,
        "multi_image_boost": true
    },
    "output_params": {
        "sample_count": 0,
        "duration": 0,
        "aspect_ratio": "string",
        "resolution": "string",
        "movement_amplitude": "string"
    },
    "err_code": "string",
    "creations_count": 0,
    "model_version": "string",
    "created_at": "string"
}