Grok 视频接口

视频接口说明

生图、编辑与视频

本站提供 Grok / xAI 通用图片与视频接口，支持文生图、JSON 图片编辑、文生视频和参考图生视频，可供 sub2api 等兼容下游调用。API 地址为 https://y.junlistudio.com/v1，使用本站 API Key，通过 Authorization: Bearer YOUR_API_KEY 鉴权。

请求使用 application/json；图片请求体上限 100 MiB，视频请求体上限 50 MiB。参考图支持 PNG、JPEG、WebP，每张最多 25 MiB，张数还受模型限制。模型、时长、比例和分辨率以本站模型目录为准。

POST/v1/videos/generationsGrok / xAI 风格的视频生成，返回 request_id

GET/v1/videos/{request_id}查询生成状态与结果地址

GET/v1/videos/{request_id}/content携带 API Key 下载 MP4

视频生成、查询与下载

参数	类型	必填	说明
`model`	`string`	是	本站已启用的视频模型 ID；兼容名称 grok-imagine-video 调用本站 grok-video 模型。
`prompt`	`string`	文生视频必填	描述视频内容、动作和镜头；提供参考图时可省略。
`duration`	`integer / string`	否	1–15 的整数秒数，默认 8 秒，也接受 seconds 别名；实际可用值以模型目录为准。
`aspect_ratio`	`string`	否	画面比例，默认 16:9；需使用模型支持的比例。
`resolution`	`string`	否	分辨率，默认 480p；实际可用档位以模型目录为准。
`image.url`	`string`	否	图生视频首帧，支持公网 HTTP(S) URL、data:image/...;base64,... 或纯 Base64。
`reference_images[].url`	`string`	否	多张参考图，格式与 image.url 相同；数量和能力受模型限制。
`size`	`string`	否	兼容 WIDTHxHEIGHT，补充未显式指定的比例和分辨率。

Grok 兼容 · 创建视频任务POST /v1/videos/generations

curl 'https://y.junlistudio.com/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "grok-imagine-video-1.5",
  "prompt": "海浪轻拍沙滩，镜头缓慢推进，电影质感",
  "duration": 1,
  "aspect_ratio": "1:1",
  "resolution": "480p"
}'

提交成功返回 {"request_id":"任务ID"}，随后查询同一任务，直至 done、failed 或 expired。仅通过 /v1/videos/generations 创建的任务使用这套状态格式。

参数	类型	必填	说明
`request_id`	`string`	—	提交成功返回的任务 ID，用于查询和下载。
`status`	`string`	—	pending=生成中；done=完成；failed=失败；expired=临时结果已过期。
`progress`	`integer`	—	本站任务阶段进度，完成时为 100。
`video.url`	`string`	—	完成后返回可直接下载的 MP4 地址，含临时下载凭证，有效期 24 小时；不要删除查询参数。
`url / download_url`	`string`	—	完成时返回本站 /content 地址；下载时必须携带生成该任务的 API Key。
`video.duration`	`integer`	—	完成视频的时长，单位为秒。
`error.message`	`string`	—	生成失败时的错误说明。

完成结果包含 "status":"done","video":{"url":"...","duration":6,"respect_moderation":true}。可直接下载 video.url；也可像 sub2api 一样通过携带 API Key 的 /content 路径下载。

Grok 兼容 · 查询与下载GET /v1/videos/{request_id} · GET /content

# 将 REQUEST_ID 替换为提交响应中的 request_id
curl 'https://y.junlistudio.com/v1/videos/REQUEST_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

# 查询结果为 status: "done" 后下载
curl 'https://y.junlistudio.com/v1/videos/REQUEST_ID/content' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -o output.mp4

sub2api 接入：选择 Grok / xAI 的 API Key 账号，填写本站地址与密钥，配置本站已启用的图片、视频模型及模型映射；确保最终路径与本文给出的路径一致。旧版 Responses 连通性探测不生成媒体；sub2api 的图片/视频测试会实际生成并计费。

当前兼容上述媒体接口；批量生图、图片流式输出、mask、Files API、视频编辑/续接、自定义存储和音频参考尚未支持。

Grok 图片生成与编辑 →