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。

这些模型和 seedance-2.0-kz / seedance-2.0-kz-fast 属于不同的公开模型入口。请按本页说明单独接入，不要把不同模型线的素材 ID、上传流程或参数边界混用。

当前配置

项目	说明
推荐入口	`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`
结果 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` 秒

素材策略

这条模型线支持公网 URL、MoonApiX 托管 URL 和 Asset://asset_xxx 素材引用。请注意，seedance-2.0-cl 系列和 seedance-2.0-kz / seedance-2.0-kz-fast 是不同公开模型入口，素材准备结果不跨模型线通用。

如果你的图片已经有稳定公网 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。
不要把 seedance-2.0-kz / seedance-2.0-kz-fast 模型线创建或准备的素材 ID 直接混用到 seedance-2.0-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"
  }'

创建视频任务

公网图片 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,
    "ratio": "16:9",
    "resolution": "480p",
    "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,
    "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://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,
    "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	可选。MoonApiX 通用素材引用数组。
`references[].media_type`	string	常用 `image` 或 `video`。
`references[].role`	string	常见值为 `first_frame`、`reference_image`、`reference_video`。
`references[].url`	string	公网 URL、MoonApiX 托管 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`。
`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 或图片素材引用不算视频输入。当前价格页展示为不含视频输入 23 CNY / 1M output tokens，含视频输入 14 CNY / 1M output tokens。

常见问题

素材 ID 可以和 seedance-2.0-kz 主线混用吗？

不建议混用。seedance-2.0-cl 系列和 seedance-2.0-kz / seedance-2.0-kz-fast 是不同公开模型入口，请按实际生成模型创建或确认素材。业务系统里建议同时保存 asset_id、asset_ref、目标模型和素材状态。

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

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

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

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

对话协议

向量

音频

模型

Ideogram 图像

Midjourney 任务

Seedance-2 视频

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

当前配置

能力边界

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

content[] 写法

常用字段

查询结果

价格和计费

常见问题

素材 ID 可以和 seedance-2.0-kz 主线混用吗？

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

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

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

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

当前配置 ​

能力边界 ​

素材策略 ​

创建 CL 素材引用 ​

创建 CL 视频素材引用 ​

创建视频任务 ​

公网图片 URL 图生视频 ​

Asset:// 图生视频 ​

参考视频 + 图片 URL ​

references[] 写法 ​

content[] 写法 ​

常用字段 ​

查询结果 ​

价格和计费 ​

常见问题 ​

素材 ID 可以和 seedance-2.0-kz 主线混用吗？ ​

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

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

相关页面 ​

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

当前配置

能力边界

素材策略

创建 CL 素材引用

创建 CL 视频素材引用

创建视频任务

公网图片 URL 图生视频

Asset:// 图生视频

参考视频 + 图片 URL

references[] 写法

content[] 写法

常用字段

查询结果

价格和计费

常见问题

素材 ID 可以和 seedance-2.0-kz 主线混用吗？

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

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

相关页面