旧调用方式如何处理
旧文档中的三条路径目前不能作为本站 Grok 视频入口使用。本目录保留原文章链接，具体接入状态见接入与模型说明。
| 旧写法 | 应如何处理 |
|---|---|
POST /v1/video/create | 停止照搬旧示例；先确认 Grok 的真实提交路径及格式。 |
GET /v1/video/query | 不再使用旧查询模板；任务必须通过创建服务配套的查询接口读取。 |
POST /v1/video/extend | 不沿用旧 task_id、start_time、upscale 续写格式。 |
model: sora-2 | 这是其他系列模型，不是 Grok 视频型号。 |
model: grok-video-3 | 不能据此推导为 grok-imagine-video 的别名。 |
| Veo 的多阶段状态常量 | 不用于解析 xAI 视频状态；参见状态与结果参考。 |
三种格式不能互换
xAI 官方原生视频创建使用 /v1/videos/generations，查询使用创建返回的 request_id。本站统一视频接口 /v1/videos 与 Responses /v1/responses 是另外的协议；路径存在或模型名称可见，并不代表它们已支持 Grok 视频的全部输入和结果处理。
本站 Grok 原生创建、编辑和续写不能只把 api.x.ai 改成 top.qingyuntop.ai。第三方兼容服务即便使用同名模型，也可能采用聊天消息、不同参数或不同结果格式，请按该入口的说明接入。
为什么模型列表中有它，却没有生成示例
模型列表帮助你确认账号可见名称。一次完整视频集成还需要明确提交格式、模型动作、结果结构、任务查询和下载方式。缺少这些信息时，用其他模型的代码替换 model 容易造成参数被忽略或结果无法读取。
可先按照查看账号可见模型检查名称，再向本站支持确认所需动作对应的完整调用说明。
遇到错误时如何排查
| 现象 | 排查步骤 |
|---|---|
404 或 Invalid URL | 检查方法和路径，确认采用的是本站已提供的对应模型入口；反复更换 Key 无法修复不存在的路径。 |
| 401 | 检查本站 Key 是否有效、Bearer 后有无空格、是否发送到本站；鉴权通过仍需确认协议。 |
| 模型不可见或无权限 | 检查账号模型列表、Key 的模型限制及分组；保留脱敏错误联系支持。 |
| HTTP 200 但没有 MP4 | 先检查响应类型及正文状态；创建响应和任务失败响应都可能不是视频文件。 |
| 客户端等待超时 | 已取得任务 ID 时先恢复该服务的查询流程，勿直接重交造成重复任务。 |
| 结果 URL 下载失败 | 检查链接是否过期、HTTP 状态与内容类型，并保留任务 ID 联系支持。 |