moon-2.0-wc 系列

moon-2.0-wc 系列是 MoonNexAI Moon-2 的 720P 视频模型线。当前公开模型包括 moon-2.0-wc-720p、moon-2.0-wc-b-720p、moon-2.0-wc-b-720p-fast、moon-2.0-wc-c-720p、moon-2.0-wc-d-720p、moon-2.0-wc-e-720p 和 moon-2.0-wc-f-720p。不同型号的参考素材上限不同，提交前请按本页的型号矩阵选择。

创建任务时，七个型号都使用 references[] 素材写法。moon-2.0-wc-c-720p、moon-2.0-wc-d-720p、moon-2.0-wc-e-720p 和 moon-2.0-wc-f-720p 是四套独立模型：C 面向最多 9 张参考图，D / E 面向 4 图 + 3 视频 + 1 音频的混合参考，F 支持最多 9 张图片、3 个视频和 3 个音频、总计不超过 12 个素材且音频必须带图片。

WC-C、WC-D、WC-E 和 WC-F 当前均已开放调用。四者的 duration 表示目标生成时长；最终成片时长可能因任务内容产生差异。业务需要严格时长时，请在任务成功后读取并校验实际媒体时长。

当前配置

项目	说明
推荐入口	`POST /v1/videos`
查询入口	`GET /v1/videos/{task_id}` 或 `GET /v1/tasks/{task_id}`
推荐素材字段	`references[]`
推荐素材来源	正式业务使用客户自有存储的稳定公网 URL；本地文件联调可用 `mode=oss` 获取临时测试 URL
输出	720P
标准型号时长	`moon-2.0-wc-720p` 支持 `4` 到 `14` 秒；兼容接受 `15` 秒并按 `14` 秒生成
C / D / E / F 时长	`moon-2.0-wc-c-720p`、`moon-2.0-wc-d-720p`、`moon-2.0-wc-e-720p`、`moon-2.0-wc-f-720p` 均接受 `4` 到 `15` 秒目标时长
C / D / E 比例	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`
计费方式	按次计费；实际价格以 MoonNexAI 控制台和计费记录为准

可用模型

模型	定位	说明
`moon-2.0-wc-720p`	标准 720P	WC 系列基础 720P 多素材模型，支持 4 到 14 秒；传入 15 秒时按 14 秒生成。
`moon-2.0-wc-b-720p`	备用 720P	支持 4 到 15 秒和 9 图 + 3 视频 + 3 音频参考，不支持纯文本。
`moon-2.0-wc-b-720p-fast`	备用 720P Fast	支持 4 到 15 秒和 9 图 + 3 视频 + 3 音频参考，不支持纯文本。
`moon-2.0-wc-c-720p`	9 图参考 720P	支持纯文本或最多 9 张参考图；不支持参考视频和音频。
`moon-2.0-wc-d-720p`	4-3-1 混合参考 720P	支持纯文本，或最多 4 张图片、3 个视频和 1 个音频；音频必须搭配至少一张图片或一个视频。
`moon-2.0-wc-e-720p`	WC-E 4-3-1 混合参考 720P	支持纯文本，或最多 4 张图片、3 个视频和 1 个音频；音频必须搭配至少一张图片或一个视频。
`moon-2.0-wc-f-720p`	WC-F 混合参考 720P	支持纯文本，或最多 9 张图片、3 个视频和 3 个音频，合计最多 12 个素材；音频必须搭配至少一张图片。

WC 模型能力矩阵

模型	纯文本	图片	视频	音频	总素材	时长	真人
`moon-2.0-wc-720p`	支持	9 张	3 个	3 个	12 个	`4`–`14` 秒；兼容 `15` 秒并按 `14` 秒生成	支持
`moon-2.0-wc-b-720p`	不支持	9 张	3 个	3 个	12 个	`4`–`15` 秒	支持
`moon-2.0-wc-b-720p-fast`	不支持	9 张	3 个	3 个	12 个	`4`–`15` 秒	支持
`moon-2.0-wc-c-720p`	支持	9 张	不支持	不支持	9 个	`4`–`15` 秒目标时长	支持
`moon-2.0-wc-d-720p`	支持	4 张	3 个	1 个	8 个	`4`–`15` 秒目标时长	支持
`moon-2.0-wc-e-720p`	支持	4 张	3 个	1 个	8 个	`4`–`15` 秒目标时长	支持
`moon-2.0-wc-f-720p`	支持	9 张	3 个	3 个	12 个	`4`–`15` 秒目标时长	支持

D / E / F 不接受只有音频的请求。D / E 使用音频时必须同时提交至少一张图片或一个视频；F 使用音频时必须同时提交至少一张图片。

素材输入边界

能力	支持情况
`references[]` 通用素材	支持
`Asset://` 素材引用	不作为当前 WC 系列输入路径；请传公网 URL
独立音频素材	不建议单独使用；请按对应型号同时提供图片或视频参考，WC-F 必须提供图片参考

