Grok 视频：固定 6 秒与可选时长

本站目前提供三个公开 Grok 视频型号。名称带 -6s 的两个型号与 grok-video-1.5 使用不同的参考图字段和时长规则。 核对日期：2026-10-29。

型号对照

model	时长	分辨率 / 比例	分组	核对时报价
grok-imagine-video-6s	固定 6 秒	720p；16:9 或 9:16	视频分组	¤0.08 / 次
grok-imagine-video-1.5-6s	固定 6 秒	720p；16:9 或 9:16	视频分组	¤0.10 / 次
grok-video-1.5	接受 4、6、8、10、12、15 秒离散值	720p；建议 16:9 或 9:16	default、视频分组	¤0.85 / 次

以上当前为按次计费，不是 0.08/0.10/0.85 每秒。旧的 grok-video-1.0 不在当前目录中，不作为新建任务示例。价格与可用性以当前模型广场和 Key 权限为准。

固定 6 秒：文生视频

下载 grok-6s-text.json，发送至 POST /v1/videos：

json

{
  "model": "grok-imagine-video-6s",
  "prompt": "清晨湖面上的蓝色纸船缓缓漂动，柔和光线，镜头平稳推进",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

如选择 grok-imagine-video-1.5-6s，只更换 model，其他本节参数规则保持一致。

字段	类型	默认 / 限制
model	string，必填	上表两个 -6s 型号之一
prompt	string，必填	1–7000 个 Unicode 字符，不允许空白
seconds	string 或 integer	默认且仅接受 6 或 "6"
resolution	string	默认 720p；接受 720p / 720P
aspect_ratio	string	默认 16:9；仅 16:9、9:16
ratio	string，可选	aspect_ratio 的别名，不要重复传冲突值
size	string，可选	1280x720 或 720x1280；也接受对应比例字符串
input_reference	string 或文件，可选	单张首帧图，与 reference_images 二选一
reference_images	object[]，可选	1–7 张参考图；每项使用 {"url":"..."}
metadata	object，可选	仅 resolution、aspect_ratio、ratio、seconds、duration

没有统一的音频参考、参考视频、首尾帧对、seed、watermark、generate_audio 开关；不要随意加入这些字段。

固定 6 秒：单首帧

JSON 可填写 HTTPS 图片 URL，也可使用完整的 data:image/png;base64,...、data:image/jpeg;base64,... 或 data:image/webp;base64,...。Data URL 必须包含真实完整的编码内容，不能直接把省略号发给 API。

json

{
  "model": "grok-imagine-video-1.5-6s",
  "prompt": "保持首帧中的产品外观，镜头轻轻向右移动",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "input_reference": "https://media.example.com/first-frame.png"
}

示例媒体域名必须替换为自己的真实可访问地址。上传本地文件可使用 multipart：

bash

curl --fail-with-body --max-time 120 \
  https://openpix.cc/v1/videos \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -F 'model=grok-imagine-video-1.5-6s' \
  -F 'prompt=保持首帧主体一致，镜头缓慢向前' \
  -F 'seconds=6' \
  -F 'resolution=720p' \
  -F 'aspect_ratio=16:9' \
  -F 'input_reference=@reference.png;type=image/png'

PNG、JPEG、WebP 文件单张最多 20 MiB。让 curl 自动生成 Content-Type 与 boundary；不要手工增加 JSON Content-Type。

固定 6 秒：多参考图

json

{
  "model": "grok-imagine-video-6s",
  "prompt": "结合人物造型和场景参考，生成自然连贯的镜头",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "reference_images": [
    {"url": "https://media.example.com/character.png"},
    {"url": "https://media.example.com/scene.png"}
  ]
}

reference_images 为 1–7 项对象数组，不是字符串数组。每项只能放 url。多张本地文件可重复使用 -F 'reference_images[]=@文件路径'，不能同时填写文本 reference_images 和上传的 reference_images[] 文件。

参考图模式与首帧模式二选一：不要同时传 input_reference 与 reference_images。已上传文件和 Data URL 的参考图累计最多 60 MiB，单张最多 20 MiB；Base64 传输体积更大，仍需满足入口整体请求体限制。HTTPS 链接图片也应控制大小，不能将 URL 写法当成绕过素材限制的方式。

grok-video-1.5：可选时长

下载 grok-variable-text.json：

json

{
  "model": "grok-video-1.5",
  "prompt": "清晨湖面上的蓝色纸船缓缓漂动，柔和光线，镜头平稳推进",
  "seconds": "6",
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

字段	推荐写法	说明
seconds	"6"、"8"、"10"、"12"、"15"	当前校验也接受 "4"；首次集成建议 6 秒，目标组合用实际素材确认
duration	同 seconds	兼容别名；建议只传 seconds
resolution	"720p"	此公开型号按 720p 档处理；更高 size 不能保证升级分辨率
aspect_ratio	"16:9" 或 "9:16"	显式填写避免依赖尺寸推断
image_urls	string[]	最多 7 张图片，顺序保留；推荐只使用这一套字段
prompt	非空 string	描述运动、镜头和需要保持的主体

5 秒、7 秒等任意整数不能使用。未传时长的旧行为默认为 4 秒，因此建议总是显式填写。

参考图请求片段：

json

{
  "image_urls": [
    "https://media.example.com/character.png",
    "https://media.example.com/background.png"
  ]
}

也存在 images、reference_images、image、input_reference 等兼容别名，它们可能被合并计数，不要同时填写多个别名。不要把 -6s 型号的 reference_images 对象数组与本型号的 image_urls 字符串数组混淆。

JSON 可使用 HTTPS 图片或已支持的完整图片 Data URL；multipart 使用 input_reference 文件字段。接口最多接受 7 张参考图片，不代表全部“多图 × 时长 × 内容”组合都已实际生成验证。首次接入从文生视频或单图开始，再验证自己的多图请求。

查询、结果与费用

统一保存本站返回的 id，使用 GET /v1/videos/{id} 查询，再用 GET /v1/videos/{id}/content 下载。不同历史任务可能携带不同兼容字段，不应依赖结果直链固定在某个 metadata 字段。

按次报价只对应当前型号的一次任务。不要把 response 中的 seconds 再乘一次按次价。若任务超时或结果传输异常，保留原 ID 查询和下载，不要自动重复 POST。详见任务生命周期。