当前接入说明
本站模型列表中可见 grok-imagine-video 和 grok-imagine-video-1.5-preview。本目录暂未提供可直接用于本站的 Grok 视频创建、查询和下载示例；接入前，请联系本站支持确认你所用模型的完整调用方式。
旧文档中的 /v1/video/create、/v1/video/query、/v1/video/extend 不能作为当前本站的 Grok 调用入口。xAI 官方的 /v1/videos/generations 也不能直接替换为本站域名使用。下方官方参考用于了解模型和填写参数，不代表本站已经开放对应原生接口。
如果你的应用已有可用的 Grok 视频请求，请继续按该入口的约定处理响应；不要仅凭同名模型把它改成另一种视频格式。
功能与模型选择
xAI 视频模型可以从文字或图片生成短视频，也提供参考图引导、视频编辑和续写。具体动作受模型、素材和输出规格限制。
| 官方型号 | 功能与规格 | 本站使用提示 |
|---|---|---|
grok-imagine-video | 经典视频模型；编辑和续写官方示例使用此型号；不能使用 1.5 的尾帧固定功能。 | 模型列表可见不等于已确认本目录的视频任务协议。 |
grok-imagine-video-1.5 | 文生、图生支持 1080p；参考生最高 720p，最长 15 秒；支持固定首尾帧及预设声音参考。 | 本站公开列表使用 1.5-preview 名称，接入方式请先确认。 |
grok-imagine-video-1.5-preview 是 xAI 公布的 1.5 别名；本站实际接受的名称仍以你的账号模型列表及对应调用说明为准。不能将旧名 grok-video-3 当成这些型号的通用别名。
公开目录核对（2026-10-02）：pricing 快照匹配到以下型号。它不是完整模型清单，也不替代当前 Key 的 GET /v1/models；模型可见性、视频动作和参数组合仍需按本文说明。| 公开模型 ID | 目录协议提示 | 公开分组 |
|---|---|---|
grok-imagine-video | openai、openai-response | Grok官转 |
grok-imagine-video-1.5-preview | openai、openai-response | Grok官转 |
第一步：设置本站鉴权
本站 API 基础地址为 https://top.qingyuntop.ai。将 YOUR_API_KEY 替换为你的青云TOP API Key，保留 Bearer 后的一个空格。
Authorization: Bearer YOUR_API_KEY本站 Key 只发送给本站接口，不发送到 xAI 官方域名或结果文件所在的第三方域名。
第二步：查看账号可见模型
GET https://top.qingyuntop.ai/v1/models
无需请求体。响应中的 data[].id 是账号可见的模型 ID。能查到一个模型，只说明当前账号可以看到它，不能代替该模型的创建和结果格式说明。
以下 cURL 使用 Bash 写法；Python 需安装 requests；Node.js 使用 20 或更新版本，保存为 .mjs 后运行。
curl --fail-with-body --connect-timeout 30 --max-time 120 "https://top.qingyuntop.ai/v1/models" \
-H "Authorization: Bearer YOUR_API_KEY"选择正确的调用文档
- 文生、图生及参考生视频参数：了解官方动作、字段位置与合法组合。
- 视频编辑与续写：区分修改现有画面与延长视频。
- 任务状态与结果：了解官方
request_id、终态和临时下载链接。 - 旧接口迁移与常见问题：处理旧路径、模型名称和格式混用。
如需立即接入视频功能，也可从模型调用 API 参考选择已有完整创建、查询和下载教程的模型。不同模型的任务 ID、参数和返回结构不能混用。
接入时需要确认的内容
请向本站支持说明所需动作（文生、图生、编辑或续写）、模型 ID 和目标输出规格，并确认提交路径、JSON 或表单格式、返回字段、查询方式和下载方式。无需提供完整 API Key；排查已有请求时提供请求时间、脱敏错误及任务 ID 即可。