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)建立影片(HappyHorse)