获取 API Key 获取 API
文档

Grok Imagine 1.5 视频生成

- 异步处理模式,返回任务ID用于后续查询

  • 高质量AI视频生成,支持文生视频、图生视频
  • 灵活的比例与质量选择,满足不同创作需求
信息

模型名兼容提示:本接口同时兼容别名 grok-imagine-1.5-video-ext,它等价于 grok-imagine-1.5-video-openveer,两者可互换使用、效果一致。

请求示例

# model 可填 "grok-imagine-1.5-video-openveer",也兼容别名 "grok-imagine-1.5-video-ext"
curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.5-video-openveer",
    "prompt": "一只狗在海滩上奔跑,阳光明媚,慢镜头",
    "size": "16:9",
    "duration": 6,
    "resolution": "720p"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "task_id": "task_01JNXXXXXXXXXXXXXXXXXX",
      "status": "submitted"
    }
  ]
}

认证

Authorization string

所有接口均需要使用 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

请求参数

model string

视频生成模型名称

支持的模型:

  • grok-imagine-1.5-video-openveer - Grok 视频生成(兼容别名 grok-imagine-1.5-video-ext)

示例:"grok-imagine-1.5-video-openveer"

注意



为兼容旧版调用,别名 grok-imagine-1.5-video-ext(对应 grok-imagine-1.5-video-openveer)仍可正常使用。

prompt string

视频内容描述,支持中英文

size string

视频尺寸

可选值:

  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
  • 1:1 - 正方形
  • 3:2 - 横屏
  • 2:3 - 竖版
duration integer

视频时长(秒)

取值范围:6-15(最短 6 秒,最长 15 秒)

⚠️ 注意: 必须输入纯数字(如 6),不要加引号,否则会报错

resolution string

视频质量

可选值:

  • 480p - 标清(默认)
  • 720p - 高清
image_urls string[]

参考图像的 URL 列表

限制:

  • 最多 7 张图片
  • 必须是公网可访问的 URL
  • 不支持 base64 格式

提示

上传参考图之后,宽高比会自动匹配参考图的宽高比

响应

code integer

响应状态码

data object[]
响应数据数组
task_id string

任务唯一标识符

status string

任务状态

  * submitted - 已提交
注意

查询任务结果

视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

使用场景

场景 1:文生视频

{
  "model": "grok-imagine-1.5-video-openveer",
  "prompt": "一只狗在海滩上奔跑,阳光明媚,慢镜头",
  "size": "16:9",
  "duration": 6
}

场景 2:图生视频

{
  "model": "grok-imagine-1.5-video-openveer",
  "prompt": "让画面动起来,添加自然的动态效果",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "resolution": "720p"
}