xAI 出品的高质量视频生成模型,动作自然流畅。走 apimodels.app 的统一视频端点:一次 POST 创建任务,再轮询同一个端点取结果,和 VEO、Kling、Seedance 的调用方式完全一样,换模型只改 model 字段。两个公开模型名:grok-video-3 按秒计价,480p / 720p $0.04/秒、1080p $0.12/秒,可出 6 / 10 / 15 秒;grok-video-3-10s 按条一口价,720p $0.30 / $0.50 / $0.70、1080p $0.35 / $0.65 / $2.00 对应 6 / 10 / 15 秒。两者都支持图生视频。
| 模型 | model | 时长 | 价格 | 说明 |
|---|---|---|---|---|
| Grok Video 3 | grok-video-3 | 6 / 10 / 15 秒 | $0.24-$0.60 | 图生视频,$0.04/秒(1080p $0.12/秒) |
| Grok Video 3(10 秒) | grok-video-3-10s | 6 / 10 / 15 秒 | $0.30-$2.00 | 图生视频,按条一口价:720p $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00 |
两个名字对应同一个模型,区别只在计价方式:grok-video-3 按秒计价(480p / 720p $0.04/秒,1080p $0.12/秒),grok-video-3-10s 按 分辨率 × 时长 六档一口价(默认 10 秒)。两者都能出 1080p,出片质量一致,按哪个便宜选就行:**要 1080p 的 6 秒或 10 秒,用 grok-video-3-10s**($0.35 / $0.65,按秒版是 $0.72 / $1.20);**要 1080p 的 15 秒,用 grok-video-3**($1.80,一口价版是 $2.00)。480p 只有 grok-video-3 有,720p 也是按秒版更便宜。
POST /api/v1/video/generations —— 异步:创建后轮询同一个端点取结果。
# Step 1: Create task
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-video-3",
"prompt": "A cat playing piano in a jazz club, cinematic lighting",
"aspect_ratio": "16:9"
}'
# Step 2: Poll status
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | grok-video-3 / grok-video-3-10s |
| prompt | 是 | string | 视频内容描述文本 |
| aspect_ratio | 否 | string | "16:9"(默认)、"1:1"、"9:16"、"2:3"、"3:2" |
| duration | 否 | number | 6、10、15(grok-video-3 默认 6,grok-video-3-10s 默认 10) |
| size | 否 | string | grok-video-3:"480P"、"720P"(默认);grok-video-3-10s:"720P"(默认)、"1080P" |
| images | 否 | string[] | 参考图 URL 数组,最多 7 张 —— 传了就是图生视频。也接受 image_urls / image 两种写法。 |
| callback_url | 否 | string | 任务完成后的回调 URL |
创建接口立即返回 data.taskId,视频在后台生成。带上这个 task_id 向同一个端点发 GET,读 data.state:pending 表示还在跑,completed 时 data.resultUrls[0] 就是视频地址,failed 时 data.failMsg 是原因。不想轮询就传 callback_url,任务结束后我们主动 POST 通知你。
有。在 apimodels.app 向 /api/v1/video/generations 发 POST,传 model "grok-video-3"(或 "grok-video-3-10s")、prompt,以及可选的 aspect_ratio,然后拿返回的 task_id 轮询同一个端点,直到 data.state 变成 "completed",data.resultUrls[0] 就是视频地址。这套请求格式和站内的 VEO、Kling、Seedance 完全一致,换模型只改 model 一个字段,一把 key 全都能调。
grok-video-3 按秒计价 $0.04/秒:6 秒 $0.24、10 秒 $0.40、15 秒 $0.60。另一个模型名 grok-video-3-10s 按条一口价:720p 6 / 10 / 15 秒 $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00。失败不扣费,只有成功才计费。
同一个模型,区别只在计价方式。grok-video-3 可出 6 / 10 / 15 秒,按秒计 $0.04/秒(合 $0.24-$0.60);grok-video-3-10s 按 分辨率 × 时长 六档按条一口价:720p 6 / 10 / 15 秒 $0.30 / $0.50 / $0.70,1080p $0.35 / $0.65 / $2.00(默认 10 秒),批量生成时成本能提前算清,而且两者之中只有它能出真 1080p。720p 10 秒这一档 grok-video-3 合 $0.40、grok-video-3-10s 是 $0.50;要固定单价或 1080p 选 grok-video-3-10s,要 480p 或按秒计价选 grok-video-3。
支持。grok-video-3 和 grok-video-3-10s 都既能纯文生视频,也能图生视频,走的是同一个 /api/v1/video/generations 端点。想先看效果,可以直接在模型页 apimodels.app/models/grok-video-3 和 /models/grok-video-3-10s 上传图跑一次。
aspect_ratio 支持 "16:9"(默认)、"1:1"、"9:16"、"2:3"、"3:2",横屏、竖屏、方图一个端点全覆盖,做社媒素材不用换模型。10 秒的片子一般约 60 秒出结果,更短的约 30 秒,建议 5-10 秒轮询一次;不想轮询就传 callback_url,任务结束我们主动 POST 通知。
结果视频保留 7 天后自动删除,需要长期保存请及时下载或转存。data.state 变成 "completed" 后,视频地址在 data.resultUrls[0];任务失败时 data.failMsg 是原因,且不扣费。