视频系列概览

视频系列用于创建文生视频、图生视频、参考素材视频、视频扩展和 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. 需要 MoonApiX 托管 URL 或素材引用时，先阅读 上传与素材概览。
4. 调用 创建视频任务，保存返回的 id 或 task_id。
5. 调用 查询视频任务，或等待 Webhook。

模型目录

目录	适合场景
Sora 视频	文生视频、参考图视频、角色复用和 Remix。
Veo 视频	高质量文生视频、图生视频和参考素材视频。
Seedance-2 视频	先按 seedance-2.0-kz 系列、seedance-2.0-cl 系列、seedance-2.0-cl-mini、seedance-2.0-ld 系列、seedance-2.0-dj 系列、seedance-2.0-qm 系列、seedance-2.0-wc 系列和 seedance-2.0-me 选型号。
HappyHorse / Wan 视频模型	happyhorse-1.0 和 wan2.7 文生视频、图生视频和参考素材视频。
Grok 视频	Grok Imagine / Grok Video 系列的文生视频和图生视频。
Qwen 视频	其他视频模型下的视频生成和视频扩展。

标准请求

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_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/moonapix/webhook"
  }'

推荐阅读顺序

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