Seedance SG 系列

SG 系列提供四个公开模型，支持 MoonNexAI 通用视频参数与火山官方兼容参数。两种入口都使用 MoonNexAI API Key，model 始终填写下表中的公开模型名。

模型与能力

公开模型	分辨率	整数时长	图片 / 视频 / 音频配置上限
`seedance-2.0-sg-mini`	`480P`、`720P`	`4` - `15` 秒	`9` / `3` / `3`，合计 `15`
`seedance-2.0-sg`	`480P`、`720P`、`1080P`、`4K`	`4` - `15` 秒	`9` / `3` / `3`，合计 `15`
`seedance-2.0-sg-fast`	`480P`、`720P`	`4` - `15` 秒	`9` / `3` / `3`，合计 `15`
`seedance-2.5-sg`	`480P`、`720P`、`1080P`	`4` - `30` 秒	`30` / `10` / `10`，合计 `50`

配置允许 duration=-1 自动选择时长；需要确定目标时长时请传整数秒数。比例支持 16:9、9:16、1:1、4:3、3:4、21:9，adaptive 的适用范围取决于生成模式。当前账号可用型号和能力以模型接口与控制台为准。

四个模型均已验证 720P、4 秒、单张 reference_image 的参考图模式；历史验证还覆盖了此前开放分辨率的 2 张图片 + 1 段音频 + 1 个视频混合参考。标准版的 1080P 和 4K 两图参考实测见下表。数量上限、自动时长和其他时长不等于均已逐项实测。

seedance-2.0-sg 另已验证官方兼容 content[] 的 6 张图片 + 1 段 MP3 音频，不含参考视频：请求 480p、16:9、10 秒、generate_audio=true，任务成功并返回含音轨的 MP4，下载和完整解码通过。该结果只验证本组合，不代表各型号、素材数量上限或所有音频规格均已验证。

标准版 1080P / 4K 实测

2026-09-21，seedance-2.0-sg 通过 POST /v1/videos 完成两档真实生成。两次均使用 2 张真人照片、role=reference_image、image_source_mode=asset、aspect_ratio=16:9、duration=4、generate_audio=false，不含参考视频或音频。

请求分辨率	成功响应 `resolution`	本次 MP4 实际尺寸	本次文件时长
`1080P`	`1080p`	`1920×1080`	约 `4.04` 秒
`4K`	`4k`	`3840×2160`	约 `4.04` 秒

两份成片均通过下载与完整解码检查。表中尺寸和时长为本次观测结果，不是所有任务的固定输出保证；本组验证不代表 Fast、Mini 或其他素材组合支持相同规格。

参考模式与素材

图片使用 role=reference_image，视频使用 reference_video，音频使用 reference_audio。只有一张参考图时，也必须保留 reference_image；不要改成 first_frame。提示词中的 @图片1 等标记用于描述素材，不能代替结构化 role。

音频必须搭配图片或视频，不能单独提交；已有图片时，无需为了使用音频再添加参考视频。
首帧 / 尾帧使用独立模式，不能与多模态参考混用；尾帧必须搭配首帧。需要固定输出比例的参考图请求请使用 reference_image。
素材 URL 使用可匿名下载的 HTTPS 媒体直链，在任务完成前持续有效；不能是登录页面或预览网页。图片、音频和视频仍需满足内容安全及媒体规格要求。
公网图片 URL 可以直接提交，由服务完成所需的素材准备，无需另外提交认证编号。
已有 MoonNexAI Asset:// 引用必须属于当前账号且适用于目标模型。待准备、失败或不匹配的认证绑定应先处理；不要复用其他模型的认证编号。下列已验证流程使用公网 URL，独立创建认证素材的操作见上传与素材。

图片素材模式

SG 请求包含图片且未传 image_source_mode 时，MoonNexAI 默认使用 asset。该模式会准备图片素材后再提交，推荐用于真人照片或其他可能触发图片隐私审核的内容。

