curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq3-turbo",
  "prompt": "A cinematic product ad with smooth camera motion",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
'

{
  "task_id": "<string>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "created_at": "<string>",
  "creations": "<string>"
}

视频生成Vidu格式

创建文生视频(Vidu)

该系列支持OpenAI视频生成格式（详见链接视频生成Sora兼容格式）。

Vidu 官方视频生成接口，公开路径遵循 Vidu 官方协议。

当前公开模型：viduq3-turbo。支持文生视频、图生视频、首尾帧生视频、参考生视频。同一模型也支持通过 /v1/videos Sora 兼容格式接入，常用 mode 为 t2v、i2v、i2v_first_last、reference_images。

补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板，公开路径保持 Vidu 官方端点格式。

支持模型： viduq3-turbo

统一请求字段：

model (string, 必填): Vidu 对外模型名，当前公开 viduq3-turbo。
prompt (string, 可选): 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。
images (array[string], 可选): 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。
videos (array[string], 可选): 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。
subjects (array[object], 可选): 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。
duration (integer, 可选): 视频时长，单位秒。viduq3-turbo 常用 5 秒，可按官方范围设置。
resolution (string, 可选): 输出分辨率，常见值 540p、720p、1080p。
aspect_ratio (string, 可选): 输出宽高比，文生/参考生视频常用，如 16:9、9:16、1:1。
seed (integer, 可选): 随机种子。
movement_amplitude (string, 可选): 运动幅度，常见值 auto、small、medium、large。
audio (boolean, 可选): 是否开启音视频直出。
off_peak (boolean, 可选): 是否使用错峰生成。
watermark (boolean, 可选): 是否添加水印。

常见模型/模式差异：

Vidu 文生视频: 支持模型 viduq3-turbo；官方格式文生视频。
Vidu 图生视频: 支持模型 viduq3-turbo；官方格式单图图生视频。
Vidu 首尾帧生视频: 支持模型 viduq3-turbo；官方格式首尾帧双图生视频。
Vidu 参考生视频: 支持模型 viduq3-turbo；官方格式多参考图生视频。

POST

ent

text2video

curl --request POST \
  --url https://api.aiid.edu.kg/ent/v2/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq3-turbo",
  "prompt": "A cinematic product ad with smooth camera motion",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}
'

{
  "task_id": "<string>",
  "model": "<string>",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "duration": 123,
  "resolution": "<string>",
  "credits": 123,
  "created_at": "<string>",
  "creations": "<string>"
}

授权

Authorization

string

header

必填

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

请求体

application/json

model

enum<string>

必填

Vidu 对外模型名，当前公开 viduq3-turbo。

可用选项:

viduq3-turbo

示例:

"viduq3-turbo"

prompt

string

必填

视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。

示例:

"A cinematic product ad with smooth camera motion"

images

string<uri>[]

图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。

示例:

["https://example.com/input.jpg"]

videos

string<uri>[]

参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。

subjects

object[]

参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。

Hide child attributes

subjects.name

string

subjects.images

string<uri>[]

subjects.videos

string<uri>[]

subjects.voice_id

string

subjects.server_id

string

auto_subjects

boolean

duration

integer

视频时长，单位秒。viduq3-turbo 常用 5 秒，可按官方范围设置。

示例:

5

resolution

enum<string>

输出分辨率，常见值 540p、720p、1080p。

可用选项:

540p,

720p,

1080p

示例:

"720p"

aspect_ratio

enum<string>

输出宽高比，文生/参考生视频常用，如 16:9、9:16、1:1。

可用选项:

16:9,

9:16,

4:3,

3:4,

1:1

示例:

"16:9"

seed

integer

随机种子。

movement_amplitude

enum<string>

运动幅度，常见值 auto、small、medium、large。

可用选项:

auto,

small,

medium,

large

示例:

"auto"

audio

boolean

是否开启音视频直出。

audio_type

enum<string>

可用选项:

all,

speech_only,

sound_effect_only

voice_id

string

is_rec

boolean

bgm

boolean

payload

string

off_peak

boolean

是否使用错峰生成。

watermark

boolean

是否添加水印。

wm_position

enum<integer>

可用选项:

1,

2,

3,

4

wm_url

string<uri>

callback_url

string<uri>

响应

200 - application/json

任务创建成功

task_id

string

必填

创建任务返回的任务 ID，用于查询任务。

state

enum<string>

必填

任务状态，常见值 created、queueing、processing、success、failed。

可用选项:

created,

queueing,

processing,

success,

failed

model

string

prompt

string

images

string[]

duration

integer

resolution

string

credits

integer

本次任务消耗的积分。

created_at

string

creations

string

查询任务(Vidu)按 ID 查询音乐任务