更新日志

2026-09-21

• 补充 seedance-2.0-sg 标准版 1080P / 4K 两张真人参考图实测：asset 模式、16:9、4 秒、关闭生成音轨，两档均成功并通过下载与完整解码。实测尺寸为 1920×1080、3840×2160，文件时长均约 4.04 秒；该记录不扩大到其他型号或素材组合。
• 修复 SG 4K 任务查询响应遗漏 resolution 的问题，成功任务保留 resolution: "4k"；同步 1080P / 4K 响应示例、分辨率标签与 SG 状态的 OpenAPI 定义。
• 修复 seedance-2.0-sg 图片搭配音频、未提供参考视频时部分请求被拒绝的问题，客户端可继续使用原有官方兼容参数。
• 补充官方兼容 content[] 的 6 张图片 + 1 段音频示例。该组合以 480p / 16:9 / 10 秒、生成音频开启完成真实生成，MP4 下载和完整解码通过；验证结论不扩大到其他型号或全部素材规格。
• 补充请求规格与成品媒体信息的区别，并同步 OpenAPI 示例。既有参数定义与参考素材数量上限保持不变。

2026-09-09

• 新增 SG 四型号独立文档、模型矩阵与 OpenAPI 示例，包含两套参数的 4 秒、2 图 + 1 音频 + 1 视频参考生成；标准版支持 1080P / 4K，2.5 支持 1080P。
• 补充 SG 单张参考图角色、输出 Token 结算、预扣差额返还和成功媒体 URL 直接使用说明。
• 新增 seedance-2.0-nt、seedance-2.0-nt-fast、seedance-2.0-nt-mini、seedance-2.5-nt 独立文档、导航、模型矩阵和 OpenAPI 示例。
• 补充 720P、各型号时长范围、4 秒单张真人公网参考图的统一参数与官方兼容参数示例，以及 usage.total_tokens 结算和预扣差额说明。
• 明确 2.5 严格首尾帧保持输入比例、成功结果 URL 的使用方式，以及 NT 素材认证 ID 尚未完成公开流程验证的边界。

2026-09-07

• 新增 seedance-2.5-cl 对外模型文档、模型矩阵、模型列表和 OpenAPI 示例。
• 补充该模型的 4 - 30 秒、480P / 720P / 1080P、多素材参考和 Asset:// 认证素材说明。
• 明确认证素材引用解析失败时直接返回错误，不会静默降级为公网 URL。

2026-09-05

• 补充 Seedance SZ 官方兼容回调说明：callback_url 支持 queued、running 和终态 JSON 回调，回调 ID 使用公共任务 ID。
• 明确回调接收端应按 status / error 做幂等处理和结果判断；成功结果 URL 可能是临时签名媒体地址，应及时下载或转存。
• 同步 SZ 模型页、Webhook 指南和官方路径说明，保持 content[]、callback_url 与任务查询示例一致。
• 为原生、KZ、CL、CL-B、GL 和 SZ 系列补充统一的多图 + 多视频 + 多音频调用示例；各型号差异继续由能力配置校验。

2026-09-04

• 新增 Seedance-2 CL-B 公开模型线：seedance-2.0-cl-b-fast、seedance-2.0-cl-b-mini。
• 补充两型号在 /api/v3/contents/generations/tasks 使用官方 content[] 形状的兼容说明，参数和能力边界按火山官方 Seedance 2.0 Fast / Mini 契约执行。
• 补充 CL-B 媒体条目的 role / alias 使用约定，并同步模型矩阵、Seedance 指南和 OpenAPI 示例。

2026-09-03

• 补充 Seedance SZ 官方形状参数兼容说明：seedance-2.0-sz、seedance-2.0-sz-fast、seedance-2.0-sz-mini 和 seedance-2.5-sz 均可在 /v1/videos 使用 content[]、ratio、resolution、duration、generate_audio 等字段，并按各自能力校验。
• 补充兼容路径 /api/v3/contents/generations/tasks 的请求、查询、列表和取消说明；该路径使用官方模型命名空间，与 seedance-2.0-sz* 公共模型名分开。
• 补充 Asset:// 认证后的图片、音频、视频混合参考示例，以及 content / references、duration / frames 等冲突规则。

2026-09-02

