MoonNexAI API Docs

Appearance

视频系列概览 ​

视频系列用于创建文生视频、图生视频、参考素材视频、视频扩展和 Remix。视频任务通常是异步任务：提交后返回任务 ID，再通过查询接口或 Webhook 获取最终结果。

Matrix视频模型矩阵按模型、输入素材、时长、比例和查询方式选择接入口。POST创建视频任务提交文生视频、图生视频和参考素材视频任务。GET查询视频任务读取状态、结果 URL、失败信息和排障字段。Uploads上传与素材确认何时直接传 URL，何时需要托管素材或素材引用。

路由清单 ​

方法路径用途
POST/v1/videos推荐的视频任务创建入口。
POST/v1/video/generations兼容视频任务创建入口。
GET/v1/tasks/{task_id}推荐的统一任务查询入口。
GET/v1/videos/{task_id}兼容视频任务查询入口。
GET/v1/videos/{task_id}/content获取视频内容或下载地址。
POST/v1/videos/{video_id}/remix视频 Remix。
POST/v1/videos/extend视频延展。
POST/sora/v1/characters创建视频角色。

基本流程 ​

  1. 查看 视频模型矩阵，确认模型支持的输入、比例和时长。
  2. 如果已有稳定公网素材 URL，优先直接在生成请求中传 URL。
  3. 需要 MoonNexAI 托管 URL 或素材引用时，先阅读 上传与素材概览。
  4. 调用 创建视频任务，保存返回的 id 或 task_id。
  5. 调用 查询视频任务，或等待 Webhook。

模型目录 ​

目录适合场景
Sora 视频文生视频、参考图视频、角色复用和 Remix。
Veo 视频高质量文生视频、图生视频和参考素材视频。
Seedance-2 视频原生、KZ、CL 三个独立系列，分别使用各自的公开模型名、参数和素材流程。
Moon-2 视频DJ、WC、GL、LD、AM、IL 系列，覆盖按秒生成和多素材按次生成。
HappyHorse / Wan 视频模型happyhorse-1.0 和 wan2.7 文生视频、图生视频和参考素材视频。
Grok 视频grok-video-1.5 单图视频，以及 grok-image-video 多参考图视频。
Qwen 视频其他视频模型下的视频生成和视频扩展。

标准请求 ​

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-kz-fast",
    "prompt": "A cinematic close-up of a glass perfume bottle on a reflective table.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "callback_url": "https://example.com/moonnexai/webhook"
  }'

推荐阅读顺序 ​

  1. 视频模型矩阵
  2. 创建视频任务
  3. 查询视频任务
  4. 视频生成
  5. 任务管理概览