MoonApiX Docs

Appearance

Grok 视频 ​

方法与路径 ​

http
POST /v1/videos
GET /v1/videos/{task_id}

请求头：

http
Authorization: Bearer <MOONAPIX_API_KEY>
Content-Type: application/json

Grok Video 1.5 ​

模型输入模式时长比例字段清晰度字段参考图字段
grok-video-1.5-pro文生视频、首帧图生视频、多参考图视频固定 10 秒aspect_ratiosize，常用 720P、1080P单图用 input_reference；多参考图用 reference_image_urls 或 content[]
grok-video-1.5-max文生视频、首帧图生视频、多参考图视频固定 15 秒aspect_ratiosize，常用 720P、1080P单图用 input_reference；多参考图用 reference_image_urls 或 content[]

MoonApiX 兼容层与实际处理口径 ​

MoonApiX 对客户开放统一的 JSON / 兼容字段写法，但 Grok Video 1.5 在实际处理时主要关注以下字段组合：

  • model
  • prompt
  • seconds
  • aspect_ratio
  • size
  • input_reference（单图）或等价归一后的多参考图输入

如果你提交的是 reference_image_urls、image、image_url 或 content[]，MoonApiX 会先在兼容层做归一化，再按 Grok 视频所需字段组合处理。

Grok Video 1.5 请求示例 ​

文生视频：

bash
curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-1.5-pro",
    "prompt": "雨夜城市街头，霓虹灯反射在地面，镜头缓慢推进，电影感。",
    "seconds": "10",
    "aspect_ratio": "16:9",
    "size": "720P"
  }'

首帧图生视频：

json
{
  "model": "grok-video-1.5-pro",
  "prompt": "保留人物服装和场景一致性，加入轻微运镜和环境光变化。",
  "input_reference": "https://example.com/first-frame.jpg",
  "seconds": "10",
  "aspect_ratio": "9:16",
  "size": "720P"
}

多参考图：

json
{
  "model": "grok-video-1.5-max",
  "prompt": "综合多张参考图的角色特征和场景质感，输出一段稳定的镜头运动视频。",
  "reference_image_urls": [
    "https://example.com/ref-1.jpg",
    "https://example.com/ref-2.jpg"
  ],
  "seconds": "15",
  "aspect_ratio": "3:2",
  "size": "1080P"
}

使用 content[] 传参考图也可以，常见写法如下：

json
{
  "model": "grok-video-1.5-pro",
  "prompt": "保持角色外观稳定，加入轻微动作和景深变化。",
  "seconds": "10",
  "aspect_ratio": "1:1",
  "size": "720P",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/ref-1.jpg"
      },
      "role": "reference_image"
    }
  ]
}

Grok Video 1.5 字段 ​

字段说明
modelGrok 视频模型名。
prompt视频描述，建议包含主体、动作、镜头、场景和风格。
secondsgrok-video-1.5-pro 建议传 10；grok-video-1.5-max 建议传 15。
aspect_ratio推荐使用 2:3、3:2、1:1、9:16、16:9。
size推荐使用 720P 或 1080P。
input_reference单张参考图或首帧图输入。
reference_image_urls多参考图输入；MoonApiX 会做兼容归一化。
content[]需要显式标注 role=reference_image 时可用。
callback_url可选。任务完成后接收 MoonApiX 回调。

提交响应 ​

提交成功后先保存 id 或 task_id：

json
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "grok-video-1.5-pro",
  "status": "submitted",
  "progress": 0,
  "created_at": 1730000000
}

查询结果 ​

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

完成后通常可以从 url、video_url 或 result_url 读取视频地址：

json
{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "status": "succeeded",
  "progress": 100,
  "model": "grok-video-1.5-pro",
  "size": "720P",
  "seconds": "10",
  "url": "https://example.com/result.mp4",
  "video_url": "https://example.com/result.mp4",
  "result_url": "https://example.com/result.mp4",
  "created_at": 1730000000,
  "completed_at": 1730000040
}

Grok Imagine 视频模型 ​

以下 Grok Imagine 视频模型仍在使用。不同模型的时长、尺寸和参考图字段不同，提交前请按表格选择字段：

模型当前字段口径说明
grok-imagine-1.0-videovideo_config.video_length、video_config.aspect_ratio、video_config.resolution、reference_imagesGrok Imagine 1.0 视频模型。
grok-imagine-video-preview、grok-imagine-video-1.5-previewseconds、size、resolution、reference_imagesGrok Imagine 1.5 preview 视频模型。
grok-imagine-1.5-video-super-720pinput_reference、sizeGrok Imagine 1.5 720p 单图视频模型。

其他 Grok 模型核对结果 ​

  • grok-imagine-image、grok-imagine-image-pro：仍使用 /v1/images/generations，图片页当前说明正确。
  • grok-imagine-* 视频模型：仍按上表字段提交，当前说明保留有效。

接入注意 ​

  • grok-video-1.5-pro / grok-video-1.5-max 当前不建议按首尾帧模式接入；不要期待 last_frame_url 在 Grok 路由里生效。
  • 单图输入优先用 input_reference；多参考图优先用 reference_image_urls 或 content[]，不要把两套参考图字段混在同一次请求里。
  • 业务代码不要只读取一个结果字段；建议按 video_url、result_url、url 的顺序兼容读取。

相关页面 ​