MoonNexAI API Docs

Appearance

seedance-2.0 原生系列 ​

这一系列包含三个独立公开模型，统一通过 POST /v1/videos 创建任务：

模型定位分辨率时长
doubao-seedance-2-0-260128标准版，适合高质量和 1080P 场景480P、720P、1080P4 - 15 秒
doubao-seedance-2-0-fast-260128快速版，适合高频生成480P、720P4 - 15 秒
doubao-seedance-2-0-mini-260615轻量版，适合批量生成480P、720P4 - 15 秒

三个模型都支持文生视频，以及图片、视频、音频参考。标准版与快速版适合更完整的多模态创作；Mini 使用相同的公共请求结构，输出仅支持 480P 和 720P。

基础请求 ​

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "prompt": "清晨海边，镜头平稳向前推进，浪花自然拍打礁石。",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

创建成功后保存 task_id 或 id，再调用 GET /v1/videos/{task_id} 查询。只有任务状态为 succeeded 时才读取最终视频地址。

使用参考素材 ​

新接入建议使用 references[]，为每个素材显式提供媒体类型和角色：

json
{
  "model": "doubao-seedance-2-0-mini-260615",
  "prompt": "让 @product 在摄影棚转台上缓慢旋转，保持产品外观一致。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.png",
      "alias": "product"
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9",
  "generate_audio": false
}

图片、视频和音频可以使用匿名可访问的稳定公网直链。视频和音频参考应满足目标模型的时长、格式和文件大小要求。

创建可复用素材 ​

普通图片、视频和音频参考素材可以直接调用 POST /v1/assets/uploads 创建，不需要活体认证。推荐使用 mode=asset，并填写实际生成时要使用的模型：

bash
curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "mode": "asset",
    "type": "image",
    "purpose": "reference_image",
    "role": "reference_image",
    "url": "https://example.com/reference.png"
  }'

创建后查询素材详情。只有同时满足以下条件时才用于生成：

text
generation_ready = true
preparation_status = ready

创建视频任务时仍要显式传入返回的 Asset://asset_xxx：

json
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "保持 @hero 的外观和服装一致，让人物自然转身。",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "Asset://asset_xxx",
      "alias": "hero"
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "ratio": "16:9"
}

普通参考素材与私域真人人像资产不是同一流程。普通媒体素材不要求活体认证；需要绑定特定真人身份、长期复用真人形象的私域资产属于受限能力，需要单独完成授权与身份认证，不能用普通素材上传替代。

素材准备结果按模型隔离。请按生成请求实际使用的原生模型创建或确认素材，不要把其他模型准备的素材直接混用。

常用字段 ​

字段说明
model填写本页三个公开模型 ID 之一。
prompt视频描述，可通过 @alias 引用素材。
references[]推荐的图片、视频和音频参考数组。
content[]兼容的多模态输入数组。
resolution480p、720p；标准版还支持 1080p。
ratio / aspect_ratio画面比例，例如 16:9、9:16、1:1。
duration4 - 15 秒。
generate_audio是否生成同步音频；显式 false 会保留关闭状态。
watermark是否添加水印；显式 false 会保留关闭状态。
seed可选随机种子。
camera_fixed可选，是否固定镜头。

计费 ​

三个模型均按输出 token 结算，并区分是否包含视频输入。不同分辨率、模型版本和输入类型的当前价格以 MoonNexAI 控制台、价格接口和实际结算记录为准，本文档不固定展示金额。

相关页面 ​