MoonNexAI API Docs

Appearance

Seedance 视频指南 ​

Seedance-2 提供原生、KZ 和 CL 三个独立系列。新接入先确定系列，再从该系列页面列出的公开模型名中选择；不同系列的参数和素材准备流程不要混用。

快速选择 ​

需求推荐模型说明
火山公开原生模型doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615原生系列的标准、Fast、Mini 三个模型，具体参数和素材流程见独立页面。
默认快速生成seedance-2.0-kz-fast适合高频、批量和默认快速出片。
公网 URL 或本模型线 Asset:// 图生视频 / 视频参考seedance-2.0-cl-fast 或 seedance-2.0-cl标准兼容线路，适合单图图生视频和带参考视频的任务；视频参考建议先创建本模型线素材 ID，素材 ID 不要和 seedance-2.0-kz 系列跨线混用。
轻量 480P / 720P CL 工作流seedance-2.0-cl-mini参数体系与 CL 系列一致，支持文生视频、图生视频、视频参考和本模型线 Asset:// 素材引用，时长 4 - 15 秒。
更高画质或 1080Pseedance-2.0-kz适合更高质量和 1080P 场景。

通用素材引用 ​

新接入复杂素材优先使用 references[]，每个条目用 media_type 标明图片、视频、音频或音乐，用 role 标明用途，用 alias 给素材取可在提示词中引用的别名。images[] / videos[] / audios[] 和 content[] 继续作为兼容写法。

json
{
  "model": "seedance-2.0-kz-fast",
  "prompt": "让人物自然转身，镜头稳定推进。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/reference.png",
      "alias": "hero"
    }
  ],
  "duration": 14,
  "ratio": "16:9"
}

素材上传 ​

  • 已有稳定公网 URL 时，直接在视频请求里传 URL。
  • 联调本地文件时，可用 /v1/assets/uploads 的 mode=oss 创建临时测试 URL；正式业务请使用客户自有存储的稳定公网 URL。
  • 只有模型页面明确支持素材引用时，才使用 Asset://asset_xxx。
  • 对 seedance-2.0-cl / seedance-2.0-cl-fast / seedance-2.0-cl-mini，图片参考可以直接传稳定公网 URL；视频参考建议先用 /v1/assets/uploads 创建 type=video、role=reference_video 的 Asset://asset_xxx，再传给 video_url 或 references[].url。
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"
  }'
json
{
  "model": "seedance-2.0-cl",
  "prompt": "保留参考视频中的动作，把上衣图案替换为参考图片风格。",
  "video_url": "Asset://asset_video_xxx",
  "image_url": "https://example.com/reference-shirt.png",
  "duration": 5
}

相关页面 ​