MoonApiX Docs

Appearance

Sora / Veo 视频 ​

Sora / Veo 场景适合文生视频、图生视频、视频扩展和视频 remix。MoonApiX 提供统一的视频任务接口，提交后通过任务 ID 查询结果。

sora-v3-fast 和 sora-v3-pro 不支持通过 /v1/assets/uploads mode=asset 创建模型素材 ID。图生视频或参考图场景请直接传客户自己的公网 URL；如果需要 MoonApiX 托管 URL，可以显式使用 /v1/assets/uploads mode=oss 后再传返回的 url 或 oss_url。

创建视频 ​

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"
    }
  }'

图生视频 ​

json
{
  "model": "sora-v3-fast",
  "prompt": "让产品缓慢旋转，镜头轻微推进，保持真实光照。",
  "seconds": "5",
  "reference_image_urls": [
    "https://example.com/product.png"
  ],
  "video_config": {
    "aspect_ratio": "1:1",
    "resolution_name": "720p"
  }
}

如果图片已经有稳定公网地址，不需要先上传素材。只有 URL 不稳定或希望由 MoonApiX 托管时，才使用素材接口的 mode=oss。

首尾帧可以直接传 first_frame_url 和 last_frame_url。多素材任务可以使用 content[]，并通过 role 标记 reference_image、first_frame、last_frame、reference_video 或 reference_audio。

创建角色 ​

如果你的业务需要复用角色或主体，可以使用角色创建接口：

bash
curl https://moonapix.com/sora/v1/characters \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "brand-host",
    "source_url": "https://example.com/character.mp4",
    "seconds": 5
  }'

Remix ​

bash
curl https://moonapix.com/v1/videos/video_xxx/remix \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-v3-fast",
    "prompt": "保持原主体，改成清晨自然光，镜头更稳定。"
  }'

查询任务 ​

bash
curl https://moonapix.com/v1/videos/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

完成后读取 output[].url、output.url、url、video_url、result_url 或 metadata.url。