`image_source_mode`	行为	适用场景
`asset`	由服务准备图片素材后提交。	默认值；真人、人物或需要更稳定素材处理的图片。
`direct_url`	直接使用请求中的公网图片 URL。	仅在你明确需要直链模式并确认图片可被目标服务接受时使用。真人图片可能被隐私审核拒绝。

image_source_mode 作用于本次请求中的全部图片，不能在同一任务中为不同图片混用两种模式。已由 SG 素材准备流程创建的形象素材可传 avatar_asset_id 或 avatar_asset_ids；未显式传 image_source_mode 时，这两种字段也会使用 asset。

MoonNexAI 通用参数

推荐入口为 POST /v1/videos。以下是 2 图 + 1 音频 + 1 视频、1080P、4 秒示例；example.com 地址为占位符，需替换为你有权使用的真实素材直链。

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-sg",
    "prompt": "保持 @图片1 与 @图片2 的主体外观，参考 @视频1 的镜头运动，结合 @音频1 的声音氛围。",
    "image_source_mode": "asset",
    "references": [
      { "media_type": "image", "role": "reference_image", "url": "https://example.com/reference-1.png" },
      { "media_type": "image", "role": "reference_image", "url": "https://example.com/reference-2.png" },
      { "media_type": "audio", "role": "reference_audio", "url": "https://example.com/reference-audio.wav" },
      { "media_type": "video", "role": "reference_video", "url": "https://example.com/reference-video.mp4" }
    ],
    "size": "1080p",
    "aspect_ratio": "16:9",
    "duration": 4,
    "generate_audio": true
  }'

单图参考时，仅保留第一张图片条目，将提示词改为“参考 @图片1，保持主体外观，镜头平稳推进。”，保留 role=reference_image。选择 SG 2.0 Fast 或 Mini 时，将 model 改为对应公开名，并将 size 改为 480p 或 720p；标准版还可使用 1080p 或 4K。选择 2.5 时可使用 480p、720p 或 1080p。

官方兼容参数

兼容入口为 POST /api/v3/contents/generations/tasks；POST /v1/videos 也接受同一套官方兼容请求体。单次请求选用一套表达方式，避免同时提交 references[] 与 content[] 或重复提示词。

MoonNexAI 通用字段	官方兼容字段	说明
`model`	`model`	均填写 SG 公开模型名
`prompt`	`content[]` 的 `type=text` 条目	文本提示词
`references[]`	`content[]` 的媒体条目	显式保留参考角色
`size`	`resolution`	按型号选择分辨率
`aspect_ratio`	`ratio`	输出比例
`duration`	`duration`	整数秒数，或支持时使用 `-1`
`generate_audio`	`generate_audio`	布尔值；显式 `false` 关闭生成音轨

下面与通用参数示例使用相同素材和目标规格：

bash

curl https://moonnexai.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-sg",
    "content": [
      { "type": "text", "text": "保持 @图片1 与 @图片2 的主体外观，参考 @视频1 的镜头运动，结合 @音频1 的声音氛围。" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-1.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-2.png" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/reference-audio.wav" } },
      { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://example.com/reference-video.mp4" } }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": true
  }'

官方兼容表示请求字段和路径兼容，不代表所有高级参数、编辑或扩展模式均已验证。常规参考生成按上述示例传参即可。

6 张图片 + 1 段音频，无参考视频

以下示例保留已验证请求的媒体数量、角色和目标规格，提示词与素材地址为演示占位内容。将 7 个 example.com 地址替换为你有权使用、可匿名下载的真实媒体直链。图片按同类媒体在 content[] 中的顺序对应 @图片1 至 @图片6，音频对应 @音频1。

bash

curl https://moonnexai.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-sg",
    "content": [
      { "type": "text", "text": "以 @图片1 与 @图片6 为角色参考，保留 @图片2、@图片3、@图片5 的物体特征，参考 @图片4 的环境与光照。让 @图片6 的角色使用 @音频1 的声音特征说话，镜头平稳自然。" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-1.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-2.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-3.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-4.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-5.png" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://example.com/reference-6.png" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/reference-audio.mp3" } }
    ],
    "duration": 10,
    "execution_expires_after": 3600,
    "generate_audio": true,
    "ratio": "16:9",
    "resolution": "480p",
    "watermark": false
  }'