• 新增 Moon-2 AC 系列公开模型文档：moon-2.0-ac-* 和 moon-2.5-ac-*，补充各型号的分辨率、时长、参考素材边界和按次/按秒计费维度；具体金额以价格接口和控制台为准。
• 新增 Moon-2.5 GL 系列公开模型：moon-2.5-gl-a，统一使用 /v1/videos 和 references[]。
• 支持 480P / 720P、4 到 30 秒、六种比例以及最多 30 张图片、10 个视频、10 个音频，参考素材合计最多 50 个；音频参考需搭配图片或视频。
• 该模型按秒计费，实际价格以 MoonApiX 控制台、价格接口和计费记录为准。
• 图片异步文档补充能力边界：异步请求只路由到当前模型和分组已验证的原生异步能力；没有可用异步能力时，在任务创建和计费前返回失败。
• Gemini 图片异步页面继续使用统一的 /v1/images/generations/async、任务查询和内容接口；尺寸、比例、分辨率和单次生成数量以当前 API Key 与模型能力为准。

2026-08-30

• 新增 Seedance SZ 公开系列：seedance-2.0-sz、seedance-2.0-sz-fast、seedance-2.0-sz-mini、seedance-2.5-sz。
• 四个型号统一使用 /v1/videos 和 references[]，支持图片、视频和音频参考；单视频参考能力已验证通过。
• SZ 系列按 Seedance 官方 Token 用量维度计费，包含视频参考素材时按官方视频输入计费维度处理；实际价格以模型列表、控制台和计费记录为准。

2026-08-22

• 新增 Moon-2 ME 公开系列：moon-2.0-me-a-720p、moon-2.0-me-b-720p、moon-2.0-me-a-fast。
• 三个型号统一使用 /v1/videos 和 references[]，支持 720P、5 / 10 / 15 秒及五种常用比例；A / A Fast 支持最多 9 张图片，B 支持最多 9 图 + 3 视频 + 3 音频，合计最多 15 个参考素材。
• ME 系列按次计费，实际价格以 MoonApiX 控制台、模型列表、价格接口和计费记录为准。

2026-08-18

• 新增 Seedance-2 GL 公开系列：seedance-2.0-gl、seedance-2.0-gl-fast、seedance-2.0-gl-mini。
• 三个型号统一使用 /v1/videos 和 references[]，支持 4 至 15 秒、最多 9 张图片、3 个视频、3 个音频，参考素材合计最多 15 个；支持真人参考，但仍执行内容安全审核。
• GL 系列可直接使用客户自己的稳定 HTTPS 公网 URL；需要复用素材时，可通过 /v1/assets/uploads 创建当前模型可用的 Asset://asset_xxx。MoonApiX 托管 URL 只是本地文件上传的可选中转。
• 标准版支持 480P、720P、1080P，Fast 和 Mini 支持 480P、720P；三者按输出 tokens 计费。实际单价、可用分组和实时能力以 MoonApiX 控制台和模型列表接口为准。

2026-07-30

• 新增 moon-2.0-ld-b：能力与 moon-2.0-ld-a 相同，支持 720P、5 至 15 秒、最多 9 张图片、3 个视频、3 个音频，参考素材合计最多 15 个。
• moon-2.0-ld-b 按次计费；实际价格以 MoonApiX 控制台、价格接口和计费记录为准。

2026-07-26

• moon-2.0-ld-a 已在公开模型列表、价格接口和文档导航中启用，支持 720P、5 至 15 秒以及最多 9 张图片、3 个视频、3 个音频，参考素材合计最多 15 个。
• 视频任务查询现在会直接返回已经转存到 MoonApiX 媒体存储的安全地址。media.windfimusic.com 是由 MoonApiX 管理的官方转存媒体域名；客户端必须原样保存和使用包含签名查询参数的完整 URL。

2026-07-23

• MoonApiX OSS 测试上传和素材认证/准备调整为免费，后续生成任务仍按对应模型计费。
• 明确 MoonApiX OSS 仅供联调测试，不承诺文件长期保存、URL 长期有效、持续可用性或长期存储服务等级；正式业务和长期使用应由客户自行提供可匿名公网访问的稳定素材 URL。

2026-07-22

• 视频参考素材省略 references[].alias 时，会按媒体类型自动生成 图片N、视频N、音频N 顺序别名。
• 内置顺序别名兼容 @图片1保持...、@图片 1保持... 这类数字后紧邻正文的写法；视频N、音频N 同理。自定义别名仍需与后续正文分隔。
• 补充 invalid_reference_alias 与 duplicate_reference_alias 的排查说明；alias 字段不带 @，同一请求内应保持唯一。

2026-07-21

• moon-2.0-wc-f-720p 最终素材合同确认为最多 9 张图片、3 个视频和 3 个音频，references[] 合计不超过 12 个素材；音频必须搭配至少一张图片。
• WC-F 继续支持纯文本、真人内容、720P 和 4 到 15 秒。6 图 + 3 视频 + 3 音频 请求已通过平台素材校验并进入任务队列，但该次任务未生成成片，因此不能据此宣称满素材组合已稳定生成成功。

