# Grok 视频接口

<a id="grok-video"></a>

## 视频接口说明

生图、编辑与视频

本站提供 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/generations`Grok / xAI 风格的视频生成，返回 request\_id

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

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

<a id="视频生成-查询与下载"></a>

### 视频生成、查询与下载

 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
 `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`

```bash
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`

```bash
# 将 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 图片生成与编辑 →](https://y.junlistudio.com/docs.md?page=grok)