1. 视频生成（Videos）
AI接口文档
  • 图片生成（Images）
    • 香蕉（异步）
      POST
    • image2（同步）
      POST
    • gpt-image-2（异步）
      POST
    • 任务查询
      GET
  • 视频生成（Videos）
    • Omni创建
      POST
    • veo创建
      POST
    • Grok创建
      POST
    • Seedance创建
      POST
    • MiniMax创建
      POST
    • 任务查询
      GET
  • 失效接口
    • sora创建
      POST
    • veo（直出15s）
      POST
    • Veo （延长至15s）
      POST
  1. 视频生成（Videos）

Grok创建

开发中
POST
/v1/videos

Grok 视频生成接口文档#

接口地址#

POST /v1/videos

功能说明#

支持 Grok Imagine Video 1.5 系列模型的文生视频、首帧/首尾帧视频和多参考内容视频生成。

当前可用模型与能力#

模型名文生视频首帧/首尾帧多参考图时长说明
grok-imagine-video-1.5支持支持首帧和首尾帧最多 7 张图片4～15 秒
grok-imagine-video-1.5-fast支持支持首帧，最长 15 秒支持；多图模式最长 10 秒4～15 秒，受模式限制
grok-imagine-video-1.5-lite支持支持首帧，最长 15 秒不支持多图4～15 秒，受模式限制
fast 和 lite 的首帧模式只传 1 张图片并设置 first_last_frame: true。标准版传 2 张图片时可作为首尾帧。Lite 不支持多图输入。

模式判定#

模式传参方式
文生视频不传 images，也可传空数组 []
首帧images 传 1 张图片，并传 first_last_frame: true
首尾帧仅标准版支持；images 依次传首帧、尾帧，并传 first_last_frame: true
参考模式传入参考素材，且不传 first_last_frame 或传 false
first_last_frame 只决定图片是首/尾帧还是普通参考图：
true：首帧或首尾帧模式；第 1 张图是首帧，第 2 张图是尾帧。
false 或不传：参考模式；图片按传入顺序作为参考内容。

请求方式#

支持以下两种方式，任选其一：
方式Content-Type参考素材字段
JSONapplication/json图片使用 images
表单multipart/form-data本地图片或图片 URL 使用可重复的 input_reference 字段
Grok 接口只接收图片参考内容。不要把 Markdown 链接（例如 [图片](https://...)）原样写入数组，只填写实际的 https://... 图片直链。

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring是application/json 或 multipart/form-data，须与请求体一致

JSON 请求体说明#

参数名类型必填说明
modelstring是Grok 模型名称，见上方模型表
promptstring是视频生成提示词
imagesstring[]否图片 URL 或完整 Base64 data URI；文生视频不传或传 []
aspect_ratiostring否视频宽高比，例如 16:9、9:16、21:9
resolutionstring否输出分辨率，例如 720p；可用值以模型服务端配置为准
secondsstring是输出时长，字符串形式，如 "9"；范围 4～15
first_last_frameboolean否true 表示首帧/首尾帧模式；不传或 false 表示参考模式

参考素材格式#

{
  "images": [
    "https://example.com/ref.png"
  ]
}
所有 URL 必须是无需登录、可由服务器直接下载文件内容的公网直链。

表单字段说明#

参数名类型必填说明
modelstring是Grok 模型名称
promptstring是视频生成提示词
input_reference可重复字段否本地图片、图片公网直链或图片 Base64；每张图片重复传一次
aspect_ratiostring否视频宽高比
resolutionstring否输出分辨率，可用值以服务端配置为准
secondsstring是输出时长，范围 4～15
first_last_frameboolean/string否true 为首帧/首尾帧模式；不传或 false 为参考模式

input_reference 的传法#

方式示例
本地文件-F "input_reference=@/path/to/ref.jpg"
公网 URL-F "input_reference=https://example.com/ref.jpg"
图片 Base64-F "input_reference=data:image/jpeg;base64,/9j/..."

请求示例#

文生视频（JSON）#

标准版首尾帧（JSON）#

标准版多参考图（JSON，最多 7 张）#

Fast 首帧视频（JSON，最长 15 秒）#

Fast 多图参考（JSON，最长 10 秒）#

Lite 首帧视频（JSON，最长 15 秒）#

本地图片（表单）#

响应参数#

完成态视频地址位于顶层 url 和 video_url，两者值相同。
参数名类型说明
idstring任务 ID
objectstring固定值 video
modelstring实际使用的模型名称
statusstringqueued、in_progress、completed 或 failed
progressnumber任务进度，0～100
created_atnumber创建时间戳（秒）
completed_atnumber完成时间戳（秒，仅完成态）
urlstring生成视频直链（仅完成态）
video_urlstring与 url 同值（仅完成态）
errorobject失败信息，通常包含 code、message

提交成功#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1791320000
}

任务完成#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "completed",
  "progress": 100,
  "created_at": 1791320000,
  "completed_at": 1791320060,
  "url": "https://example.com/output.mp4",
  "video_url": "https://example.com/output.mp4"
}

任务失败#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video-1.5",
  "status": "failed",
  "progress": 0,
  "created_at": 1791320000,
  "error": {
    "code": "invalid_request",
    "message": "请求参数不符合模型能力限制"
  }
}

查询任务状态#

GET /v1/videos/{task_id}
queued / in_progress 时继续轮询；completed 时读取顶层 url 或 video_url；failed 时读取 error.message。

注意事项#

1.
seconds 必须使用字符串，支持 "4"～"15"。
2.
标准版参考图最多 7 张；首尾帧模式最多传 2 张图片。
3.
fast 多图参考模式最长 10 秒；首帧模式可到 15 秒。
4.
lite 仅支持文生视频或单张首帧图生视频，不支持多图输入和尾帧模式。
5.
首帧/首尾帧必须显式传 first_last_frame: true；不传或传 false 会按普通参考模式处理。
6.
Grok 参考内容只支持图片：JSON 使用 images，表单使用可重复的 input_reference。
7.
JSON 与表单二选一。JSON 不能直接携带本地文件；本地文件请使用 multipart/form-data。
8.
接口为异步接口，提交成功不代表视频已经生成完成。

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "model": "grok-imagine-video-1.5",
    "prompt": "帮我做个广告",
    "images": [
      "https://example.com/first.webp",
      "https://example.com/last.webp"
    ],
    "aspect_ratio": "21:9",
    "resolution": "720p",
    "seconds": "9",
    "first_last_frame": true
  }

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "grok-imagine-video-1.5",
    "prompt": "帮我做个广告",
    "images": [
      "https://example.com/first.webp",
      "https://example.com/last.webp"
    ],
    "aspect_ratio": "21:9",
    "resolution": "720p",
    "seconds": "9",
    "first_last_frame": true
  }'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "size": "1920x1080"
}
修改于 2026-10-07 13:35:27
上一页
veo创建
下一页
Seedance创建
Built with