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

本页只说明 CL 系列。素材 ID、上传流程和参数边界均以本页三个 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；视频参考建议通过素材接口创建本模型线可用的 MoonNexAI `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 输入	推荐	推荐	推荐
MoonNexAI 托管 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,
  "ratio": "16:9",
  "resolution": "480p"
}

关闭音频：

json

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

素材策略

这条模型线支持公网 URL、MoonNexAI 托管 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 模型，并在生成前确认素材状态。
客户侧可以保存 MoonNexAI 的 asset_xxx / Asset://asset_xxx，并记录它用于哪条模型线，便于后续复用和排查。

创建 CL 素材引用

bash

curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_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://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_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"
  }'

创建视频任务

公网图片 URL 图生视频

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_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,
    "ratio": "16:9",
    "resolution": "480p",
    "generate_audio": false,
    "watermark": false
  }'

Asset:// 图生视频

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_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,
    "ratio": "16:9",
    "resolution": "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://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_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,
    "ratio": "1:1",
    "resolution": "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,
  "ratio": "16:9",
  "resolution": "480p",
  "watermark": false
}

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

content[] 写法

如果你需要兼容多模态 content[] 格式，可以把图片作为 image_url 条目传入：

图片、视频和音频条目建议显式填写 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
}

常用字段

字段	类型	说明
`model`	string	固定填写 `seedance-2.0-cl-fast`、`seedance-2.0-cl` 或 `seedance-2.0-cl-mini`。
`prompt`	string	视频描述。建议包含主体、动作、镜头、场景和风格。
`content[]`	array	可选。多模态输入数组，可放文本、图片和视频条目。
`image_url`	string	可选。单图图生视频常用字段，可传公网 URL 或已 ready 的 `Asset://asset_xxx`。
`video_url`	string	可选。参考视频常用字段，可传公网 URL 或已 ready 的 `Asset://asset_xxx`。
`reference_video_url`	string	可选。参考视频 URL 或已 ready 的 `Asset://asset_xxx`。
`first_frame_url`	string	可选。首帧图生视频字段，可传公网 URL 或已 ready 的 `Asset://asset_xxx`。
`references[]`	array	可选。MoonNexAI 通用素材引用数组。
`references[].media_type`	string	常用 `image` 或 `video`。
`references[].role`	string	常见值为 `first_frame`、`reference_image`、`reference_video`。
`references[].url`	string	公网 URL、MoonNexAI 托管 URL 或已 ready 的 `Asset://asset_xxx`。
`references[].alias`	string	可选。素材别名，例如 `product`、`hero`。
`duration`	number/string	视频时长，CL 系列支持 `4` - `15` 秒。
`ratio` / `aspect_ratio`	string	画面比例，例如 `16:9`、`9:16`、`1:1`。
`resolution`	string	输出分辨率，例如 `480p`、`720p`、`1080p`；`seedance-2.0-cl-mini` 仅支持 `480p` / `720p`。
`generate_audio`	boolean	可选。三个 CL 型号均支持；省略时默认 `true`，显式传 `false` 时关闭生成音频。
`generateAudio`	boolean	可选兼容字段，语义与 `generate_audio` 相同；新接入优先使用 `generate_audio`。
`watermark`	boolean	是否添加水印。
`callback_url`	string	可选。任务完成后的回调地址。

查询结果

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

bash

curl https://moonnexai.com/v1/videos/{task_id} \
  -H "Authorization: Bearer <MOONNEXAI_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 系列按 MoonNexAI Seedance-2 标准 token 口径展示和结算。具体价格、含视频输入价格和分组倍率以 MoonNexAI 后台价格页、模型列表接口和实际结算日志为准。

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 或图片素材引用不算视频输入。实际价格以 MoonNexAI 控制台和计费记录为准。

常见问题

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

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

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

当前配置

能力边界

音频开关

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

content[] 写法

常用字段

查询结果

价格和计费

常见问题

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 视频素材引用 ​

创建视频任务 ​

公网图片 URL 图生视频 ​

Asset:// 图生视频 ​

参考视频 + 图片 URL ​

references[] 写法 ​

content[] 写法 ​

常用字段 ​

查询结果 ​

价格和计费 ​

常见问题 ​

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

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

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

相关页面 ​

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

当前配置

能力边界

音频开关

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

content[] 写法

常用字段

查询结果

价格和计费

常见问题

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

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

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

相关页面