MoonApiX Docs

Appearance

seedance-2.0-dj 系列 ​

seedance-2.0-dj 系列是 MoonApiX Seedance-2 的 720P 按秒视频模型线。当前公开型号为 seedance-2.0-dj-fast，适合文生视频、单图图生视频和多参考图视频。后续 seedance-2.0-dj-* 公开型号也会统一放在本页维护。

创建任务时，统一使用 POST /v1/videos，素材统一放在 references[] 中。查询结果时，请先检查任务 status 和 error，只有 succeeded 后再读取结果 URL。

当前配置 ​

项目说明
当前型号seedance-2.0-dj-fast
推荐入口POST /v1/videos
查询入口GET /v1/videos/{task_id} 或 GET /v1/tasks/{task_id}
推荐素材字段references[]
分辨率720P
时长5、10、15 秒
比例16:9、9:16
计费方式按秒计费

能力边界 ​

能力支持情况说明
文生视频支持可以只传 prompt、duration、ratio 和 resolution。
图片参考支持使用 references[]，最多 10 张图片。
首帧图生视频支持在 references[] 中把图片 role 标为 first_frame。
多参考图支持在 references[] 中使用多个 reference_image 条目。
视频参考不支持不要传 reference_video、videos[] 或视频 URL 字段。
独立音频不支持不要传 reference_audio、audios[]、audio_url 或独立音频素材。

文生视频示例 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-dj-fast",
    "prompt": "A clean cinematic product video, soft studio light, slow camera push-in.",
    "duration": 10,
    "ratio": "16:9",
    "resolution": "720P",
    "callback_url": "https://example.com/moonapix/webhook"
  }'

参考图示例 ​

新接入请优先使用 references[]。alias 可以给素材取名，方便在提示词中用 @alias 指代图片。

json
{
  "model": "seedance-2.0-dj-fast",
  "prompt": "Use @product as the main subject, create a short vertical ad with a smooth handheld camera move.",
  "duration": 10,
  "ratio": "9:16",
  "resolution": "720P",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.png",
      "alias": "product"
    }
  ]
}

多图示例 ​

references[] 最多放 10 张图片。图片可以是公网 URL 或 MoonApiX 托管 URL；是否可以直接使用 Asset://asset_xxx，以素材接口返回状态和当前模型页说明为准。

json
{
  "model": "seedance-2.0-dj-fast",
  "prompt": "Combine @hero and @product into a bright lifestyle commercial, keep both subjects recognizable.",
  "duration": 15,
  "ratio": "16:9",
  "resolution": "720P",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/hero.jpg",
      "alias": "hero"
    },
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.jpg",
      "alias": "product"
    }
  ]
}

常用字段 ​

字段类型说明
modelstring固定填写 seedance-2.0-dj-fast。
promptstring视频描述。建议包含主体、动作、镜头、场景和风格。
durationinteger仅支持 5、10、15。不要传 8、12 等非枚举值。
ratio / aspect_ratiostring支持 16:9、9:16。
resolutionstring当前使用 720P。
references[]array推荐素材数组。当前只支持图片素材，最多 10 张。
references[].media_typestring当前填写 image。
references[].rolestring常见值为 reference_image、first_frame。
references[].urlstring图片公网 URL 或 MoonApiX 托管 URL。
references[].aliasstring可选。素材别名，例如 hero、product。
callback_urlstring可选。任务完成后接收回调的 HTTPS 地址。

查询结果 ​

提交成功后保存响应中的 id 或 task_id：

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

客户端应先判断 status：

状态客户端处理
submitted / pending / running继续轮询或等待 Webhook。
succeeded读取 url、video_url、output.url 或 metadata.url。
failed读取 error，并保留 request_id / trace_id 便于排查。
cancelled任务已取消，不读取结果 URL。

结果 URL ​

seedance-2.0-dj-fast 成功后返回 MoonApiX 托管媒体 URL。客户端应保存查询响应里实际返回的完整 URL，不要假设固定域名，也不要把结果 URL 拆分后自行拼接。

不同视频模型的结果 URL 策略可能不同：有些模型会返回 MoonApiX 托管媒体 URL，有些模型会返回可公网访问的媒体直链。MoonApiX 不会仅因为模型使用同一类兼容协议就强制转存所有结果。业务系统只需要在 status=succeeded 后按字段优先级读取并保存完整 URL。

计费说明 ​

seedance-2.0-dj-fast 按秒计费。页面展示价格、分组倍率和实际扣费以 MoonApiX 控制台价格页、模型列表接口和扣费记录为准；当前默认展示价为 0.12 CNY / 秒。

常见问题 ​

duration 可以传 5 到 15 之间的任意秒数吗？ ​

不可以。当前只支持 5、10、15 三个枚举值。

可以传视频或音频参考吗？ ​

不可以。seedance-2.0-dj-fast 当前只支持图片参考，不支持参考视频和独立音频。

最多可以传几张参考图？ ​

最多 10 张。超过 10 张时请先在业务侧筛选关键图片，再提交任务。

相关页面 ​