Euno AI

简体中文

English

简体中文

English

Appearance

Grok Imagine 视频生成 ​

Grok Imagine（grok-imagine-video 系列）是 xAI 的视频生成模型，平台以 OpenAI Video 风格统一接口 /v1/videos 提供，平台自动完成与 xAI 官方字段之间的参数翻译（如 Sora 风格 size → xAI 官方 resolution），两种风格均可直接使用。

模型说明

  • grok-imagine-video：标准版，支持文生视频 / 图生视频 / 视频参考编辑；
  • grok-imagine-video-1.5：最新版，画质与一致性更强，原生音频输出，支持 1080p；
  • grok-imagine-video-1.5-preview：1.5 预览版，与正式版同价。

端点 ​

  • 创建任务：POST $URL/v1/videos
  • 查询任务：GET $URL/v1/videos/{task_id}
  • 取回成片：GET $URL/v1/videos/{task_id}/content

支持模型 ​

模型名称定位分辨率输入
grok-imagine-video标准版480p / 720p文本 / 图片 / 视频
grok-imagine-video-1.5最新版（原生音频）480p / 720p / 1080p文本 / 图片 / 音频
grok-imagine-video-1.5-preview1.5 预览版（与正式版同价）480p / 720p / 1080p文本 / 图片 / 音频

主要参数 ​

字段类型必填说明
modelstring是上表中的模型名
promptstring是视频描述（图生视频时可省略）
secondsstring | number否视频时长（秒），1–15，默认 8；亦可用 duration（整数），两者等价
resolutionstring否xAI 官方档位：480p / 720p（默认） / 1080p
sizestring否Sora/OpenAI 风格：480p / 1280x720 / 720x1280 等均可，平台自动翻译为 resolution 并移除该字段（与 resolution 同时传入时以 resolution 为准）
image_urlstring否图生视频：参考图 URL 或 base64 data URL；平台同时兼容 Sora 风格 image / input_reference 字段，会自动归一为 image_url
reference_imagesarray否多图参考：[{"url": "..."}] 数组，body 顶层，上限 7 张；prompt 中可用 <IMAGE_1>…<IMAGE_N> 标签引用对应图片。三个模型均支持；单图也可用 image_url，两者可并存
aspect_ratiostring否16:9 / 9:16 / 1:1 等（xAI 官方参数，原样透传）

时长与分辨率约束

  • 时长超出 1–15 秒会被平台直接拒绝（400），不会产生任何计费；
  • Grok Imagine 视频不支持 4K：size 传 2k / 4k 会被拦截，超大像素尺寸自动落到 1080p。

请求示例 ​

文生视频（Sora 风格参数） ​

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "一盏孔明灯缓缓升上夜空，镜头缓慢拉远",
    "seconds": "4",
    "size": "480p"
  }'
python
from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="$URL/v1")
video = client.videos.generate(
    model="grok-imagine-video-1.5",
    prompt="一盏孔明灯缓缓升上夜空，镜头缓慢拉远",
    seconds="4",
    size="480p",
)
print(video.id)

图生视频（image_url） ​

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "让画面动起来",
    "seconds": "4",
    "resolution": "720p",
    "image_url": "https://example.com/photo.jpg"
  }'

多图参考生视频（reference_images） ​

多张参考图放在 body 顶层 reference_images 数组（上限 7 张），prompt 中用 <IMAGE_N> 标签引用对应图片：

bash
curl $URL/v1/videos \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "<IMAGE_1> 中的角色缓缓转头，<IMAGE_2> 中的场景作为背景，镜头缓慢推近",
    "seconds": "4",
    "resolution": "720p",
    "reference_images": [
      { "url": "https://example.com/character.jpg" },
      { "url": "https://example.com/scene.jpg" }
    ]
  }'

说明

  • reference_images 在 grok-imagine-video / grok-imagine-video-1.5 / grok-imagine-video-1.5-preview 三个模型上用法完全一致，仅换 model 名；
  • Sora 风格统一入口 images / input_reference 传多张图时，平台会自动将第 2 张起并入 reference_images，计费按实际张数；
  • 每张参考图按上表「输入图」单价另计（提交时冻结）。

查询与取片 ​

bash
# 查询任务状态：queued / processing / completed / failed
curl $URL/v1/videos/{task_id} \
  -H "Authorization: Bearer $YOUR_API_KEY"

# 下载成片（completed 后）
curl -o video.mp4 $URL/v1/videos/{task_id}/content \
  -H "Authorization: Bearer $YOUR_API_KEY"

计费 ​

按 输出秒数 × 分辨率 计费，输入参考图/视频按官方 media input 另计（提交时冻结，与 xAI 官方价一致）：

模型480p720p1080p输入图输入视频
grok-imagine-video$0.05/秒$0.07/秒—$0.002/张$0.01/秒
grok-imagine-video-1.5$0.08/秒$0.14/秒$0.25/秒$0.01/张—
grok-imagine-video-1.5-preview$0.08/秒$0.14/秒$0.25/秒$0.01/张—

计费示例：grok-imagine-video-1.5 生成 4 秒 480p = 4 × $0.08 = $0.32；带 3 张参考图再加 3 × $0.01 = $0.03，合计 $0.35。

注意事项 ​

  • 成片有时效：上游对已生成视频有保存期限，过期后取片会返回 410 Gone，请在任务完成后及时下载；
  • 缺省时长为 8 秒（xAI 官方默认），未传 seconds/duration 时按 8 秒计费；
  • 任务状态：queued → processing（进度 0–99%）→ completed / failed；
  • 分组倍率另计，以上单价为基准货币价。

© 2026 Euno AI 版权所有