Doubao 多模态生视频

开发中

POST

/v1/video/generations

视频生成为异步任务：先创建任务，再轮询查询结果。
支持文生视频、图生视频、多模态参考生视频（文本 / 图片 / 视频 / 音频组合）。
创建成功后返回任务 ID，初始状态为 queued；生成完成后可通过查询接口获取

注意：sd-2.0:首帧、首尾帧和多模态参考三种场景互斥
sd-2.5:视频编辑/延长及首尾帧任务仅支持 ratio=adaptive；视频编辑仅支持 duration=-1

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "model": "sd-2.5",
  "prompt": "参考角色外观和背景风格，沿用参考视频的镜头节奏，配上参考音频的情绪氛围，生成一段 10 秒的城市街头漫步短片",
  "duration": 10,
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false,
    "return_last_frame": false,
    "seed": -1,
    "output_format": "mp4",
    "omni_reference_task_type": "auto"
  },
  "references": [
    {
      "type": "image_url",
      "url": "https://example.com/character.jpg"
    },
    {
      "type": "image_url",
      "url": "https://example.com/background_style.jpg"
    },
    {
      "type": "video_url",
      "url": "https://example.com/reference_motion.mp4"
    },
    {
      "type": "audio_url",
      "url": "https://example.com/mood_audio.mp3",
      "role": "reference_audio"
    }
  ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.northrouter.com/v1/video/generations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'New-Api-User: 1' \
--header 'Content-Type: application/json' \
--data '{
  "model": "sd-2.5",
  "prompt": "参考角色外观和背景风格，沿用参考视频的镜头节奏，配上参考音频的情绪氛围，生成一段 10 秒的城市街头漫步短片",
  "duration": 10,
  "metadata": {
    "resolution": "1080p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false,
    "return_last_frame": false,
    "seed": -1,
    "output_format": "mp4",
    "omni_reference_task_type": "auto"
  },
  "references": [
    {
      "type": "image_url",
      "url": "https://example.com/character.jpg"
    },
    {
      "type": "image_url",
      "url": "https://example.com/background_style.jpg"
    },
    {
      "type": "video_url",
      "url": "https://example.com/reference_motion.mp4"
    },
    {
      "type": "audio_url",
      "url": "https://example.com/mood_audio.mp3",
      "role": "reference_audio"
    }
  ]
}'

返回响应

🟢200

application/json

任务提交成功

Bodyapplication/json

示例

{
    "id": "task_9dCRAoO3xpog78cQjdrsm90d88kFcAM5",
    "task_id": "task_9dCRAoO3xpog78cQjdrsm90d88kFcAM5",
    "object": "video",
    "model": "sd-2.5",
    "status": "queued",
    "progress": 0,
    "created_at": 1787884306
}

修改于 2026-09-21 13:52:22

Doubao 视频生视频

查询视频生成任务状态