文档 · 模型

视频生成

2026-09-18

grok-imagine-video-1.5：提交、轮询、按分辨率的每秒价格、失败退款，以及供应商已不认识的任务怎样在 24 小时后退款。

grok-imagine-video-1.5 是 xAI 的文生视频、图生视频模型，是目录里唯一的视频模型，按视频秒数计费，不同分辨率单价不同。

线路与端点

它只在 Grok 官方线路上出售，在 API 密钥 页面上显示为 Grok，线路名 官方线路（路由 id 是 grok-official）。用 自动路由 密钥，请求同样会送到这里。所有调用都用 Authorization: Bearer <key> 鉴权。

POST /v1/videos/generations 提交任务。
GET /v1/videos/{request_id} 查询任务状态。
GET /v1/videos/{request_id}/content 下载做好的视频。

两个 GET 端点不经过线路分发，直接找当初受理任务的通道，所以同一账号下任何一把有效密钥都能查，不必是 grok-official 线路的密钥。

提交任务

curl https://ai.topxea.com/v1/videos/generations \
  -H "content-type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"A paper boat drifting down a rain gutter","duration":8,"resolution":"720p"}'

duration 取 1 到 15 秒，默认 8 秒。resolution 取 480p、720p 或 1080p，默认 480p。model、duration、resolution 三个字段决定价格，所以每个只能出现一次，键名区分大小写；校验后的值会写进发给供应商的请求体。其余字段（比如图生视频用的 image、reference_images，还有 generate_audio、aspect_ratio）照你发的原样转发，字段格式以 xAI 的请求文档为准。

校验不过会收到 400，错误信息原文如下：

duration must be between 1 and 15 seconds
resolution must be one of 480p, 720p or 1080p
field "Duration" is not accepted; use "duration"
field "duration" must be provided once

返回里有供应商给的 request_id 和模型名。请把这个 id 存好，后面两个 GET 端点都靠它，也只有创建任务的账号能用它。查一个不存在或者别人账号下的 id，会收到 404，提示「video job not found」。

价格

按请求的秒数计：

480p 每秒 0.05 美元
720p 每秒 0.10 美元
1080p 每秒 0.20 美元

上面那条 8 秒的请求要付 8 x 0.10 = 0.80 美元。首页价目表里还列着 xAI 公布的每秒 0.08 美元，那一行叫 官方原价，每档旁边标着差价百分比，供对比。

供应商一受理任务，全部费用（请求秒数乘以每秒单价）就会扣掉。任务受理后，不管你的客户端还连不连着，供应商都会计费，所以提交后马上断开，这笔钱也不会退。这笔扣费在 用量日志 页能查到，记录里写着分辨率和秒数。

轮询与退款

轮询 GET /v1/videos/{request_id}。状态文档按供应商发来的原样返回。pending、queued、processing、running、in_progress 表示还在做，继续等；done、failed、expired 是终态。done 的文档里若带 video.url 和 video.duration，中转服务会读取这两个字段。

第一次查到终态的轮询会结算，之后的轮询不再重复结算：

failed 或 expired：全额退款。
done 但 video.duration 少于请求：没交付的整秒按同样的单价退回；不足一秒按一秒算，文档里没有 video.duration 就按足秒交付处理，不退。退款金额不会超过实际扣掉的费用。

退款在 用量日志 页是一条类型为退款的记录，页顶 账单退款 一栏是这些退款的合计。

如果你不再轮询，后台会有一个对账程序替你查：提交十分钟后开始，两次检查至少间隔五分钟。供应商已经不认识这个任务（返回 404），任务又已超过 24 小时，对账程序就按过期处理并退款。你自己轮询时碰到供应商的 404，只会收到一个统一格式的错误，不会当场退款；这种情况等对账程序处理，不用反复重试。

轮询请求和其他请求一样计入请求频率限制（限制开着的时候），不加间隔地连续轮询会收到 429 rate_limited。每次轮询之间留出间隔。

下载视频

做好的视频如果是以 /v1/videos 下的路径给出的，就带上密钥请求 GET /v1/videos/{request_id}/content。中转服务从跑这个任务的通道取回文件，再转发给你，Range 头原样透传，供应商返回 206 时 Content-Range 和 Accept-Ranges 也一并带回。响应带 Content-Disposition: inline; filename="<request_id>.mp4" 和 Cache-Control: private, max-age=600。单个文件上限 512 MB，超过会收到 502，提示「The video file is larger than this relay serves」。除非供应商另有说明，文件按 video/mp4 返回。受理任务的通道已停用时，两个 GET 端点都返回 503，提示「The channel that created this video job is unavailable」。

模型：grok-imagine-video-1.5 · 模型与价格

视频生成

线路与端点

提交任务

价格

轮询与退款

下载视频

相关