⚠️紧急通知：由于火山官方近期在严格自查客户违规转售 API 的行为，当前海外渠道收到官方预警。即日起，先暂停海外seedance API 接口服务，恢复时间另行通知，非常抱歉给您带来不便，感谢理解与支持🙏
- 模型列表
- 视频生成大模型 API 对接鉴权指南
- 快速上手与调用示例
- API详细接口
参考生视频（主体调用）
POST
https://vg-api.aig-ai.com/v1/{model_id}/reference2video
参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；
参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词。
注：viduq3-mix 暂不支持主体调用方法
请求参数
Path 参数
Header 参数
Body 参数application/json必填
示例
{
"model": "viduq3",
"subjects": [
{
"name": "subject_1",
"images": [
"https://example.com/image1.jpg",
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
],
"videos": [
"data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQ..."
]
}
],
"voice_id": "your_voice_id",
"prompt": "@subject_1 在公园散步，画面明亮自然",
"audio": false,
"audio_type": "all",
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"movement_amplitude": "auto",
"payload": "custom_transmission_data",
"off_peak": false,
"watermark": false,
"wm_position": 3,
"wm_url": "https://example.com/watermark.png",
"meta_data": "{\"Label\":\"test\",\"ContentProducer\":\"user\",\"ProduceID\":\"task_001\"}",
"callback_url": "https://your-server.com/callback"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://vg-api.aig-ai.com/v1//reference2video' \
--header 'Authorization: Bearer sk-abcdefghijklmnopqrstuvwxyz1234567890' \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "viduq3",
"subjects": [
{
"name": "subject_1",
"images": [
"https://example.com/image1.jpg",
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
],
"videos": [
"data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQ..."
]
}
],
"voice_id": "your_voice_id",
"prompt": "@subject_1 在公园散步，画面明亮自然",
"audio": false,
"audio_type": "all",
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"movement_amplitude": "auto",
"payload": "custom_transmission_data",
"off_peak": false,
"watermark": false,
"wm_position": 3,
"wm_url": "https://example.com/watermark.png",
"meta_data": "{\"Label\":\"test\",\"ContentProducer\":\"user\",\"ProduceID\":\"task_001\"}",
"callback_url": "https://your-server.com/callback"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"task_id": "vidu_task_20260413_abcdef123456",
"state": "success",
"model": "viduq2-pro",
"prompt": "@subject_1 和 @subject_2 在海边奔跑，画面唯美治愈",
"images": [
"https://example.com/subject1.jpg",
"https://example.com/subject2.png"
],
"duration": 5,
"seed": 123456,
"aspect_ratio": "16:9",
"resolution": "1080p",
"bgm": false,
"audio": true,
"audio_type": "all",
"movement_amplitude": "auto",
"payload": "custom_payload_001",
"off_peak": false,
"credits": 20,
"watermark": false,
"created_at": "2026-04-13 15:30:45"
}