Grok Imagine Video 1.5 API 接入文档

使用 VezAPI 密钥接入 Grok Imagine Video 1.5。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

Grok Imagine Video 1.5 Preview

POST/api/v1/jobs/createTask

模型标识： grok-imagine-video-1-5-preview

参数	类型	说明与限制
`model` 必填	`string`	用于生成的模型名称。本接口必须使用 `grok-imagine-video-1-5-preview`。可选值：`"grok-imagine-video-1-5-preview"` 默认：`"grok-imagine-video-1-5-preview"`
`callBackUrl` 可选	`string`	可选的任务完成回调 URL。若提供，任务完成后系统会向该地址发送 POST 请求。
`input` 必填	`object`	生成任务的输入参数。
`input.prompt` 可选	`string`	视频生成提示词。最大长度：4096 个字符。可在提示词中使用 `@imageN` 引用 `image_urls` 中对应的图片，N 为从 1 开始的序号。例如 `@image1` 对应数组中的第一张图片。 `maxLength: 4096`
`input.image_urls` 必填	`array`	上传作为接口输入的图片文件。支持的文件类型：image/jpeg、image/png、image/webp、image/jpg。单个文件最大 20MB。支持多文件上传，最多 1 个文件。分辨率为 1080p 时仅支持 1 张。 `maxItems: 1`
`input.aspect_ratio` 可选	`string`	视频生成的宽高比。可选值：`"1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "auto"` 默认：`"auto"`
`input.resolution` 可选	`string`	视频生成的分辨率。可选值：`"480p", "720p", "1080p"` 默认：`"480p"`
`input.duration` 可选	`integer`	视频时长，单位为秒。范围：[1, 15]。默认值：8。最小值：1。最大值：15。步长：1。默认：`8` `minimum: 1` `maximum: 15`
`input.first_frame_url` 可选	`string`	首帧图。可以和 image_urls 一起传，也可以单独传。
`input.last_frame_url` 可选	`string`	末帧图。
`input.loop_url` 可选	`string`	循环图，视频开头和结尾都是这张。不能和另一张不同的首帧或末帧同时传。
`input.keyframes` 可选	`array`	中间帧，最多 4 个。每个都要带 url 和 timestamp_s（单位：秒），时间要大于 0、小于 duration，两个之间至少隔 1/3 秒。 `maxItems: 4`
`input.keyframes[].url` 必填	`string`	图片 URL。
`input.keyframes[].timestamp_s` 必填	`integer`	时间戳（单位：秒）。
`input.enable_audio` 可选	`boolean`	是否生成声音，默认 true。
`input.nsfw_checker` 可选	`boolean`	默认值为 false。可根据需要设为 false。设为 false 时，将关闭内容过滤，结果由模型直接返回。

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "grok-imagine-video-1-5-preview",
  "input": {
    "prompt": "Your prompt",
    "image_urls": [
      "https://example.com/input.png"
    ],
    "aspect_ratio": "auto",
    "resolution": "480p",
    "duration": 8
  }
}'

返回值与错误

HTTP 200

请求成功。

参数	类型	说明与限制
`code` 必填	`integer`	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。
`msg` 必填	`string`	响应消息，失败时的错误描述
`data` 必填	`object`
`data.taskId` 必填	`string`	任务 ID 可与“获取任务详细信息”端点一起使用，以查询任务状态
`data.recordId` 必填	`string`

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。