MoonApiX Docs

Appearance

Seedance 视频指南 ​

Seedance 系列视频模型统一使用 MoonApiX 当前公开模型名。新接入请从 seedance-2.0-kz-fast、seedance-2.0-kz、seedance-2.0-cl-fast、seedance-2.0-cl、seedance-2.0-cl-mini、seedance-2.0-ld-17、seedance-2.0-dj-fast、seedance-2.0-qm-720p、seedance-2.0-wc-720p 和 seedance-2.0-me 中选择。

快速选择 ​

需求推荐模型说明
默认快速生成seedance-2.0-kz-fast 或 seedance-2.0-ld-17适合高频、批量和默认快速出片；seedance-2.0-ld-17 适合按次生成、多视觉参考和轻量音频参考。
公网 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 秒。
720P 按秒、多参考图seedance-2.0-dj-fast使用 references[]，最多 10 张图片；不支持视频参考和独立音频。
720P 多图片、多视频、多音频素材引用seedance-2.0-qm-720p可先创建 Asset:// 素材，再用 references[] 提交。
720P 多图片、多视频、多音频公网 URL 组合seedance-2.0-wc-720p推荐把公网 URL 写入 references[]，按次计费；prompt 最多 1000 个字符。
更高画质或 1080Pseedance-2.0-kz适合更高质量和 1080P 场景。
720P / 1080P 高质量、参考图seedance-2.0-me不支持视频参考、480P、尾帧和独立音频。

通用素材引用 ​

新接入复杂素材优先使用 references[]，每个条目用 media_type 标明图片、视频、音频或音乐，用 role 标明用途，用 alias 给素材取可在提示词中引用的别名。images[] / videos[] / audios[] 和 content[] 继续作为兼容写法。seedance-2.0-me 使用图片输入表达首帧或参考图，不支持视频参考；参考图绑定音频请使用 content[] 参考图条目上的 reference_voice。

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

素材上传 ​

  • 已有稳定公网 URL 时，直接在视频请求里传 URL。
  • 外部 URL 可能过期时，先用 /v1/assets/uploads 的 mode=oss 创建 MoonApiX 托管 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://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"
  }'
json
{
  "model": "seedance-2.0-cl",
  "prompt": "保留参考视频中的动作，把上衣图案替换为参考图片风格。",
  "video_url": "Asset://asset_video_xxx",
  "image_url": "https://example.com/reference-shirt.png",
  "duration": 5
}

相关页面 ​