2026-07-20

• seedance-2.0-cl、seedance-2.0-cl-fast 和 seedance-2.0-cl-mini 新增 generate_audio 音频开关说明；省略时默认开启，显式传 false 可关闭生成音频。
• OpenAPI 同步 generate_audio 默认值，并保留 generateAudio 兼容字段说明。
• moon-2.0-wc-f-720p 的参考素材能力调整为最多 9 张图片和 3 个音频，合计最多 12 个素材；不再支持参考视频。
• WC-F 继续支持纯文本、真人内容、720P 和 4 到 15 秒；音频必须搭配至少一张图片。

2026-07-19

• 新增 moon-2.0-wc-f-720p：支持纯文本、720P、4 到 15 秒以及真人内容。
• WC-F 单次最多支持 9 张图片和 3 个音频，references[] 合计最多 12 个素材；不支持参考视频，音频必须搭配图片。
• WC-F 按次计费，实际价格以 MoonApiX 控制台和计费记录为准。
• 新增 Moon-2 GL 720P 系列：moon-2.0-gl-a-720p 和 moon-2.0-gl-a-720p-fast，均支持纯文本、人物参考、4 到 15 秒及 16:9、9:16、1:1 比例。
• GL 系列单次最多支持 4 张图片、3 个视频和 1 个音频，合计最多 8 个参考素材；音频必须搭配图片或视频，按次价格以控制台和价格接口为准。
• 新增 moon-2.0-wc-e-720p：支持纯文本、720P、4 到 15 秒目标时长以及真人内容。
• WC-E 支持最多 4 张图片、3 个视频和 1 个音频，合计最多 8 个参考素材；音频必须搭配图片或视频。
• WC-E 按次计费，当前价格以 MoonApiX 控制台、价格接口和实际计费记录为准。

2026-07-17

• moon-2.0-wc-c-720p 和 moon-2.0-wc-d-720p 已正式可用，均支持纯文本、720P 和 4 到 15 秒目标时长。
• WC-C 支持最多 9 张参考图，不支持视频和音频；WC-D 支持最多 4 张图片、3 个视频和 1 个音频，音频必须搭配图片或视频。
• 视频任务查询和内容下载统一返回 MoonApiX 自有受控结果地址；客户只需使用接口返回的完整地址。

2026-07-16

• 修复 GPT Image 异步 URL 编辑稳定性，单图 URL 和多图 URL 数组均可按异步任务流程提交和查询。
• 补充异步编辑 quality 可选字段语义：省略时使用模型默认行为，显式值以所选模型能力为准。
• 补充图片内容安全失败处理说明：任务失败时读取 error.message，调整图片或提示词后创建新任务。

2026-06-03

• 同步 MoonApiX 视频网关、客户资产和任务链文档：
  • 视频指南补充客户公网 URL、二进制文件、MoonApiX 托管 URL 和模型素材 ID 的输入边界。
  • 素材指南补充 /v1/assets/uploads 的 mode=oss|asset|both 行为，以及上传与素材准备的计费边界。
  • 异步任务指南补充 trace_id、request_id 和 task_chain。
  • 视频模型场景补充部分视频模型的素材资产限制。
  • OpenAPI 示例和 schema 同步 trace、task_chain、资产状态和上传 mode 字段。
• 导出并对齐原有接口文档，当前 OpenAPI 已覆盖导出文件中的全部 80 个接口操作。
• 新增接口目录页面，按能力列出 84 个 MoonApiX 文档接口操作。
• 新增 OpenAI-compatible、图片和 Midjourney、Web 和 Gemini-compatible 能力指南。
• 新增接入检查清单、异步任务和常见问题页面。
• 增强 SDK 示例和 API Key 安全说明。
• 新增接口目录覆盖检查，确保接口目录和 OpenAPI 保持一致。
• 接口目录改为从 OpenAPI 自动生成，减少后续维护偏差。
• 新增 OpenAPI 覆盖检查，防止后续误删接口路径。
• 扩展视频生成、素材资源、数字人、音乐 / Suno 能力指南，补充用户调用流程和示例。
• API Reference 扩展到素材、数字人、音乐任务等 26 个接口路径。
• 优化模型、计费和 SDK 示例页面，补充异步任务、素材上传和音乐任务示例。
• MoonApiX API Docs 第一版上线。
• 新增快速开始、鉴权、模型、计费、错误码、Webhook、SDK 示例和 API Reference。
• 新增 OpenAPI JSON 入口：/openapi/moonapix.openapi.json。
• 新增 llms.txt 和 sitemap.xml，方便搜索引擎和 AI 助手读取公开文档。