seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini

seedance-2.0-cl、seedance-2.0-cl-fast 和 seedance-2.0-cl-mini 是 MoonApiX Seedance-2 的独立标准兼容线路。它们适合文生视频、图生视频、常规参考图视频和带参考视频的任务。创建任务时，model 固定填写 seedance-2.0-cl、seedance-2.0-cl-fast 或 seedance-2.0-cl-mini。

本页只说明 CL 系列。素材 ID、上传流程和参数边界均以本页三个 CL 模型为准。

seedance-2.0-cl-b-fast 和 seedance-2.0-cl-b-mini 属于独立的 CL-B 模型线，官方 content[] 兼容范围请参阅 CL-B 系列页面，不要直接套用本页三种 CL 型号的能力边界。

当前配置

项目	说明
推荐入口	`POST /v1/videos`
查询入口	`GET /v1/videos/{task_id}` 或 `GET /v1/tasks/{task_id}`
推荐快速模型	`seedance-2.0-cl-fast`
推荐高质量模型	`seedance-2.0-cl`
推荐轻量模型	`seedance-2.0-cl-mini`
推荐素材字段	`image_url`、`video_url`、`reference_video_url`、`first_frame_url`、`references[]`、`content[]`
推荐素材来源	图片可用稳定公网 URL；视频参考建议通过素材接口创建本模型线可用的 MoonApiX `Asset://asset_xxx`
默认音频	`generate_audio` 省略时按 `true` 处理；显式传 `false` 可关闭生成音频
结果 URL	查询成功后从 `url`、`video_url`、`result_url`、`output.url` 或 `metadata.url` 读取

能力边界

能力	`seedance-2.0-cl-fast`	`seedance-2.0-cl`	`seedance-2.0-cl-mini`
文生视频	支持	支持	支持
单图图生视频	支持	支持	支持
参考图视频	支持	支持	支持
参考视频	支持	支持	支持
参考音频	支持	支持	支持
生成音频	支持，默认开启	支持，默认开启	支持，默认开启
公网 URL 输入	推荐	推荐	推荐
MoonApiX 托管 URL	支持	支持	支持
`Asset://` 素材引用	支持	支持	支持
素材创建	支持通过素材接口创建本模型线可用的 `Asset://asset_xxx`	支持通过素材接口创建本模型线可用的 `Asset://asset_xxx`	支持通过素材接口创建本模型线可用的 `Asset://asset_xxx`
常用分辨率	`480P`、`720P`	`480P`、`720P`、`1080P`	`480P`、`720P`
时长	`4` - `15` 秒	`4` - `15` 秒	`4` - `15` 秒

音频开关

三个 CL 型号均支持 generate_audio：

省略 generate_audio 时默认生成音频，等价于传入 "generate_audio": true。
显式传入 "generate_audio": false 时关闭生成音频，成功视频不包含音轨。
generateAudio 作为兼容字段也可使用，但新接入统一使用 generate_audio。

默认开启音频：

json

{
  "model": "seedance-2.0-cl-fast",
  "prompt": "A peaceful sunrise over a quiet lake with gentle ambient music.",
  "duration": 4,
  "aspect_ratio": "16:9",
  "size": "480p"
}

关闭音频：

json

{
  "model": "seedance-2.0-cl-fast",
  "prompt": "A peaceful sunrise over a quiet lake.",
  "duration": 4,
  "aspect_ratio": "16:9",
  "size": "480p",
  "generate_audio": false
}

素材策略

这条模型线支持公网 URL、MoonApiX 托管 URL 和 Asset://asset_xxx 素材引用。CL 素材准备结果只按实际使用的 CL 模型确认。

