Skip to main content
POST
Playground
填入你的 API Key 和提示词,然后发送。这里打的是线上接口,和你代码里调的是同一个, 也是够到视频模型的唯一方式。
从这个页面发出的请求是真实的,会计入你的 Key。 视频按秒计价:一秒的 480p 约 $0.05 到 $0.08,而十五秒的 1080p 要几美元。 先从短的试。

参数

string
必填
用哪个模型。接受 grok-imagine-videogrok-imagine-video-1.5,精确匹配。 只有 grok-imagine-video 能编辑和延长现成片段, 只有 grok-imagine-video-1.5 能到 1080p 和用预设音色。
object
必填
生成参数。下面没列出的键一律以 invalid_params 拒绝。
string
任务结束后把结果 POST 到这个地址,省掉轮询。 视频要 20 到 50 秒,回调值得接一下。

会返回什么

提交立刻返回,一秒都用不到。片子不在这个响应里——生成是在后台进行的。

然后轮询取结果

这个 Playground 只覆盖创建调用。拿上面响应里的 id 去读任务, 直到 status 变成 completedfailed——按长度和分辨率不同,20 到 50 秒。
完成的任务带一个 outputs 数组,里面是一个 MP4:
文件以 video/mp4 交付,可以内联播放。时长比你要的多约 0.04 秒。
产物 URL 不鉴权,并且在任务完成 24 小时后失效。 usage.cost_in_usd_ticks原价,实际扣费是它乘以你所在分组的倍率—— 见计价

下一步

概览

三种模式、时长与分辨率档位、参考图、音色与计价。

异步任务 API

轮询闭环、回调,以及完整错误表。