curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/start-end2video \
--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>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}建立首尾幀影片(Vidu)
此系列支援OpenAI影片生成格式（詳見連結 影片生成Sora相容格式）。
Vidu 官方影片生成介面，公開路徑遵循 Vidu 官方協議。
viduq3-turbo、viduq2、vidu2.0 依各自能力支援文字生成、圖片生成、首尾影格或參考生成影片，也可透過 /v1/videos Sora 相容格式接入。
Vidu Q4：vidu-q4 固定為 720p，vidu-q4-540p 固定為 540p，支援生成 3～16 秒影片。至少需要 1 張圖片，最多支援 15 張參考圖；參考生成可附帶最多 3 段 MP3 音訊，每段 3～12 秒、最大 50MB。不支援純文字生成、指定首尾影格或參考影片。多張圖片用於共同參考，不代表首尾位置。可透過 POST /v1/videos、POST /api/v3/contents/generations/tasks，或 Vidu 格式 POST /ent/v2/img2video、POST /ent/v2/reference2video 建立任務。建議統一入口使用 mode=reference_images；附帶音訊時使用 mode=reference_material。參考音訊可使用 audio_urls，Seedance 格式也可使用標準 content 的 audio_url 項；audio 布林欄位表示生成音訊開關，與參考音訊 URL 清單分別使用。解析度須與模型名稱一致。
補充 Vidu 官方影片生成格式的公開請求骨架、任務查詢結構和推薦驗證模板，公開路徑保持 Vidu 官方端點格式。
支援模型： viduq3-turbo, viduq2, vidu2.0
統一請求欄位：
model(string, 必填): Vidu 對外模型名稱。Vidu Q4 僅支援含圖片的圖片生成與參考生成影片；Q3/Q2/V2 沿用各自能力。prompt(string, 可選): 影片生成提示詞；文生影片必填，圖生/首尾幀/參考生影片按業務需要傳。images(array[string], 可選): 圖片輸入。單圖圖片生成 1 張；Vidu Q4 參考生成 1～15 張，且圖片用於共同參考。舊模型首尾影格與參考數量依各自能力使用。videos(array[string], 可選): 僅依舊模型能力提供影片主體輸入；Vidu Q4 不支援參考影片。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, 可選): 是否開啟音影片直出。audio_urls(array[string], 可選): Vidu Q4 參考音訊，最多 3 段 MP3，每段 3～12 秒、最大 50MB；與 audio 布林開關分開。off_peak(boolean, 可選): 是否使用錯峰生成。watermark(boolean, 可選): 是否新增浮水印。
常見模型／模式差異：
Vidu 文生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0；官方格式的文字生成影片。Vidu 图生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0；官方格式的單圖圖片生成影片。Vidu 首尾帧生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0；官方格式的首尾影格雙圖生成影片。Vidu 参考生视频: 支援模型 viduq3-turbo, viduq2, vidu2.0；官方格式的多參考圖片生成影片。
curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/start-end2video \
--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>",
"state": "created",
"model": "<string>",
"prompt": "<string>",
"images": [
"<string>"
],
"duration": 123,
"resolution": "<string>",
"created_at": "<string>",
"creations": "<string>"
}授權
使用 Bearer Token 認證。
格式: Authorization: Bearer sk-xxxxxx
主體
Vidu 對外模型名稱。Vidu Q4 僅支援附帶圖片的圖生與參考生影片；Q3/Q2/V2 沿用各自能力。
viduq3-turbo, viduq2, vidu2.0 "viduq3-turbo"
圖片輸入。單圖圖生 1 張；Vidu Q4 參考生成 1～15 張，且圖片用於共同參考。舊模型首尾幀與參考數量依各自能力使用。
2 elements["https://example.com/input.jpg"]
影片生成提示詞；文生影片必填，圖生／首尾幀／參考生影片依業務需要傳入。
"A cinematic product ad with smooth camera motion"
僅依舊模型能力提供影片主體輸入；Vidu Q4 不支援參考影片。
影片時長，單位為秒。viduq3-turbo 常用 5 秒，可依官方範圍設定。
5
輸出解析度，常見值 540p、720p、1080p。
540p, 720p, 1080p "720p"
輸出寬高比，文生/參考生影片常用，如 16:9、9:16、1:1。
16:9, 9:16, 4:3, 3:4, 1:1 "16:9"
隨機種子。
運動幅度，常見值 auto、small、medium、large。
auto, small, medium, large "auto"
是否開啟音視訊直出。
Vidu Q4 參考音訊，最多 3 段 MP3，每段 3～12 秒、最大 50MB；與 audio 布林開關分開。
3all, speech_only, sound_effect_only 是否使用錯峰生成。
是否加上浮水印。
1, 2, 3, 4