⚠️紧急通知：由于火山官方近期在严格自查客户违规转售 API 的行为，当前海外渠道收到官方预警。即日起，先暂停海外seedance API 接口服务，恢复时间另行通知，非常抱歉给您带来不便，感谢理解与支持🙏

参考生视频（非主体调用）

POST

https://vg-api.aig-ai.com/v1/{model_id}/reference2video

参考生视频分为音视频直出、视频直出功能，二者使用相同的接口地址与请求方式，请求体不同，参考下方示例。
参考生视频-音视频直出：您可以指定视频中的主体用台词对话，直接生成完整的音视频；
参考生视频-视频直出：为视频的场景配置对应背景音乐，不含台词。

请求参数

Path 参数

Header 参数

Body 参数application/json必填

示例

{
  "model": "viduq3",
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
    "https://example.com/image.jpg"
  ],
  "videos": [
    "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21j...",
    "https://example.com/reference.mp4"
  ],
  "prompt": "生成一段动态流畅的视频，画面清晰，运镜稳定",
  "bgm": false,
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "watermark": false,
  "wm_position": 3,
  "wm_url": "",
  "meta_data": "{\"Label\":\"\",\"ContentProducer\":\"\",\"ContentPropagator\":\"\",\"ProduceID\":\"\",\"PropagateID\":\"\",\"ReservedCode1\":\"\",\"ReservedCode2\":\"\"}",
  "callback_url": "https://your-domain.com/callback"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://vg-api.aig-ai.com/v1//reference2video' \
--header 'Authorization: Bearer sk-abcdefghijklmnopqrstuvwxyz1234567890' \
--header 'Content-Type: application/json' \
--data '{
  "model": "viduq3",
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
    "https://example.com/image.jpg"
  ],
  "videos": [
    "data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21j...",
    "https://example.com/reference.mp4"
  ],
  "prompt": "生成一段动态流畅的视频，画面清晰，运镜稳定",
  "bgm": false,
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "watermark": false,
  "wm_position": 3,
  "wm_url": "",
  "meta_data": "{\"Label\":\"\",\"ContentProducer\":\"\",\"ContentPropagator\":\"\",\"ProduceID\":\"\",\"PropagateID\":\"\",\"ReservedCode1\":\"\",\"ReservedCode2\":\"\"}",
  "callback_url": "https://your-domain.com/callback"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene.",
  "duration": 5,
  "seed": random_number,
  "aspect_ratio": "4:3",
  "resolution": "540p",
  "movement_amplitude": "auto",
  "payload":"",
  "off_peak": false,
  "credits": credits_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

图生视频

参考生视频（主体调用）