如果你的图片已经有稳定公网 URL，直接在视频生成请求里传 URL。
如果需要素材复用，可以调用 /v1/assets/uploads，传入 mode=asset 和目标模型 seedance-2.0-cl-fast、seedance-2.0-cl 或 seedance-2.0-cl-mini，创建本模型线可用的 Asset://asset_xxx。
参考视频建议先创建视频素材引用：type=video、purpose=reference_video、role=reference_video。生成时把返回的 Asset://asset_xxx 传给 video_url、reference_video_url 或 references[].url。
使用 Asset://asset_xxx 前，请确认素材详情显示 generation_ready=true / preparation_status=ready。
素材创建和准备时必须填写实际使用的 CL 模型，并在生成前确认素材状态。
客户侧可以保存 MoonApiX 的 asset_xxx / Asset://asset_xxx，并记录它用于哪条模型线，便于后续复用和排查。

创建 CL 素材引用

bash

curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-cl-mini",
    "mode": "asset",
    "type": "image",
    "url": "https://example.com/product.png"
  }'

创建 CL 视频素材引用

bash

curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-cl",
    "mode": "asset",
    "type": "video",
    "purpose": "reference_video",
    "role": "reference_video",
    "url": "https://example.com/reference.mp4"
  }'

请求参数分栏

MoonApiX 统一通用视频参数

统一入口为 POST /v1/videos，推荐使用 prompt、references[]、aspect_ratio 和 size。

字段	类型	说明
`model`	string	`seedance-2.0-cl-fast`、`seedance-2.0-cl` 或 `seedance-2.0-cl-mini`。
`prompt`	string	视频描述和素材绑定说明。
`references[]`	array	通用素材数组，条目使用 `media_type`、`role`、`url` 和可选 `alias`。
`duration`	number	`4` - `15` 秒。
`aspect_ratio`	string	画面比例。
`size`	string	`480p`、`720p` 或当前型号支持的尺寸。
`generate_audio`	boolean	是否生成音频，省略时默认 `true`。
`watermark`	boolean	是否添加水印。
`callback_url`	string	可选回调地址。

火山官方兼容参数

兼容入口为 POST /api/v3/contents/generations/tasks，使用官方的 content[]、ratio 和 resolution。同一请求不要同时传 references[] 和 content[]。

字段	类型	说明
`model`	string	仍填写 CL 系列 MoonApiX 公共模型名。
`content[]`	array	官方文本、图片、视频和音频条目。
`duration`	number	官方时长字段，支持 `4` - `15` 秒。
`ratio`	string	官方比例字段。
`resolution`	string	官方分辨率字段。
`generate_audio`	boolean	官方音频生成开关。
`watermark`	boolean	官方水印开关。
`callback_url`	string	官方回调地址。

创建视频任务

公网图片 URL 图生视频

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-cl-fast",
    "prompt": "Animate this product image with a slow camera push-in and clean studio lighting.",
    "image_url": "https://example.com/product.png",
    "input_reference_role": "first_frame",
    "duration": 4,
    "aspect_ratio": "16:9",
    "size": "480p",
    "generate_audio": false,
    "watermark": false
  }'

Asset:// 图生视频

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-cl-fast",
    "prompt": "Animate the uploaded product with a premium studio camera move.",
    "image_url": "Asset://asset_xxx",
    "input_reference_role": "first_frame",
    "duration": 4,
    "aspect_ratio": "16:9",
    "size": "480p",
    "watermark": false
  }'

请先确认素材是按 seedance-2.0-cl-fast / seedance-2.0-cl 准备，且素材详情中 generation_ready=true、preparation_status=ready，再把 Asset://asset_xxx 用于本模型线视频生成。

参考视频 + 图片 URL

参考视频可以先创建为 Asset://asset_xxx，图片参考如果有稳定公网 URL，可以直接传 image_url：

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-cl",
    "prompt": "保留参考视频中的动作和镜头节奏，把人物上衣图案替换为参考图片风格。",
    "video_url": "Asset://asset_video_xxx",
    "image_url": "https://example.com/reference-shirt.png",
    "duration": 5,
  "aspect_ratio": "1:1",
  "size": "720p"
  }'

提交成功后，响应里的 input_references 通常会显示图片和视频均已绑定：

json

[
  {
    "alias": "图片1",
    "binding_status": "bound",
    "role": "reference_image",
    "type": "image"
  },
  {
    "alias": "视频1",
    "binding_status": "bound",
    "role": "reference_video",
    "type": "video"
  }
]

