seedance-2.0 原生系列

这一系列包含三个独立公开模型，统一通过 POST /v1/videos 创建任务：

本页直接使用火山公开模型名。具体站点或账号是否已启用某个模型，以当前控制台模型列表和价格页为准。

模型	定位	分辨率	时长
`doubao-seedance-2-0-260128`	标准版，适合高质量和 `1080P` 场景	`480P`、`720P`、`1080P`	`4` - `15` 秒
`doubao-seedance-2-0-fast-260128`	快速版，适合高频生成	`480P`、`720P`	`4` - `15` 秒
`doubao-seedance-2-0-mini-260615`	轻量版，适合批量生成	`480P`、`720P`	`4` - `15` 秒

三个模型都支持文生视频，以及图片、视频、音频参考。标准版与快速版适合更完整的多模态创作；Mini 使用相同的公共请求结构，输出仅支持 480P 和 720P。

请求参数分栏

MoonApiX 统一通用参数	火山官方兼容参数
`model`	`model`（填写本页公开模型 ID）
`prompt`	`content[]` 的 `text` 条目
`references[]`	`content[]` 的 `image_url`、`video_url`、`audio_url` 条目
`aspect_ratio`、`size`	`ratio`、`resolution`
`duration`、`generate_audio`、`watermark`、`seed`、`callback_url`	同名官方字段，显式零值和 `false` 保留

MoonApiX 统一通用视频参数

字段	说明
`model`	三个原生公开模型 ID 之一。
`prompt`	视频描述，可通过 `@alias` 引用素材。
`references[]`	图片、视频和音频统一素材数组，条目包含 `media_type`、`role`、`url`、`alias`。
`aspect_ratio` / `size`	通用比例和分辨率字段，服务端映射到模型参数。
`duration`	`4` - `15` 秒。
`generate_audio`、`watermark`、`seed`、`callback_url`	通用控制字段，按模型能力校验。

火山官方兼容参数

字段	说明
`model`	填写本页三个 MoonApiX 公共模型 ID 之一。
`content[]`	官方多模态数组，条目类型为 `text`、`image_url`、`video_url` 或 `audio_url`，媒体条目带 `role` 和唯一 `alias`。
`ratio` / `resolution`	官方比例和分辨率字段。
`duration`、`generate_audio`、`watermark`、`seed`、`callback_url`	与火山官方语义一致。

基础请求（MoonApiX 统一通用参数）

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "清晨海边，镜头平稳向前推进，浪花自然拍打礁石。",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

基础请求（火山官方兼容参数）

bash

curl https://moonapix.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      { "type": "text", "text": "清晨海边，镜头平稳向前推进，浪花自然拍打礁石。" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

创建成功后保存 task_id 或 id，再调用 GET /v1/videos/{task_id} 查询。只有任务状态为 succeeded 时才读取最终视频地址。

使用参考素材

新接入建议使用 references[]，为每个素材显式提供媒体类型和角色：

json

{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "让 @product 在摄影棚转台上缓慢旋转，保持产品外观一致。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.png",
      "alias": "product"
    }
  ],
  "duration": 5,
  "size": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": false
}

图片、视频和音频可以使用匿名可访问的稳定公网直链。视频和音频参考应满足目标模型的时长、格式和文件大小要求。

多图 + 多视频 + 多音频（MoonApiX 统一通用参数）

三个原生模型使用同一套多模态请求结构。下面示例使用 2 张图片、2 个视频和 2 段音频；请按模型列表返回的实际能力调整数量和分辨率。

json

{
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "让 @subject1、@subject2 保持外观一致，参考 @clip1、@clip2 的动作，并将 @sound1、@sound2 融合为背景声音。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/subject-1.png", "alias": "subject1" },
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/subject-2.png", "alias": "subject2" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/clip-1.mp4", "alias": "clip1" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/clip-2.mp4", "alias": "clip2" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/sound-1.mp3", "alias": "sound1" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/sound-2.mp3", "alias": "sound2" }
  ],
  "duration": 5,
  "size": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}

音频参考必须与图片或视频一起提交；Asset://asset_xxx 也必须先按实际使用的原生模型准备到 generation_ready=true。

多图 + 多视频 + 多音频（火山官方兼容参数）

