MoonNexAI API Docs

简体中文

English

简体中文

English

外观

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

seedance-2.0-cl-b-fast 和 seedance-2.0-cl-b-mini 是 MoonNexAI 的独立 Seedance-2 CL-B 公共模型线。两者使用独立的公开模型名和能力校验，不要把 CL-B 模型名替换成 seedance-2.0-cl、seedance-2.0-cl-fast 或 seedance-2.0-cl-mini。

入口与模型名 ​

项目说明
推荐入口POST /v1/videos
官方形状兼容入口POST /api/v3/contents/generations/tasks
查询入口GET /v1/videos/{task_id}、GET /v1/tasks/{task_id} 或兼容路径对应的任务查询接口
快速模型seedance-2.0-cl-b-fast
轻量模型seedance-2.0-cl-b-mini

兼容入口保留火山引擎官方请求形状，但 model 必须填写上表中的 MoonNexAI 公共模型名。不要在客户端请求中填写非公开模型名或服务端标识。

官方参数兼容能力 ​

CL-B 两个型号按火山引擎 Seedance 2.0 官方参数契约提供能力。客户端可以继续使用官方请求字段和嵌套结构；MoonNexAI 只要求将 model 填写为对应的 MoonNexAI 公共模型名。

能力seedance-2.0-cl-b-fastseedance-2.0-cl-b-mini
官方请求形状支持 content[]、ratio、resolution、duration、generate_audio、watermark、seed、callback_url 等官方字段同左
文生视频按官方模型能力支持按官方模型能力支持
图片参考按官方模型能力支持按官方模型能力支持
视频参考按官方模型能力支持按官方模型能力支持
音频参考按官方模型能力支持按官方模型能力支持
比例、分辨率、时长与官方 Fast 型号能力矩阵一致与官方 Mini 型号能力矩阵一致
音频生成开关generate_audio 与官方语义一致generate_audio 与官方语义一致

参数是否可用、取值范围和素材数量限制均以所选型号的官方能力矩阵为准；不要把 Fast 型号的限制套用到 Mini，或反向套用。

请求参数分栏 ​

MoonNexAI 统一通用视频参数 ​

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

字段类型说明
modelstringseedance-2.0-cl-b-fast 或 seedance-2.0-cl-b-mini。
promptstring视频描述，可用 @alias 引用素材。
references[]array通用图片、视频和音频素材数组。
durationnumber按所选官方 Fast / Mini 型号能力填写。
aspect_ratiostring画面比例。
sizestring输出分辨率。
generate_audioboolean音频生成开关。
watermarkboolean水印开关。
callback_urlstring可选回调地址。

火山官方兼容参数 ​

兼容入口为 POST /api/v3/contents/generations/tasks，使用官方 content[]、ratio 和 resolution。同一请求不要同时提交两套素材字段。

字段类型说明
modelstring仍填写 CL-B 的 MoonNexAI 公共模型名。
content[]array官方文本、图片、视频和音频条目。
durationnumber官方时长字段。
ratiostring官方比例字段。
resolutionstring官方分辨率字段。
generate_audioboolean官方音频开关。
watermarkboolean官方水印开关。
seedinteger官方随机种子。
callback_urlstring官方回调地址。

官方兼容请求 ​

为保持官方提示词中的素材绑定语义，媒体条目应显式填写 role 和唯一的 alias。alias 不带 @，在提示词中使用 @Image1、@Video1 或 @Audio1 引用。

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-cl-b-fast",
    "content": [
      {
        "type": "text",
        "text": "让主体自然移动，镜头平稳推进。"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://example.com/reference.png"
        },
        "alias": "Image1"
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://example.com/motion.mp4"
        },
        "alias": "Video1"
      },
      {
        "type": "audio_url",
        "role": "reference_audio",
        "audio_url": {
          "url": "https://example.com/music.mp3"
        },
        "alias": "Audio1"
      }
    ],
    "duration": 4,
    "ratio": "16:9",
    "resolution": "720P",
    "generate_audio": true,
    "watermark": false
  }'

将 model 改为 seedance-2.0-cl-b-mini 即可选择轻量型号。content[] 与 references[] 是两种输入表达方式；同一请求不要同时提交两者。

多图 + 多视频 + 多音频 ​

CL-B 按所选官方 Fast / Mini 型号的能力矩阵接受多个参考素材。下面示例使用 2 张图片、2 个视频和 2 段音频；需要更多素材时仍必须遵守对应型号的单类和总数上限。

json
{
  "model": "seedance-2.0-cl-b-fast",
  "content": [
    { "type": "text", "text": "结合 @Image1 和 @Image2 的主体外观，参考 @Video1 与 @Video2 的动作节奏，并将 @Audio1、@Audio2 作为声音参考。" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/subject-1.png" }, "alias": "Image1" },
    { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/subject-2.png" }, "alias": "Image2" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-1.mp4" }, "alias": "Video1" },
    { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/motion-2.mp4" }, "alias": "Video2" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/music-1.mp3" }, "alias": "Audio1" },
    { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/music-2.mp3" }, "alias": "Audio2" }
  ],
  "duration": 4,
  "ratio": "16:9",
  "resolution": "720P",
  "generate_audio": true
}

content[].alias 在同一请求内必须唯一；也可以将同样的六个条目转换为 references[]，但不要在一个请求中同时提交 content 和 references。

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

json
{
  "model": "seedance-2.0-cl-b-fast",
  "prompt": "结合 @Image1 和 @Image2 的主体外观，参考 @Video1 与 @Video2 的动作节奏，并将 @Audio1、@Audio2 作为声音参考。",
  "references": [
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/subject-1.png", "alias": "Image1" },
    { "media_type": "image", "role": "reference_image", "url": "https://example.com/subject-2.png", "alias": "Image2" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-1.mp4", "alias": "Video1" },
    { "media_type": "video", "role": "reference_video", "url": "https://example.com/motion-2.mp4", "alias": "Video2" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/music-1.mp3", "alias": "Audio1" },
    { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/music-2.mp3", "alias": "Audio2" }
  ],
  "duration": 4,
  "aspect_ratio": "16:9",
  "size": "720P",
  "generate_audio": true
}

统一入口写法 ​

需要使用 MoonNexAI 统一视频接口时，可以提交同样的媒体语义：

json
{
  "model": "seedance-2.0-cl-b-mini",
  "prompt": "让主体自然移动，镜头平稳推进。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/reference.png",
      "alias": "Image1"
    },
    {
      "media_type": "video",
      "role": "reference_video",
      "url": "https://example.com/motion.mp4",
      "alias": "Video1"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "https://example.com/music.mp3",
      "alias": "Audio1"
    }
  ],
  "duration": 4,
  "aspect_ratio": "16:9",
  "resolution": "720P",
  "generate_audio": true
}

图片、视频和音频 URL 必须是服务端可以匿名抓取的稳定公网媒体地址，且 Content-Type 与文件类型一致。上传或准备素材不会自动附加到后续任务；每次生成都必须显式传入 URL 或模型明确支持的素材引用。

计费与结果 ​

CL-B 按 Seedance-2 token 用量维度结算，具体单价和可用分组以 MoonNexAI 控制台、模型列表接口和实际计费记录为准。创建任务后请先查询 status，只有 succeeded 时才读取 url、video_url 或 output.url 等结果字段。

相关页面 ​