seedance-2.5-cl

seedance-2.5-cl 是 MoonNexAI 的 Seedance 2.5 标准视频模型，适合文生视频、图生视频和图片、视频、音频混合参考。创建任务时，model 固定填写 seedance-2.5-cl。

当前配置

项目	说明
创建入口	POST /v1/videos；官方形状兼容入口 POST /api/v3/contents/generations/tasks
查询入口	GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
输出格式	mp4、mov
分辨率	480P、720P、1080P
时长	4 - 30 秒
比例	16:9、9:16、1:1、4:3、3:4、21:9；部分任务支持 adaptive
生成音频	支持，省略 generate_audio 时默认开启

实际可用参数以 GET /v1/models 和当前 API Key 权限为准。

能力边界

能力	支持情况
文生视频	支持
单图和多图参考	最多 30 张图片
参考视频	最多 10 个
参考音频	最多 10 个；需要同时提供图片或视频
混合参考素材	合计最多 50 个
首帧 / 尾帧	支持，按请求中的 role 指定
真人参考	支持；仍需通过内容安全审核

创建视频任务

文生视频

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-cl",
    "prompt": "清晨海边，镜头平稳向前推进，电影感光线。",
    "duration": 4,
    "aspect_ratio": "16:9",
    "size": "480p",
    "generate_audio": true
  }'

图片参考

新接入推荐使用 references[]。图片可以是无需登录即可抓取的稳定公网 URL，也可以是已经按 seedance-2.5-cl 准备完成的 Asset:// 素材引用：

{
  "model": "seedance-2.5-cl",
  "prompt": "图中女孩对着镜头说“茄子”，镜头缓慢环绕。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "Asset://asset_xxx",
      "alias": "人物"
    }
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "size": "480p",
  "generate_audio": true
}

官方兼容参数

seedance-2.5-cl 在 POST /v1/videos 中支持火山官方形状的 content[]、ratio、resolution、duration 和 generate_audio。需要保留官方请求路径时，也可以使用 POST /api/v3/contents/generations/tasks。两种入口都使用 MoonNexAI API Key，model 均填写 seedance-2.5-cl。

这里的兼容指请求字段表达方式；不代表支持官方所有高级参数或任意参数取值。时长、分辨率、素材数量和角色仍以本页能力边界为准。

MoonNexAI 通用写法	官方兼容写法
prompt	content[] 中的 type=text 条目
references[]	content[] 中的 image_url、video_url、audio_url 条目
aspect_ratio	ratio
size	resolution
duration、generate_audio	字段名相同；显式 generate_audio=false 可关闭音轨

新接入仍推荐 references[]。同一请求选择一种素材表达方式，不要同时提交 content[] 和 references[]，也不要重复填写 prompt 与 content[].text。

以下为认证图片的官方兼容请求，示例中的素材必须已按 seedance-2.5-cl 准备完成：

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-cl",
    "content": [
      { "type": "text", "text": "图中女孩对着镜头说“茄子”，360度环绕运镜" },
      {
        "type": "image_url",
        "role": "reference_image",
        "alias": "Image1",
        "image_url": { "url": "Asset://asset_xxx" }
      }
    ],
    "duration": 4,
    "ratio": "9:16",
    "resolution": "480p",
    "generate_audio": true,
    "output_format": "mp4"
  }'

使用官方兼容入口时，将上例请求路径替换为 /api/v3/contents/generations/tasks，请求体保持不变。content[].image_url.url 中的 Asset:// 与 references[].url 具有相同的认证素材语义；解析失败直接报错，不会转为公网 URL。素材认证成功仍需通过生成时的内容安全审核。

认证素材

需要复用认证素材时，先调用 POST /v1/assets/uploads，使用 mode=asset 和目标模型 seedance-2.5-cl，然后等待素材详情中的 generation_ready=true、preparation_status=ready。创建视频时必须显式传入返回的 Asset://asset_xxx。

认证素材引用与普通公网 URL 是两种不同的输入语义：

• Asset://asset_xxx 表示使用已经按当前模型准备并认证的素材。
• 如果素材引用缺少当前模型的可用绑定、状态未 ready 或引用解析失败，视频请求会直接返回错误。
• 认证素材不会静默降级为公网 URL；如果业务需要使用公网 URL，应在请求中明确传入公网 URL。
• 不同 Seedance 模型线的 Asset:// 素材不要直接混用，必须按实际生成模型重新准备或确认。

创建认证素材

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

素材上传和认证本身不计视频生成费用；后续视频任务按模型计费。已上传素材不会自动附加到新任务，每次请求都要显式传入素材引用。

多素材参考

{
  "model": "seedance-2.5-cl",
  "prompt": "保持 @人物 的外观，参考 @动作 的镜头节奏，并融合 @音乐。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "Asset://asset_image_xxx", "alias": "人物" },
    { "media_type": "video", "role": "reference_video", "url": "Asset://asset_video_xxx", "alias": "动作" },
    { "media_type": "audio", "role": "reference_audio", "url": "Asset://asset_audio_xxx", "alias": "音乐" }
  ],
  "duration": 8,
  "aspect_ratio": "16:9",
  "size": "720p",
  "generate_audio": true
}

音频参考必须和图片或视频参考一起提交，不能单独提交音频输入。每个素材的 role 应明确填写，alias 在同一请求内应唯一。

参数

字段	类型	说明
model	string	必填，seedance-2.5-cl。
prompt	string	视频描述，可用 @alias 指代参考素材。
references[]	array	图片、视频或音频参考；条目使用 media_type、role、url 和可选 alias。
content[]	array	官方兼容文本与媒体数组；与 references[] 二选一，完整示例见上文。
duration	integer	4 - 30 秒。
aspect_ratio / ratio	string	画面比例；具体可用值以模型能力为准。
size / resolution	string	480p、720p 或 1080p。
generate_audio	boolean	是否生成音轨，省略时默认 true。
watermark	boolean	是否添加水印。
callback_url	string	可选回调地址。

查询结果

创建响应只代表任务已提交。请保存 id 或 task_id，并继续查询任务状态；只有 status=succeeded 时才读取最终视频地址。失败时请读取 error，不要把失败响应中的 URL 当作成品。

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

相关页面

• Seedance-2 视频总览
• 视频模型矩阵
• 创建视频任务
• 上传与素材概览