七个型号的纯文本、素材数量和时长边界以“WC 模型能力矩阵”为准。

C / D / E / F 请求示例

WC-C：9 图以内或纯文本

json

{
  "model": "moon-2.0-wc-c-720p",
  "prompt": "参考 @产品 的外观，生成干净的棚拍产品广告。",
  "duration": 8,
  "ratio": "16:9",
  "resolution": "720p",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/product.png",
      "alias": "产品"
    }
  ]
}

WC-C 的第 9 张图片仍可提交；第 10 张图片、任意视频或任意音频都会被拒绝。纯文本请求可省略 references。

WC-D：4 图 + 3 视频 + 1 音频

json

{
  "model": "moon-2.0-wc-d-720p",
  "prompt": "参考图片主体与视频动作节奏，并使用 @音乐 作为背景音乐。",
  "duration": 15,
  "ratio": "9:16",
  "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": "音乐"
    }
  ]
}

WC-D 的边界是 4 张图片、3 个视频、1 个音频和总计 8 个素材。第 5 张图片、第 4 个视频、第 2 个音频以及纯音频请求都会被拒绝。纯文本请求可省略 references。

WC-E：4 图 + 3 视频 + 1 音频

json

{
  "model": "moon-2.0-wc-e-720p",
  "prompt": "保持 @主体 的外观，参考 @动作 的运动节奏，并使用 @音乐 作为背景音乐。",
  "duration": 15,
  "ratio": "9:16",
  "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": "音乐"
    }
  ]
}

WC-E 的素材边界与 WC-D 相同：最多 4 张图片、3 个视频、1 个音频和总计 8 个素材，音频必须搭配至少一张图片或一个视频。WC-E 是独立公开模型，调用时必须填写精确模型名 moon-2.0-wc-e-720p。

WC-F：纯文本或混合参考

纯文本请求可以省略 references：

json

{
  "model": "moon-2.0-wc-f-720p",
  "prompt": "一位舞者在现代舞台上完成流畅的独舞，镜头缓慢推进，灯光自然变化。",
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720p"
}

使用参考素材时，图片最多 9 张、视频最多 3 个、音频最多 3 个，并且 references[] 总数最多 12 个。音频必须搭配至少一张图片，只有视频不能满足该条件：

json

{
  "model": "moon-2.0-wc-f-720p",
  "prompt": "保持 @主体 的外观，参考 @动作 的镜头节奏，并使用 @音乐 作为背景音乐。",
  "duration": 15,
  "ratio": "9:16",
  "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": "音乐"
    }
  ]
}

WC-F 支持真人内容。音频不能单独提交，也不能只搭配视频，必须同时提供至少一张图片。上限为 9 图、3 视频、3 音频，总素材最多 12 个；一个完整边界组合是 6 图 + 3 视频 + 3 音频。第 10 张图片、第 4 个视频、第 4 个音频或超过 12 个素材的请求都会被拒绝。

准备公网 URL

WC 系列的视频、图片和音频参考建议使用 MoonNexAI 可直接下载的公网直链。为了减少第三方素材抓取失败或媒体类型误判，建议：