同一组 2 图 + 2 视频 + 2 音频改用官方 content[] 形状：

json

{
  "model": "doubao-seedance-2-0-fast-260128",
  "content": [
    { "type": "text", "text": "让 @subject1、@subject2 保持外观一致，参考 @clip1、@clip2 的动作，并融合 @sound1、@sound2。" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/subject-1.png" }, "alias": "subject1" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/subject-2.png" }, "alias": "subject2" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/clip-1.mp4" }, "alias": "clip1" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/clip-2.mp4" }, "alias": "clip2" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/sound-1.mp3" }, "alias": "sound1" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/sound-2.mp3" }, "alias": "sound2" }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": true
}

创建可复用素材

普通图片、视频和音频参考素材可以直接调用 POST /v1/assets/uploads 创建，不需要活体认证。推荐使用 mode=asset，并填写实际生成时要使用的模型：

bash

curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "mode": "asset",
    "type": "image",
    "purpose": "reference_image",
    "role": "reference_image",
    "url": "https://example.com/reference.png"
  }'

创建后查询素材详情。只有同时满足以下条件时才用于生成：

text

generation_ready = true
preparation_status = ready

创建视频任务时仍要显式传入返回的 Asset://asset_xxx：

json

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "保持 @hero 的外观和服装一致，让人物自然转身。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "Asset://asset_xxx",
      "alias": "hero"
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9"
}

普通参考素材与私域真人人像资产不是同一流程。普通媒体素材不要求活体认证；需要绑定特定真人身份、长期复用真人形象的私域资产属于受限能力，需要单独完成真人活体认证，不能用普通素材上传替代。

素材准备结果按模型隔离。请按生成请求实际使用的原生模型创建或确认素材，不要把其他模型准备的素材直接混用。

参数列表

MoonApiX 统一通用字段

字段	说明
`model`	填写本页三个公开模型 ID 之一。
`prompt`	视频描述，可通过 `@alias` 引用素材。
`references[]`	图片、视频和音频统一参考数组。
`aspect_ratio` / `size`	通用比例和输出尺寸字段。
`duration`	`4` - `15` 秒。
`generate_audio` / `watermark`	音频和水印开关。
`seed` / `camera_fixed`	可选控制字段。

火山官方兼容字段

字段	说明
`model`	仍填写本页公开模型 ID。
`content[]`	官方多模态输入数组。
`ratio` / `resolution`	官方比例和输出分辨率字段。
`duration`	官方时长字段。
`generate_audio` / `watermark` / `seed`	官方控制字段。

计费

三个模型均按输出 token 结算，并区分是否包含视频输入。不同分辨率、模型版本和输入类型的当前价格以 MoonApiX 控制台、价格接口和实际结算记录为准，本文档不固定展示金额。

对话协议

向量

音频

模型

GPT Image

Gemini Nano

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0 原生系列

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

基础请求（MoonApiX 统一通用参数）

基础请求（火山官方兼容参数）

使用参考素材

多图 + 多视频 + 多音频（MoonApiX 统一通用参数）

多图 + 多视频 + 多音频（火山官方兼容参数）

创建可复用素材

参数列表

MoonApiX 统一通用字段

火山官方兼容字段

计费

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0 原生系列 ​

请求参数分栏 ​

MoonApiX 统一通用视频参数 ​

火山官方兼容参数 ​

基础请求（MoonApiX 统一通用参数） ​

基础请求（火山官方兼容参数） ​

使用参考素材 ​

多图 + 多视频 + 多音频（MoonApiX 统一通用参数） ​

多图 + 多视频 + 多音频（火山官方兼容参数） ​

创建可复用素材 ​

参数列表 ​

MoonApiX 统一通用字段 ​

火山官方兼容字段 ​

计费 ​

相关页面 ​

seedance-2.0 原生系列

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

基础请求（MoonApiX 统一通用参数）

基础请求（火山官方兼容参数）

使用参考素材

多图 + 多视频 + 多音频（MoonApiX 统一通用参数）

多图 + 多视频 + 多音频（火山官方兼容参数）

创建可复用素材

参数列表

MoonApiX 统一通用字段

火山官方兼容字段

计费

相关页面