火山标准格式

约 951 字大约 3 分钟

如果你部署的是包含火山原生兼容路由的自定义二进制，可以使用火山 Ark 风格的任务接口。

创建任务

POST https://mivsub.com/api/v3/contents/generations/tasks
Authorization: Bearer sk-你的中转key
Content-Type: application/json

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考多张图片，生成一个人物在城市街头行走的电影感视频"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://example.com/person.jpg"
      }
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://example.com/scene.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

创建成功后会返回一个中转侧任务 ID，例如：

{
  "id": "task_xxx"
}

查询任务

GET https://mivsub.com/api/v3/contents/generations/tasks/task_xxx
Authorization: Bearer sk-你的中转key

标准请求约定

截图中的 7 种创建方式都使用同一个火山标准创建地址，区别只在 content[] 中传入的素材类型：

POST https://mivsub.com/api/v3/contents/generations/tasks
Authorization: Bearer sk-你的中转key
Content-Type: application/json

下面示例中的 model、resolution、ratio、duration、generate_audio 和 watermark 可以按渠道实际支持范围调整。

文生视频标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "黄昏时分的海边公路，一辆复古汽车缓慢驶过，镜头平稳推进"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

图生视频标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "让画面中的人物自然转身，镜头缓慢推进"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.example.com/input/person.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "9:16",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

多图参考标准格式

提示词使用 [Image 1]、[Image 2] 等标记对应图片，所有图片对象都使用 reference_image：

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考 [Image 1] 的人物、[Image 2] 的服装和 [Image 3] 的场景，生成城市街头行走的视频"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.example.com/reference/person.jpg"
      }
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.example.com/reference/clothes.jpg"
      }
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.example.com/reference/scene.jpg"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

视频参考标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考 [Video 1] 的镜头节奏和运镜方式，将主体替换为一辆银色跑车"
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://cdn.example.com/reference/motion.mp4"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

音频参考标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考 [Audio 1] 的节奏，生成霓虹城市夜景中人物慢慢走过街道的视频"
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://cdn.example.com/reference/music.mp3"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

视频+音频参考标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考 [Video 1] 的动作和镜头，参考 [Audio 1] 的节奏，生成舞者连续旋转的视频"
    },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://cdn.example.com/reference/dance.mp4"
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://cdn.example.com/reference/beat.mp3"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

图片+音频参考标准格式

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "参考 [Image 1] 中的产品外观，配合 [Audio 1] 的节奏，生成产品旋转展示的广告视频"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://cdn.example.com/reference/product.jpg"
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://cdn.example.com/reference/product-music.mp3"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "1:1",
  "duration": 5,
  "generate_audio": true,
  "watermark": false
}

标准字段速查

素材	`type`	`role`	URL 字段
图片	`image_url`	`reference_image`	`image_url.url`
视频	`video_url`	`reference_video`	`video_url.url`
音频	`audio_url`	`reference_audio`	`audio_url.url`

所有素材对象的 role 都必须位于对象外层。素材 URL 必须公网直连，不能依赖 Cookie、登录态或浏览器 Referer。

role 的正确位置

火山标准格式中，role 在 content[] 的图片对象外层：

{
  "type": "image_url",
  "role": "reference_image",
  "image_url": {
    "url": "https://example.com/image.jpg"
  }
}

下面这种内层 role 不符合火山标准：

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/image.jpg",
    "role": "reference_image"
  }
}

结论：如果上游提示 role must be specified for image contents，优先检查中转转发后是否完整保留 metadata.content[].role，而不是把 role 放进 image_url。