Seedance NT 系列

NT 系列提供四个独立公开模型，使用 MoonApiX API Key 创建异步视频任务。支持 MoonApiX 统一通用参数和火山官方兼容参数；兼容请求形状不代表所有官方高级功能均已开放。

模型与边界

公开模型	分辨率	目标时长
seedance-2.0-nt	720P	整数 4 - 15 秒
seedance-2.0-nt-fast	720P	整数 4 - 15 秒
seedance-2.0-nt-mini	720P	仅 4 秒
seedance-2.5-nt	720P	整数 4 - 30 秒

默认目标时长为 4 秒，不支持 duration: -1。输出文件的实际时长可能包含编码帧尾差异，应读取成功结果的媒体信息。

四个模型均已验证单张真人公网参考图、reference_image、4 秒、720P、16:9 和关闭音频的组合，成功输出为 1280×720。人物素材仍须符合内容安全要求。多图、视频参考和音频参考的具体组合与数量上限应按当前模型能力确认，不要套用其他 Seedance 系列的限制。

素材与比例

参考图模式使用 reference_image，比例可选 16:9、9:16、1:1、21:9、4:3、3:4，默认 16:9。参考图描述人物或画面内容，不要求成为输出视频的严格第一帧。

严格首帧模式使用 first_frame。seedance-2.5-nt 在该模式下保持输入首帧比例：统一参数传 aspect_ratio: "adaptive"，官方兼容参数传 ratio: "adaptive"，也可以省略比例。显式指定固定比例会被拒绝。需要固定 16:9 输出时，请使用 reference_image。

• first_frame 和 last_frame 各最多一张；尾帧必须与首帧一起提交。
• 首尾帧不能与 reference_image、reference_video 或 reference_audio 混用。
• adaptive 仅适用于 seedance-2.5-nt 的首尾帧模式。
• 音频参考必须搭配图片或视频，不能单独提交。

公网素材 URL 必须能够匿名直接获取媒体文件，在任务完成前持续有效；不要使用需要登录的页面地址。下面示例中的 example.com 地址是占位符，需替换为你有权使用的图片直链。

公网图片调用不等于素材 ID 认证。 NT 系列的素材认证创建与 Asset:// 调用尚未完成公开流程验证，当前接入示例使用公网 URL。不要复用其他模型系列的认证 ID；只有已为所选模型准备且处于 ready 的认证素材才可解析，解析失败会报错，不会降级为公网 URL。

MoonApiX 统一通用参数

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-nt",
    "prompt": "参考图中的人物自然转头，保持人物外观一致，镜头稳定。",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/person-reference.jpg"
      }
    ],
    "size": "720p",
    "aspect_ratio": "16:9",
    "duration": 4,
    "generate_audio": false,
    "watermark": false
  }'

可将 model 替换为表中的任一 NT 模型，保留同一组 4 秒参考图参数。也可使用 /v1/video/generations 创建任务。

官方兼容参数

两种协议使用相同的 MoonApiX 公开模型名和 API Key。单次请求选用一套字段，不要同时提交 content[] 和 references[]，或重复提交提示词。

统一参数	官方兼容参数
prompt	content[].type: "text" 与 text
references[].media_type: "image" 与 url	content[].type: "image_url" 与 image_url.url
references[].role	对应媒体条目的 role
size: "720p"	resolution: "720p"
aspect_ratio	ratio
duration、generate_audio、watermark	同名字段

curl https://moonapix.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-nt",
    "content": [
      {
        "type": "text",
        "text": "参考图中的人物自然转头，保持人物外观一致，镜头稳定。"
      },
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person-reference.jpg" },
        "role": "reference_image"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false,
    "watermark": false
  }'

content[] 同样可在 /v1/videos 使用。NT 接入请使用轮询；回调、取消、Remix、扩展视频及其他高级功能不在本页已验证范围内。

查询与结果 URL

创建成功仅表示任务已受理。保存返回的公开 id 或 task_id，使用同一 API Key 轮询：

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

官方兼容查询入口：

curl https://moonapix.com/api/v3/contents/generations/tasks/{task_id} \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

先检查 status 和 error：排队或运行中继续轮询，失败时处理错误；只有成功终态且没有错误，才读取 video_url、url 或兼容响应的 content.video_url。不能仅凭出现 URL 判断生成成功。

成功返回的可下载成品 URL 可以直接交给客户端。请完整保留接口返回地址及其查询参数，不要自行拼接域名、路径或删除签名；地址可能有有效期，应及时下载或转存。实际响应字段详见查询视频任务。

计费

四个模型均按百万视频生成 Token 计价，最终依据任务的 usage.total_tokens 结算；包含参考视频时使用对应的计费档位。目标时长不是固定按次价格，也不代表仅按秒收费。

创建任务可能先预扣额度，任务完成后按实际 Token 用量结算差额。出现“异步任务退款”也可能是预扣差额返还，不能仅凭退款记录判断任务失败；应同时查看任务终态和完整计费记录。提交未成功创建任务时不计费。

当前单价与账户实际适用价格以 MoonApiX 控制台 和价格说明中的价格接口为准。

相关页面

• Seedance-2 视频总览
• 视频模型矩阵
• 创建视频任务
• 查询视频任务