URL 路径保留真实文件后缀，例如 .png、.jpg、.mp4、.wav、.mp3。
URL 不依赖登录态、Cookie、额外鉴权 Header、一次性下载页或防盗链校验。
使用客户自有存储中稳定、简短、无复杂 query 的直链；mode=oss 仅作为联调本地文件的临时测试能力，不保证长期有效。
音频作为背景音乐时，在提示词中明确写“使用 @音乐作为背景音乐”，不要写成说话音色、旁白或台词参考。

本地文件转 OSS 测试 URL

bash

curl https://moonnexai.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -F "mode=oss" \
  -F "model=moon-2.0-wc-720p" \
  -F "type=image" \
  -F "file=@reference.png"

上传成功后，把返回的公网 url / public_url 填入视频任务的 references[].url。

已有公网 URL

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-wc-720p",
    "prompt": "参考 @hero 的人物，在自己的房间里跳一段可爱的舞蹈。",
    "duration": 14,
    "ratio": "9:16",
    "resolution": "720p",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "hero"
      }
    ]
  }'

创建视频任务

单图参考

bash

curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moon-2.0-wc-720p",
    "prompt": "参考 @hero 的人物，在自己的房间里跳一段可爱的舞蹈。",
    "duration": 14,
    "ratio": "9:16",
    "resolution": "720p",
    "references": [
      {
        "media_type": "image",
        "role": "reference_image",
        "url": "https://example.com/reference.png",
        "alias": "hero"
      }
    ]
  }'

多素材组合

json

{
  "model": "moon-2.0-wc-720p",
  "prompt": "让 @角色 在自己的房间里跳可爱的舞蹈，参考 @动作视频 的动作节奏，并使用 @音乐 作为背景音乐。",
  "duration": 14,
  "ratio": "9:16",
  "resolution": "720p",
  "references": [
    {
      "media_type": "image",
      "role": "character_reference",
      "url": "https://example.com/character.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": "音乐"
    }
  ]
}

完整多素材任务最多可提交 12 个参考文件。单类上限为图片最多 9 张、视频最多 3 个、音频最多 3 个；如果同时使用图片、视频和音频，请确保三类合计不超过 12 个，例如 6 图 + 3 视频 + 3 音频。alias 不要带 @，同一请求内不要把一个别名绑定到多个不同素材；提示词里用 @alias 绑定素材。

图片 + 背景音乐

json

{
  "model": "moon-2.0-wc-720p",
  "prompt": "参考 @人物 生成一段唯美人像视频。人物安静看向镜头、轻微微笑和自然摆动，不要开口讲话，不要说台词。请使用 @音乐 作为背景音乐，保留该音频的旋律、节奏和氛围。",
  "duration": 14,
  "ratio": "9:16",
  "resolution": "720p",
  "references": [
    {
      "media_type": "image",
      "role": "reference_image",
      "url": "https://example.com/person.png",
      "alias": "人物"
    },
    {
      "media_type": "audio",
      "role": "reference_audio",
      "url": "https://example.com/background-music.wav",
      "alias": "音乐"
    }
  ]
}

省略 references[].alias 时，系统按媒体类型依次生成 图片1、视频1、音频1 等内置顺序别名。提示词兼容 @图片1 和 @图片 1，视频N、音频N 同理；数字后可以直接继续正文，例如 @图片1保持团扇。为便于阅读，仍建议在别名后加空格或标点。

自定义别名不做正文拆分，必须与后续文字分隔。例如应写 @主体走到龙椅旁，不要写 @主体走到龙椅旁。别名不存在时返回 invalid_reference_alias；同一别名绑定多个不同素材时返回 duplicate_reference_alias。别名绑定只帮助模型识别提示词所指素材，不保证多个人物在成片中一定保持彼此独立；多人场景请同时明确每个人物的位置、服装、道具和动作。

常用字段