提示词中的声音引用用于描述生成意图，不能作为音色或台词完全一致的保证。generate_audio=true 表示请求生成音轨；实际声音内容以成片为准。

请求规格与成品规格

resolution、ratio 和 duration 指定目标规格，任务响应中的这些字段不能替代对成品文件的检查。上述组合请求 480p / 16:9 / 10 秒，实测 MP4 为 864×496 / 10.08 秒，包含 H.264 视频和 AAC 音轨。该像素尺寸和时长是本次观测结果，不是固定输出尺寸；需要严格像素宽高、比例或时长时，请下载后读取媒体信息并按业务要求处理。

查询与结果 URL

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

bash

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

官方兼容查询使用 GET /api/v3/contents/generations/tasks/{task_id}。先检查 status 和 error，排队或运行中继续轮询，失败时处理错误。只有成功终态且无错误时才读取 video_url、url 或官方兼容响应的 content.video_url；不能仅凭 URL 存在判断成功。状态与响应格式详见查询视频任务。

成功结果中的可直接下载媒体 URL 会原样返回，可直接交给客户端使用。请完整保留地址和查询参数，不拼接域名、不删除签名；地址可能有有效期，应及时下载或保存。若响应返回 MoonNexAI 内容下载入口，则按接口要求携带 MoonNexAI API Key；访问外部媒体直链时不要发送该 Key。

SG 的 GET /v1/videos/{task_id} 响应使用 queued、in_progress、completed 或 failed 表示任务状态。下面是标准版 4K 成功响应的部分字段，任务 ID 和媒体地址均为占位示例：

json

{
  "id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-sg",
  "status": "completed",
  "resolution": "4k",
  "duration": 4,
  "url": "https://example.com/result.mp4"
}

标准版 1080P 成功任务对应返回 resolution: "1080p"；4K 返回 "4k"。分辨率标签会规范为小写，字段仅在任务提供有效分辨率时出现，不能据此判断任务已成功。响应的 duration 单位为秒；如需精确的像素尺寸或文件时长，请读取下载文件的媒体信息。

计费与错误

SG 系列按百万输出 Token 计价，最终按 usage.completion_tokens 结算。计费档位区分型号、分辨率，以及是否输入参考视频；generate_audio 开关不等于“是否输入参考视频”。本系列采用官方原价口径，账户实际适用单价请读取控制台与价格接口，文档不固定金额。

提交时可能先预扣，完成后根据实际用量补扣或退还差额。“异步任务退款”也可能是成功任务的预扣差额返还，应结合任务状态、消耗和退款记录查看净扣费。提交失败未创建任务不计费；创建后的失败结算以任务完整计费记录为准。

参数或素材失败时，请读取安全错误说明及可用的 code、param，并保留 MoonNexAI 请求 ID 供排障。参考图被按首帧处理时，先检查图片是否明确传入 reference_image，以及是否混用了首尾帧角色。提交失败与已经创建任务后的失败需分别处理，避免重复创建导致额外消耗。

对话协议

向量

音频

模型

GPT Image

Gemini Nano

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

Seedance SG 系列

模型与能力

标准版 1080P / 4K 实测

参考模式与素材

图片素材模式

MoonNexAI 通用参数

官方兼容参数

6 张图片 + 1 段音频，无参考视频

请求规格与成品规格

查询与结果 URL

计费与错误

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

Seedance SG 系列 ​

模型与能力 ​

标准版 1080P / 4K 实测 ​

参考模式与素材 ​

图片素材模式 ​

MoonNexAI 通用参数 ​

官方兼容参数 ​

6 张图片 + 1 段音频，无参考视频 ​

请求规格与成品规格 ​

查询与结果 URL ​

计费与错误 ​

相关页面 ​

Seedance SG 系列

模型与能力

标准版 1080P / 4K 实测

参考模式与素材

图片素材模式

MoonNexAI 通用参数

官方兼容参数

6 张图片 + 1 段音频，无参考视频

请求规格与成品规格

查询与结果 URL

计费与错误

相关页面