MoonApiX Docs

Appearance

seedance-2.0-gl 系列 ​

seedance-2.0-gl 是 MoonApiX 的 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 计费

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

能力边界 ​

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

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

创建任务 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-gl-mini",
    "prompt": "保持参考素材中的主体特征一致，生成自然的镜头运动。",
    "duration": 4,
    "aspect_ratio": "16:9",
    "resolution": "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": "音乐"
      }
    ]
  }'

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

参数说明 ​

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

素材准备 ​

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

查询与结果 ​

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

bash
curl https://moonapix.com/v1/videos/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

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

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

相关页面 ​