references[] 写法

如果你的系统已经统一使用 references[]，也可以这样提交：

json

{
  "model": "seedance-2.0-cl-mini",
  "prompt": "Let @product slowly rotate on a clean studio table, cinematic lighting.",
  "references": [
    {
      "media_type": "image",
      "role": "first_frame",
      "url": "Asset://asset_xxx",
      "alias": "product"
    }
  ],
  "duration": 4,
  "aspect_ratio": "16:9",
  "size": "480p",
  "watermark": false
}

seedance-2.0-cl-mini 和 CL 系列使用同一套参数体系；区别是 mini 当前只使用 480p / 720p 分辨率。时长同样支持 4 - 15 秒。

多图 + 多视频 + 多音频示例

CL 系列使用与其他火山官方 Seedance 线路一致的混合素材结构。下面示例使用 2 张图片、2 个视频和 2 段音频；具体单类和总数上限以当前模型能力返回为准：

json

{
  "model": "seedance-2.0-cl",
  "prompt": "保持 @product1、@product2 的外观一致，参考 @motion1、@motion2 的动作节奏，并融合 @audio1、@audio2 的声音氛围。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/product-1.png", "alias": "product1" },
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/product-2.png", "alias": "product2" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-1.mp4", "alias": "motion1" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-2.mp4", "alias": "motion2" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/audio-1.mp3", "alias": "audio1" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/audio-2.mp3", "alias": "audio2" }
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "size": "720p",
  "generate_audio": true
}

CL 页面中的 references[].media_type 可使用 image、video 或 audio。不同型号的细微差异由模型能力配置在创建前校验，客户端保持同一套结构即可。

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

json

{
  "model": "seedance-2.0-cl",
  "content": [
    { "type": "text", "text": "保持 @product1、@product2 的外观一致，参考 @motion1、@motion2 的动作节奏，并融合 @audio1、@audio2。" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/product-1.png" }, "alias": "product1" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/product-2.png" }, "alias": "product2" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-1.mp4" }, "alias": "motion1" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-2.mp4" }, "alias": "motion2" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/audio-1.mp3" }, "alias": "audio1" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/audio-2.mp3" }, "alias": "audio2" }
  ],
  "duration": 5,
  "ratio": "16:9",
  "resolution": "720p",
  "generate_audio": true
}

content[] 写法

如果你需要兼容多模态 content[] 格式，可以把图片作为 image_url 条目传入；直接使用火山官方入口时，将示例地址替换为 /api/v3/contents/generations/tasks：

图片、视频和音频条目建议显式填写 role。图片常用 first_frame 或 reference_image，视频常用 reference_video。缺少 role 时，部分兼容线路可能会按服务端参数校验返回 400。

json

