curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/img2video \
--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, vidu-q4, vidu-q4-540p
統一請求欄位:
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;官方格式的多參考圖片生成影片。Vidu Q4 720p 单图: 支援模型 vidu-q4;單圖或兩圖兩段 MP3 參考範例;多圖用於共同參考,不指定首尾幀。呼叫前替換範例素材 URL。Vidu Q4 540p 单图: 支援模型 vidu-q4-540p;單圖或兩圖兩段 MP3 參考範例;多圖用於共同參考,不指定首尾幀。呼叫前替換範例素材 URL。
curl --request POST \
--url https://api.aiid.edu.kg/ent/v2/img2video \
--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, vidu-q4, vidu-q4-540p "viduq3-turbo"
圖片輸入。單圖圖生 1 張;Vidu Q4 參考生成 1~15 張,且圖片用於共同參考。舊模型首尾幀與參考數量依各自能力使用。
1 element["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 