打开链接? 目标地址
继续前往
开发文档

Grok 1.5 视频:单图驱动与多图参考

接入预告 · 待上线。以下为计划兼容的请求格式。请在 UiUiAPI 为你的令牌开放对应模型、并标明支持本页接口后再调用;实际上线的模型名、限制和价格以平台为准。

两个 Grok 1.5 型号的命名相近,参考图要求和时长选项不同。

选择型号

型号 参考图 时长 输出清晰度
grok-imagine-video-1.5 必填一张,使用 image 1–15 秒 480p、720p、1080p
grok-imagine-1.5-video 可省略;多张使用 images 6、10、12、16、20 秒 480p、720p

提交任务

先在终端设置环境变量 UIUI_API_KEY。以下示例使用主站的 JSON 接口。含 example.com 的素材地址需要换成服务器能读取的 HTTPS 文件地址。

curl -sS --fail-with-body 'https://api.uiuihao.com/v1/videos' \
  -H "Authorization: Bearer $UIUI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "image": "https://example.com/ref.jpg",
  "prompt": "保留照片构图,让吊灯轻轻摆动。",
  "seconds": 6,
  "aspect_ratio": "9:16",
  "resolution": "720p"
}'

多图与尺寸

{
  "model": "grok-imagine-1.5-video",
  "prompt": "连接两个场景,保持服装一致。",
  "images": [
    "https://example.com/ref.jpg",
    "https://example.com/street.jpg"
  ],
  "seconds": 10,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}

aspect_ratio 可按型号选 16:9、9:16、1:1、2:3 或 3:2。若传 size,应与比例一致。支持 data URI 的输入可以把本地图片编码为 data:image/jpeg;base64,… 再作为 image 发送。

查询进度与保存视频

从提交响应读取 id 或 task_id。在终端设置 TASK_ID 为返回的原值,再查询状态。

curl -sS --fail-with-body "https://api.uiuihao.com/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $UIUI_API_KEY"

排队或生成中时隔几秒再查询;收到 429 时按 Retry-After 延长间隔。遇到 failed / FAILURE 时停止轮询并查看错误。成功状态如 completed / SUCCESS 出现后,可用同一任务 ID 保存成片。

curl -fSL "https://api.uiuihao.com/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $UIUI_API_KEY" -o output.mp4

若返回临时成片链接,及时保存。向外部存储下载时无需附带 UiUiAPI 密钥。超时先查任务记录,避免重复生成。