Skip to main content
POST
https://www.geeknow.top
/
v1
/
videos
curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=grok-video-3" \
  -F "prompt=猫咪听歌摇头晃脑，下大雨" \
  -F "aspect_ratio=2:3" \
  -F "seconds=6" \
  -F "size=720P" \
  -F "input_reference=@reference.png"

{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "720P"
}

​
Grok 视频生成

Grok 视频生成接口使用 multipart/form-data 提交，请按这里的字段组织请求。
  • 接口路径是 POST /v1/videos。
  • input_reference 是参考图字段，支持重复上传多张图片文件（二进制）。
  • grok-video-3-pro 会自动固定为 10 秒，grok-video-3-max 会自动固定为 15 秒。
  • 基础版 grok-video-3 没有额外固定秒数逻辑，按实际传参处理。

​
当前可用模型

  • grok-video-3
  • grok-video-3-pro
  • grok-video-3-max

​
方法与路径

POST /v1/videos

curl -X POST https://www.geeknow.top/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=grok-video-3" \
  -F "prompt=猫咪听歌摇头晃脑，下大雨" \
  -F "aspect_ratio=2:3" \
  -F "seconds=6" \
  -F "size=720P" \
  -F "input_reference=@reference.png"

​
响应示例

{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "720P"
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
required
模型名称。当前 Grok 系列可用值为 grok-video-3、grok-video-3-pro、grok-video-3-max。
​
prompt
string
required
提示词。
​
aspect_ratio
string
尺寸比例。当前常见值为 2:3、3:2、1:1。
​
seconds
integer
目标秒数。对 grok-video-3-pro 和 grok-video-3-max，会自动纠正为固定值。
​
size
string
分辨率档位，常用值是 720P 或 1080P。
​
input_reference
file
参考图文件（二进制）。可重复传递多次，对应多张参考图。

​
Response

​
id
string
任务 ID。
​
object
string
固定为 video。
​
model
string
实际提交的模型名。
​
status
string
任务状态，常见值有 queued、processing、completed、failed、cancelled。
​
progress
integer
进度百分比。
​
created_at
integer
创建时间戳。
​
size
string
输出清晰度档位。

​
使用场景

​
文生视频

只传 model、prompt、seconds、size 这组字段即可。

​
图生视频

在文生视频的基础上追加一个或多个 input_reference 文件。

​
固定时长模型

如果你传的是 grok-video-3-pro 或 grok-video-3-max，应预期服务端按固定秒数处理。

​
相关接口