Volcengine 视频对口型

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

视频口型同步任务的输入参数。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于视频口型同步的模型名称。必填字段。 - 该端点必须使用 volcengine/video-to-video-lip-sync 模型 默认值："volcengine/video-to-video-lip-sync"。 可选值：volcengine/video-to-video-lip-sync。 示例：volcengine/video-to-video-lip-sync。
mode	string	是	口型同步生成的服务模式。 - lite：适用于单人正面视频，处理速度更快。 - basic：适用于单人复杂场景，支持场景分割和说话人识别。 可选值：lite / basic。 示例：lite。
video_url	string	是	视频素材 URL。支持分辨率：360p–1080p。超过 1080p 的视频将自动压缩至 1080p，小于 360p 的视频暂不支持。支持格式：MOV、MP4、HDR、MKV。推荐编码：H.264。其他格式或编码可能会被转码。最大文件大小：500 MB。码率：1–30 Mbps。帧率：24–60 fps。
audio_url	string	是	目标纯人声音频 URL；用于驱动视频口型运动。lite模式音频时长>1s&<=240s，basic模式音频时长>1s&<=210s。支持的文件类型：audio/mpeg、audio/wav、audio/x-wav、audio/aac、audio/mp4、audio/ogg。最大文件大小：10MB。
separate_vocal	boolean	否	是否启用人声分离以抑制背景噪音。默认值：false。 默认值：false。 示例：false。
open_scenedet	boolean	否	是否启用场景分割和说话人识别。仅在 Basic 模式下支持。默认值：false。 默认值：false。 示例：false。
align_audio	boolean	否	Lite 模式下支持。当音频时长超过视频时长时，是否循环播放视频。默认值：true。 默认值：true。 示例：true。
align_audio_reverse	boolean	否	Lite 模式下支持。是否倒序循环播放视频。需要 align_audio 设置为 true。默认值：false。 默认值：false。 示例：false。
templ_start_seconds	number	否	Lite 模式下支持。模板视频的起始时间，单位为秒。默认值：0。 默认值：0。 示例：0。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。 maxLength: 2000.

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volcengine/video-to-video-lip-sync",
  "mode": "lite",
  "video_url": "https://example.com/reference.mp4",
  "audio_url": "https://example.com/reference.mp3",
  "separate_vocal": false,
  "open_scenedet": false,
  "align_audio": true,
  "align_audio_reverse": false,
  "templ_start_seconds": 0,
  "prompt": "A paper boat drifting down a rainy street."
}'

{
  "model": "volcengine/video-to-video-lip-sync",
  "mode": "lite",
  "video_url": "https://example.com/reference.mp4",
  "audio_url": "https://example.com/reference.mp3",
  "separate_vocal": false,
  "open_scenedet": false,
  "align_audio": true,
  "align_audio_reverse": false,
  "templ_start_seconds": 0,
  "prompt": "A paper boat drifting down a rainy street."
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}