MoonNexAI API Docs

Appearance

模型与能力 ​

MoonNexAI 按能力提供 OpenAI-compatible、多模态、视频、音乐、数字人和素材接口。公开文档只描述用户可直接调用的模型 ID、任务接口和素材接口。

能力说明主要入口
OpenAI-compatible对话、Responses、Messages、Embeddings 和音频基础能力/v1/*
图片图片生成、编辑、变体和异步图片任务/v1/images/*
视频视频生成、查询、取消、内容读取、延展和 remix/v1/videos、/v1/videos/{task_id}
数字人形象素材、音色素材、语音和数字人视频合成/v1/assets/uploads、/v1/tasks
音乐音乐生成、歌词生成、音效、编辑和后处理/v1/tasks
素材资源上传、登记、分组和复用素材/v1/assets/*、/v1/asset-groups/*

任务型模型 ​

任务型模型通常通过 POST /v1/tasks 或对应能力入口提交。提交后保存 task_id，再使用 GET /v1/tasks/{task_id} 或能力专用查询接口读取状态。

本次新增模型入口 ​

  • 图片异步模型：seedream-5.0、seedream-4.5、wan2.7-image-pro，入口为 /v1/images/generations/async，查询为 /v1/images/tasks/{task_id}。
  • 视频模型：happyhorse-1.0、wan2.7，入口为 /v1/videos，查询为 /v1/tasks/{task_id} 或 /v1/videos/{task_id}。
  • Seedance-2 CL 轻量模型：seedance-2.0-cl-mini，入口为 /v1/videos，支持 480P / 720P、4 - 15 秒、文生视频、图生视频、视频参考和本模型线 Asset:// 素材引用。
  • Seedance-2 原生系列：doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615，入口为 /v1/videos，支持 4 - 15 秒以及图片、视频、音频参考；标准版支持到 1080P，Fast 和 Mini 支持 480P / 720P。
  • Moon-2 WC 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，入口为 /v1/videos。七个型号均支持真人；基础、B 和 B Fast 最多支持 9 图 + 3 视频 + 3 音频和总计 12 个素材，其中 B / B Fast 不支持纯文本；F 支持纯文本、4 到 15 秒，最多 9 图 + 3 视频 + 3 音频，总计不超过 12 个素材且音频必须带图片；C 支持纯文本和最多 9 图，不支持视频/音频；D / E 支持纯文本或最多 4 图 + 3 视频 + 1 音频，禁止纯音频。
  • Moon-2 GL 720P 系列：moon-2.0-gl-a-720p、moon-2.0-gl-a-720p-fast，入口为 /v1/videos。两个型号均支持纯文本、人物参考及最多 4 图 + 3 视频 + 1 音频，支持 4 到 15 秒和 16:9、9:16、1:1 比例，音频需搭配图片或视频。
  • Moon-2 LD 系列：当前公开型号为 moon-2.0-ld-a，入口为 /v1/videos，支持 720P、5 至 15 秒、最多 9 张图片、3 个视频、3 个音频和总计 15 个参考素材。
  • Moon-2 AM 720P Fast：moon-2.0-am-720p-fast，入口为 /v1/videos，支持 720P、文生视频、图生视频、图片/视频/音频参考和 references[] 公网 URL 组合。
  • Moon-2 IL 720P：moon-2.0-il-720p，入口为 /v1/videos，支持 720P、4 到 14 秒、最多 9 张图片、3 个视频、3 个音频和总计 12 个参考素材，按秒计费。
  • Grok 视频模型：grok-video-1.5 和 grok-image-video，入口为 /v1/videos，查询为 /v1/videos/{task_id}；其中 grok-video-1.5 当前接口行为要求 1 张参考图，grok-image-video 支持最多 5 张参考图。

结果读取 ​

读取结果前必须先检查 status。成功后读取响应中的 URL 或结构化结果；失败时读取 fail_reason、error.code 和 error.message。