{
  "model": "seedance-2.0-cl-fast",
  "content": [
    {
      "type": "text",
      "text": "Animate the product with a slow camera push-in and soft studio lighting."
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ],
  "duration": 4,
  "ratio": "16:9",
  "resolution": "480p",
  "watermark": false
}

参数列表

MoonApiX 统一通用字段

字段	类型	说明
`model`	string	CL 系列公开模型名。
`prompt`	string	视频描述。
`references[]`	array	通用素材引用数组。
`references[].media_type` / `role` / `url` / `alias`	mixed	媒体类型、用途、稳定 URL 或 `Asset://`、可选别名。
`duration`	number	`4` - `15` 秒。
`aspect_ratio`	string	画面比例。
`size`	string	输出尺寸；Mini 仅支持 `480p` / `720p`。
`generate_audio`	boolean	是否生成音频，省略时默认 `true`。
`watermark`	boolean	是否添加水印。
`callback_url`	string	可选回调地址。

火山官方兼容字段

字段	类型	说明
`model`	string	仍填写 CL 系列 MoonApiX 公共模型名。
`content[]`	array	官方多模态输入数组。
`image_url` / `video_url` / `reference_video_url`	string	官方单媒体字段。
`first_frame_url` / `last_frame_url`	string	官方首尾帧字段。
`duration`	number	官方时长字段。
`ratio`	string	官方比例字段。
`resolution`	string	官方分辨率字段。
`generate_audio` / `generateAudio`	boolean	官方音频生成开关及兼容别名。
`watermark`	boolean	官方水印开关。
`callback_url`	string	官方回调地址。

查询结果

创建响应只代表任务已提交，请保存 id 或 task_id 并继续查询：

bash

curl https://moonapix.com/v1/videos/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

任务成功后，建议按这个顺序读取最终视频地址：

text

data.video_url
video_url
url
result_url
output.url
metadata.url

请先判断 status 是否为 succeeded。如果任务还在 pending、submitted 或 running，继续轮询同一个 task_id；如果 status=failed，读取 error.message 并保存 task_id、request_id 和 trace_id 方便排查。

价格和计费

CL 系列按 MoonApiX Seedance-2 标准 token 口径展示和结算。具体价格、含视频输入价格和分组倍率以 MoonApiX 后台价格页、模型列表接口和实际结算日志为准。

seedance-2.0-cl-mini 当前支持 480P / 720P 输出 token 计费：不含视频输入的请求按非视频输入规则结算，含视频输入的请求按含视频输入规则结算。这里的“含视频输入”包括 video_url、reference_video_url、videos[]、references[] 中的 media_type=video 或 role=reference_video，以及 Asset://asset_xxx 视频素材引用；只传图片 URL 或图片素材引用不算视频输入。实际价格以 MoonApiX 控制台和计费记录为准。

常见问题

CL 素材 ID 可以跨模型使用吗？

素材应按实际生成模型创建或确认。业务系统里建议同时保存 asset_id、asset_ref、目标 CL 模型和素材状态。

已上传素材会自动用于下一次视频生成吗？

不会。每次创建视频任务都必须显式传入 image_url、first_frame_url、references[] 或 content[] 中的图片 URL / Asset://asset_xxx。只传 input_type 不会自动加载最近上传或最近审核通过的素材。

结果 URL 应该保存哪个字段？

先判断 status=succeeded，再按本页的 URL 读取顺序保存第一个可访问的视频地址。不要在 pending、running 或 failed 状态下把 URL 当成最终结果。

对话协议

向量

音频

模型

GPT Image

Gemini Nano

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini

当前配置

能力边界

音频开关

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

多图 + 多视频 + 多音频示例

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

content[] 写法

参数列表

MoonApiX 统一通用字段

火山官方兼容字段

查询结果

价格和计费

常见问题

CL 素材 ID 可以跨模型使用吗？

已上传素材会自动用于下一次视频生成吗？

结果 URL 应该保存哪个字段？

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini ​

当前配置 ​

能力边界 ​

音频开关 ​

素材策略 ​

创建 CL 素材引用 ​

创建 CL 视频素材引用 ​

请求参数分栏 ​

MoonApiX 统一通用视频参数 ​

火山官方兼容参数 ​

创建视频任务 ​

公网图片 URL 图生视频 ​

Asset:// 图生视频 ​

参考视频 + 图片 URL ​

references[] 写法 ​

多图 + 多视频 + 多音频示例 ​

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

content[] 写法 ​

参数列表 ​

MoonApiX 统一通用字段 ​

火山官方兼容字段 ​

查询结果 ​

价格和计费 ​

常见问题 ​

CL 素材 ID 可以跨模型使用吗？ ​

已上传素材会自动用于下一次视频生成吗？ ​

结果 URL 应该保存哪个字段？ ​

相关页面 ​

seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini

当前配置

能力边界

音频开关

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

请求参数分栏

MoonApiX 统一通用视频参数

火山官方兼容参数

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

多图 + 多视频 + 多音频示例

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

content[] 写法

参数列表

MoonApiX 统一通用字段

火山官方兼容字段

查询结果

价格和计费

常见问题

CL 素材 ID 可以跨模型使用吗？

已上传素材会自动用于下一次视频生成吗？

结果 URL 应该保存哪个字段？

相关页面