MoonApiX Docs

Appearance

Sora 视频概览 ​

Sora 视频适合文生视频、参考图视频、角色复用和 Remix 场景。MoonApiX 使用统一的视频任务流程：提交任务后返回任务 ID，再通过查询接口或 Webhook 获取结果。

当前模型 ​

  • sora-v3-fast
  • sora-v3-pro

能力差异 ​

模型推荐场景时长分辨率比例素材引用
sora-v3-fast快速文生视频、图生视频、参考素材视频和 Remix。5、10 秒720P、1080P16:9、9:16、1:1支持公网 URL 和 MoonApiX 托管 URL；不支持 mode=asset。
sora-v3-pro更高质量的视频生成、参考素材视频和 Remix。5、10 秒720P、1080P16:9、9:16、1:1支持公网 URL 和 MoonApiX 托管 URL；不支持 mode=asset。

当前接口行为 ​

项目当前行为
创建任务使用 POST /v1/videos。
查询任务使用 GET /v1/tasks/{task_id} 或 GET /v1/videos/{task_id}。
素材输入优先直接传公网图片 URL；需要 MoonApiX 托管 URL 时使用上传接口的 mode=oss。
素材 IDsora-v3-fast、sora-v3-pro 不支持 mode=asset。

接口路径 ​

方法路径用途
POST/v1/videos创建 Sora 视频任务。
GET/v1/tasks/{task_id}查询任务中心状态。
GET/v1/videos/{task_id}查询视频任务结果。

常用字段 ​

字段说明
prompt视频描述，建议写清主体、动作、镜头和风格。
seconds / duration视频时长。
video_config.aspect_ratio / aspect_ratio / ratio视频比例。
video_config.resolution_name / resolution分辨率。
image / image_url单张首帧或参考图。
reference_image_url / reference_image_urls一张或多张参考图。
first_frame_url / last_frame_url首帧和尾帧。
video / video_url参考视频或 Remix 相关视频输入。
content[]多媒体内容数组，适合组合图片、视频或音频参考。

请求示例 ​

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-v3-fast",
    "prompt": "A cinematic city street at night, slow camera movement, realistic lighting.",
    "seconds": "5",
    "video_config": {
      "aspect_ratio": "16:9",
      "resolution_name": "720p"
    }
  }'

任务处理 ​

阶段处理方式
提交成功保存 id 或 task_id、模型名、prompt 和素材 URL。
生成中轮询查询接口，或等待回调通知。
完成读取视频 URL，并保存完整查询结果。
失败保存错误信息和原始请求体，便于重试。

相关页面 ​