seedance-2.0-gl 系列

seedance-2.0-gl 是 MoonNexAI 的 Seedance-2 多素材视频模型系列。当前公开型号为标准版、快速版和轻量版，统一使用 /v1/videos 创建和查询任务。

型号选择

模型	定位	分辨率	计费方式
`seedance-2.0-gl`	标准多素材生成	`480P`、`720P`、`1080P`	按输出 tokens 计费
`seedance-2.0-gl-fast`	快速多素材生成	`480P`、`720P`	按输出 tokens 计费
`seedance-2.0-gl-mini`	轻量多素材生成	`480P`、`720P`	按输出 tokens 计费

单价、可用分组和实时能力以模型列表接口与 MoonNexAI 控制台为准。文档不固定具体金额。

能力边界

能力	支持情况
文生视频	支持
图片参考	最多 9 张
视频参考	最多 3 个
音频参考	最多 3 个；不能单独提交，需同时提供图片或视频
混合素材	最多 15 个参考素材
时长	`4` 至 `15` 秒
比例	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`21:9`、`adaptive`，以模型能力为准
真人参考	支持；素材仍需通过内容安全审核

首帧、尾帧和普通参考图属于图片素材额度。具体模型不支持某个比例或字段时，以模型列表能力为准；不要把标准版的 1080P 能力套用到 Fast 或 Mini。

请求参数分栏

MoonNexAI 统一通用视频参数

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

字段	类型	说明
`model`	string	`seedance-2.0-gl`、`seedance-2.0-gl-fast` 或 `seedance-2.0-gl-mini`。
`prompt`	string	视频描述，可用 `@alias` 引用素材。
`references[]`	array	通用图片、视频和音频素材数组。
`duration`	number	`4` 至 `15` 秒。
`aspect_ratio`	string	画面比例。
`size`	string	输出尺寸，按型号能力填写。
`generate_audio`	boolean	是否生成音频。

火山官方兼容参数

兼容入口为 POST /api/v3/contents/generations/tasks，使用官方 content[]、ratio 和 resolution；不要在一个请求中同时提交 references[] 与 content[]。

字段	类型	说明
`model`	string	仍填写 GL 系列 MoonNexAI 公共模型名。
`content[]`	array	官方文本、图片、视频和音频条目。
`duration`	number	官方时长字段。
`ratio`	string	官方比例字段。
`resolution`	string	官方分辨率字段。
`generate_audio`	boolean	官方音频生成开关。
`watermark`	boolean	官方水印开关。
`seed`	integer	官方随机种子。
`callback_url`	string	官方回调地址。

创建任务

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-gl-mini",
    "prompt": "保持参考素材中的主体特征一致，生成自然的镜头运动。",
    "duration": 4,
    "aspect_ratio": "16:9",
    "size": "720P",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/subject.png",
        "alias": "主体"
      },
      {
        "media_type": "video",
        "role": "reference_video",
        "url": "https://example.com/motion.mp4",
        "alias": "动作"
      },
      {
        "media_type": "audio",
        "role": "reference_audio",
        "url": "https://example.com/music.mp3",
        "alias": "音乐"
      }
    ]
  }'

基础示例（火山官方兼容参数）

bash

curl https://moonnexai.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-gl-mini",
    "content": [
      { "type": "text", "text": "保持参考素材中的主体特征一致，生成自然的镜头运动。" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/subject.png" }, "alias": "主体" }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "720P"
  }'

将 model 改为 seedance-2.0-gl 或 seedance-2.0-gl-fast 即可选择其他公开型号。客户自己的稳定 HTTPS 公网 URL 优先；需要复用素材时，可先通过 /v1/assets/uploads 创建当前模型可用的 Asset://asset_xxx，再把该引用放入 references[].url。

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

GL 系列支持混合参考素材。下面示例使用 2 张图片、2 个视频和 2 段音频；音频不能脱离图片或视频单独提交，实际数量仍以当前型号能力为准。

json

{
  "model": "seedance-2.0-gl",
  "prompt": "保持 @hero1 和 @hero2 的外观一致，参考 @motion1、@motion2 的镜头节奏，并融合 @music1、@music2 的声音氛围。",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "720P",
  "generate_audio": true,
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/hero-1.png", "alias": "hero1" },
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/hero-2.png", "alias": "hero2" },
    { "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/music-1.mp3", "alias": "music1" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/music-2.mp3", "alias": "music2" }
  ]
}

URL 必须是服务端可以匿名抓取的稳定公网媒体地址。Fast/Mini 型号请把 model 改为对应公开模型名，并先确认该型号支持所选分辨率。

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

json

{
  "model": "seedance-2.0-gl",
  "content": [
    { "type": "text", "text": "保持 @hero1 和 @hero2 的外观一致，参考 @motion1、@motion2 的镜头节奏，并融合 @music1、@music2 的声音氛围。" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/hero-1.png" }, "alias": "hero1" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/hero-2.png" }, "alias": "hero2" },
    { "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/music-1.mp3" }, "alias": "music1" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/music-2.mp3" }, "alias": "music2" }
  ],
  "duration": 8,
  "ratio": "16:9",
  "resolution": "720P",
  "generate_audio": true
}

