Skip to main content
POST
https://www.geeknow.top
/
v1
/
videos
Grok 视频生成
curl --request POST \
  --url https://www.geeknow.top/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "seconds": 123,
  "size": "<string>"
}
'
{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "size": "720P"
}

Documentation Index

Fetch the complete documentation index at: https://docs.geeknow.top/llms.txt

Use this file to discover all available pages before exploring further.

​
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
参考图文件。可重复传多次，对应多张 input_reference 上传。

​
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，应预期服务端按固定秒数处理。

​
相关接口