字段	类型	说明
`model`	string	填写本页“可用模型”中的任一公共模型名。
`prompt`	string	视频描述。建议写清主体、动作、场景、镜头和素材绑定。
`duration`	number/string	目标生成时长。C / D / E / F 接受 `4` 到 `15` 秒；最终媒体时长请以成功结果文件为准。其他型号见“可用模型”。
`ratio` / `aspect_ratio`	string	C / D / E 支持 `16:9`、`9:16`、`1:1`、`4:3`、`3:4`。
`resolution`	string	建议填写 `720p`。
`references`	array	推荐。通用素材引用数组，单次请求总数最多 12 个。
`references[].media_type`	string	`image`、`video`、`audio` 或 `music`。
`references[].role`	string	常见值为 `reference_image`、`character_reference`、`style_reference`、`reference_video`、`reference_audio`、`background_music`。
`references[].url`	string	公网 URL 或 MoonNexAI 托管公网 URL。
`references[].alias`	string	可选。不带 `@`，同一请求内应唯一。省略时按媒体类型自动生成 `图片N`、`视频N`、`音频N`。
`callback_url`	string	可选。任务完成后的回调地址。

查询结果

创建响应只代表任务已提交，请保存 task_id 并继续查询：

bash

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

任务成功后，建议按这个顺序读取最终视频地址：

text

data.video_url
video_url
url
result_url
output.url
metadata.url

请先判断 status 是否为 succeeded。如果任务还在 pending、submitted 或 running，继续轮询同一个 task_id。

注意事项

WC 系列当前使用公网 URL 参考素材；不要把 Asset://asset_xxx 作为 WC 任务输入。moon-2.0-wc-b-720p 和 moon-2.0-wc-b-720p-fast 也遵循同一规则。
moon-2.0-wc-720p 支持 4 到 14 秒；为兼容已有客户端，15 秒请求会按 14 秒生成。该规则不影响 WC-B 型号。
公开视频结果只返回 MoonNexAI 自有受控地址；不要自行拼接结果 URL，请直接使用接口返回的完整地址。
基础、B、B Fast 和 F 型号的 references[] 合计最多 12 个参考文件；C / D / E 使用各自的独立上限。超过对应型号上限后任务会被拒绝。
多音频或多视频组合建议先逐个确认 URL 可公开访问，再提交生成任务。
参考音频作为背景音乐时，请在提示词中明确说明“使用 @音乐作为背景音乐”；不要同时要求它作为人物说话音色或台词内容。
如果参考音频、参考视频没有被稳定识别，优先检查 URL 是否为可直接下载的公网媒体文件，且路径有真实后缀、无额外鉴权要求。
若素材安全检查失败或 URL 无法访问，请更换为客户自有存储中可匿名访问的稳定 URL；mode=oss 只能用于联调排查。

对话协议

向量

音频

模型

GPT Image

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

moon-2.0-wc 系列

当前配置

可用模型

WC 模型能力矩阵

素材输入边界

C / D / E / F 请求示例

WC-C：9 图以内或纯文本

WC-D：4 图 + 3 视频 + 1 音频

WC-E：4 图 + 3 视频 + 1 音频

WC-F：纯文本或混合参考

推荐流程

准备公网 URL

本地文件转 OSS 测试 URL

已有公网 URL

创建视频任务

单图参考

多素材组合

图片 + 背景音乐

常用字段

查询结果

注意事项

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

Moon-2 视频

moon-2.0-wc 系列 ​

当前配置 ​

可用模型 ​

WC 模型能力矩阵 ​

素材输入边界 ​

C / D / E / F 请求示例 ​

WC-C：9 图以内或纯文本 ​

WC-D：4 图 + 3 视频 + 1 音频 ​

WC-E：4 图 + 3 视频 + 1 音频 ​

WC-F：纯文本或混合参考 ​

推荐流程 ​

准备公网 URL ​

本地文件转 OSS 测试 URL ​

已有公网 URL ​

创建视频任务 ​

单图参考 ​

多素材组合 ​

图片 + 背景音乐 ​

常用字段 ​

查询结果 ​

注意事项 ​

相关页面 ​

moon-2.0-wc 系列

当前配置

可用模型

WC 模型能力矩阵

素材输入边界

C / D / E / F 请求示例

WC-C：9 图以内或纯文本

WC-D：4 图 + 3 视频 + 1 音频

WC-E：4 图 + 3 视频 + 1 音频

WC-F：纯文本或混合参考

推荐流程

准备公网 URL

本地文件转 OSS 测试 URL

已有公网 URL

创建视频任务

单图参考

多素材组合

图片 + 背景音乐

常用字段

查询结果

注意事项

相关页面