参数列表

MoonNexAI 统一通用字段

字段	类型	说明
`model`	string	`seedance-2.0-gl`、`seedance-2.0-gl-fast` 或 `seedance-2.0-gl-mini`。
`prompt`	string	视频描述和素材绑定说明。提示词中的 `@alias` 对应 `references[].alias`。
`duration`	integer	`4` 至 `15` 秒。
`size`	string	目标分辨率。标准版可用 `480P`、`720P`、`1080P`；Fast/Mini 以模型列表返回的能力为准。
`aspect_ratio`	string	目标比例，以所选模型支持范围为准。
`references`	array	推荐的统一素材数组；图片最多 9 张、视频最多 3 个、音频最多 3 个，合计最多 15 个。
`references[].media_type`	string	`image`、`video`、`audio` 或 `music`。
`references[].role`	string	常用 `reference_image`、`first_frame`、`last_frame`、`reference_video`、`reference_audio`。
`references[].url`	string	客户稳定公网 URL，或当前模型已准备好的 `Asset://asset_xxx`。
`references[].alias`	string	可选别名，不带 `@`；在 `prompt` 中用 `@alias` 指代。
`generate_audio`	boolean	可选，控制是否生成音频轨；具体默认行为以模型列表能力为准。

火山官方兼容字段

字段	类型	说明
`content[]`	array	官方多模态输入数组。
`ratio`	string	官方比例字段。
`resolution`	string	官方分辨率字段。
`duration`	number	官方时长字段。
`generate_audio`	boolean	官方音频生成开关。
`watermark`	boolean	官方水印开关。
`seed`	integer	官方随机种子。
`callback_url`	string	官方回调地址。

素材准备

直接传 URL 时，地址应允许匿名下载，不依赖登录态、Cookie 或额外鉴权 Header，并保留真实文件后缀。
需要长期复用或需要模型素材 ID 时，使用 /v1/assets/uploads 的 mode=asset，并传入目标模型名；等待素材状态为 ready 且 generation_ready=true 后再生成。
multipart 上传得到的 MoonNexAI 托管 URL 仅作为可选中转，正式业务优先使用客户自有稳定公网 URL。
不同模型线的素材引用不要混用；Asset://asset_xxx 是否可用取决于创建时指定的模型和素材状态。
真人素材仍会经过内容安全审核；“支持真人参考”不代表任何真人或敏感内容都保证生成成功。

查询与结果

创建响应只表示任务已提交。保存 id 或 task_id，再查询：

bash

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

先检查 status 和 error，只有任务成功后读取结果。也可以使用标准内容入口下载：

bash

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

对话协议

向量

音频

模型

GPT Image

Gemini Nano

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-gl 系列

型号选择

能力边界

请求参数分栏

MoonNexAI 统一通用视频参数

火山官方兼容参数

创建任务

基础示例（火山官方兼容参数）

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

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

参数列表

MoonNexAI 统一通用字段

火山官方兼容字段

素材准备

查询与结果

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

seedance-2.0-gl 系列 ​

型号选择 ​

能力边界 ​

请求参数分栏 ​

MoonNexAI 统一通用视频参数 ​

火山官方兼容参数 ​

创建任务 ​

基础示例（火山官方兼容参数） ​

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

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

参数列表 ​

MoonNexAI 统一通用字段 ​

火山官方兼容字段 ​

素材准备 ​

查询与结果 ​

相关页面 ​

seedance-2.0-gl 系列

型号选择

能力边界

请求参数分栏

MoonNexAI 统一通用视频参数

火山官方兼容参数

创建任务

基础示例（火山官方兼容参数）

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

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

参数列表

MoonNexAI 统一通用字段

火山官方兼容字段

素材准备

查询与结果

相关页面