Seedance 2.0 mini 接入说明

模型：doubao-seedance-2-0-mini-260615

Base：https://jiugx.com

OpenAI 兼容视频接口：

创建任务：POST /v1/video/generations

查询任务：GET /v1/video/generations/{task_id}

鉴权：Authorization: Bearer <你的 API Key>

输出限制

项	说明
分辨率	仅 `480p` / `720p`（默认约 `720p`），不支持 `1080p` / `4k`
时长	`4`–`15` 秒；也可传 `-1` 由模型自选长度（预扣按最长档估算）
失败计费	上游失败不收费（按上游规则）

计费说明

按 token 结算。

网关：ModelRatio=11.5，GroupRatio=1.1

无参考视频：约等于上游 ¥23 / 百万 token

有参考视频：上游 ¥14 / 百万 token；网关按 14/23 系数对齐

流程：提交时预扣 → 完成后按实际上游 token 重算，多退少补

给客户看的大致价（无参考视频，2026-10-19 口径）：

规格	约价
720p · 5s	≈ ¥2.76
720p · 15s	≈ ¥8.22
480p · 5s	≈ ¥1.28

有参考视频时单价更低（按 14/23 对齐）。实际以账单为准。

参考素材（三选一，勿混用）

图生视频-首帧、图生视频-首尾帧、全模态参考（图/视频/音频）为三种互斥场景，不可混用。

参考图片

首帧：1 张；首尾帧：首帧 + 尾帧各 1 张；全模态：role=reference_image，1–9 张

格式：jpeg / png / webp / bmp / tiff / gif（以及 heic/heif）

宽高比约 [0.4, 2.5]，边长约 [300, 6000] px，单张 < 30 MB

真人人脸素材会被拒绝（需走上游认证/授权素材路径）

网关便捷写法：顶层 images: ["url"] 可作首帧；首尾帧 / 全模态请放在 metadata.content。

参考视频

最多 3 段，单段约 2–15s，总长 ≤ 15s

格式：mp4 / mov；role 固定 reference_video

参考音频

最多 3 段，单段约 2–15s，总长 ≤ 15s

格式：wav / mp3；role 固定 reference_audio

不可单独使用，须至少搭配 1 张参考图或 1 段参考视频

请求字段（OpenAI 兼容）

字段	说明
`model`	固定 `doubao-seedance-2-0-mini-260615`
`prompt`	文本提示词
`seconds` / `duration`	时长秒数，或 `-1`
`images`	可选，图片 URL 数组（便捷首帧）
`metadata.resolution`	`480p` / `720p`
`metadata.ratio`	如 `16:9` / `9:16` / `1:1` / `adaptive` 等
`metadata.content`	上游风格 content 片段（首尾帧、参考视频/音频/多图）
`metadata.watermark`	是否水印
`metadata.generate_audio`	是否生成音频（按上游能力）

查询：GET /v1/video/generations/{task_id}，轮询至成功后取视频 URL。

示例

以下均省略鉴权头；将 BASE 换为 https://jiugx.com，YOUR_KEY 换为密钥。

1）纯文生

2）images 首帧

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "女孩抱着狐狸，温柔看向镜头，头发被风吹动",
  "seconds": 5,
  "images": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
  ],
  "metadata": {
    "resolution": "720p",
    "ratio": "adaptive",
    "watermark": false
  }
}

3）metadata.content 首尾帧

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "图中女孩对着镜头说“茄子”，360度环绕运镜",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg"
        },
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg"
        },
        "role": "last_frame"
      }
    ],
    "watermark": false
  }
}

4）参考视频

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "保持视频1的运镜风格，让主体继续向前走并略微加速",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "content": [
      {
        "type": "video_url",
        "video_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
        },
        "role": "reference_video"
      }
    ],
    "watermark": false
  }
}

5）参考音频 + 图

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "以图片1为画面参考，全程使用音频1作为背景节奏",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "watermark": false
  }
}

6）图 + 视频 + 音频组合（全模态）

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐；首帧参考图片1，结尾参考图片2",
  "seconds": 11,
  "metadata": {
    "resolution": "720p",
    "ratio": "21:9",
    "content": [
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
        },
        "role": "reference_image"
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
        },
        "role": "reference_video"
      },
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
        },
        "role": "reference_audio"
      }
    ],
    "watermark": false
  }
}

7）查询任务

成功后从返回中的视频 URL 下载结果（链接有有效期，请及时保存）。

备注

本页描述网关 OpenAI 兼容路径；同目录下另有火山原生 /api/v3/contents/generations/tasks 示例（如 doubao-2.0），字段风格不同，勿混用路径。

价格与比例以网关实时配置及上游账单为准；上文数字来自 2026-10-19 实测与火山定价页口径。

输出限制#

计费说明#

参考素材（三选一，勿混用）#

参考图片#

参考视频#

参考音频#

请求字段（OpenAI 兼容）#

示例#

1）纯文生#

2）images 首帧#

3）metadata.content 首尾帧#

4）参考视频#

5）参考音频 + 图#

6）图 + 视频 + 音频组合（全模态）#

7）查询任务#

备注#